AI Agent 整合指南
本頁同時提供給人類和AI Agent閱讀。
人類只需把這個頁面的網址貼給 Agent，Agent 會引導你完成所有設定。
快速開始（2 步驟）
最懶人的方式
把下面這個網址貼給你的 AI Agent（Claude Code、Cursor 等），說「幫我依照這個指南完成設定」，Agent 會自己讀完並引導你完成所有步驟。
如果你想自己操作，只需要兩步驟：
1 取得 API Token
登入後前往 個人資料，切換到「AI Token」分頁，輸入名稱後點「產生」，複製顯示的 Token（僅顯示一次）。
2 設定 .mcp.json
在你的專案根目錄新增 .mcp.json，貼入以下內容並換上你的 Token：
{
"mcpServers": {
"nt-travel": {
"type": "http",
"url": "https://nt-travel.nerdtechnic.com/api/mcp",
"headers": {
"Authorization": "Bearer 貼上你的Token"
}
}
}
}
範例對話（你可以說什麼）
設定完成後，直接用中文告訴 Agent 你想做什麼。
建立完整行程
create_trip 建立行程框架，再逐天填入活動。已建立「東京美食購物 5 日遊」，行程 ID: 42。正在安排第 1 天……修改行程
update_activity 把第 3 天下午改為「台場 Diver City」，並新增「teamLab Planets」在 15:00，建議提前在官網訂票。開啟討論
create_discussion 建立「出發前準備清單」，整理了護照、JR Pass、ICOCA 卡、網路卡、轉接頭等 12 項清單。常見問題
.mcp.json 填入 URL 和 Token 即可。
.mcp.json 即可。
POST /api/agent/login 取得 Token，用 Bearer Header 呼叫 REST API。
Agent 設定說明
給正在閱讀本頁的 AI Agent
你正在讀這份指南是因為用戶希望將旅途同行平台接入你的工具集。請依序完成以下步驟：
- 詢問用戶是否已有旅途同行帳號。若無，引導至
https://nt-travel.nerdtechnic.com/member/register免費註冊。 - 引導用戶前往
https://nt-travel.nerdtechnic.com/member/profile，切換到「AI Token」分頁，點擊「產生」，輸入任意名稱（例如claude-agent），複製顯示的 Token（只會顯示一次）。 - 在用戶專案根目錄建立或更新
.mcp.json，使用以下格式（用戶提供的 Token 填入Bearer後方）：
{
"mcpServers": {
"nt-travel": {
"type": "http",
"url": "https://nt-travel.nerdtechnic.com/api/mcp",
"headers": {
"Authorization": "Bearer <用戶的Token>"
}
}
}
}
- 請用戶重新啟動 Claude Code（或重新載入 MCP 設定）。
- 使用
whoami工具確認認證成功。 - 詢問用戶想做什麼，並依需求呼叫對應工具。
MCP Endpoint
- URL:
https://nt-travel.nerdtechnic.com/api/mcp - Method:
POST（JSON-RPC 2.0） - Auth:
Authorization: Bearer <token> - Protocol: MCP Streamable HTTP（2024-11-05）
工具一覽（13 個）
認證
確認 Token 是否有效，回傳目前登入的帳號資訊。
行程管理
列出我所有行程（ID、標題、目的地、日期、狀態）。
建立新行程，自動產生每日架構。必填：title, destination, start_date, end_date。
取得完整行程資料，含所有天數與活動。必填：trip_id。
修改行程的標題、目的地、日期、預算、標籤或公開設定。必填：trip_id。
列出所有天數及當天活動，用於了解行程結構。必填：trip_id。
活動管理
在指定天數加入活動。必填：trip_id, day_number, name, activity_type。
修改活動任何欄位。必填：trip_id, activity_id。
刪除活動（軟刪除）。必填：trip_id, activity_id。
討論
列出行程中所有討論串。必填：trip_id。
開啟新討論串。必填：trip_id, title, content。
取得討論串與所有回覆。必填：trip_id, discussion_id。
在討論串發表回覆。必填：trip_id, discussion_id, content。