將 NexRex 連接到你的 AI

把 NexRex 連接到你平常用的 AI 應用程式，就能直接問它你的跑步紀錄、課表和恢復狀況。連接時只要登入 NexRex 帳號，不必複製任何金鑰或權杖。 NexRex 透過 MCP（Model Context Protocol）連接，這是 AI 應用程式串接外部服務的共通標準。每一種應用程式都使用同一個網址：

https://mcp.nexrex.ai/mcp

你也可以在網頁版 設定 → 整合服務 的 將 NexRex 連接到你的 AI 卡片上複製這個網址。

這一頁說明如何把你自己的帳號連接到 AI 應用程式。若要用組織金鑰建置整合服務，請看 Developer API。

AI 能幫你做什麼

連接後，你的 AI 應用程式可以：

讀取你的個人資料、活動、課表、營養紀錄、恢復資料和比賽成績預測
讀取你指導的運動員和群組（如果你是教練）
分析單一運動員或整個群組的表現
草擬訓練計畫，並提出課表調整建議
從 NexRex 計畫目錄推薦計畫，並幫運動員報名
把群組計畫指派給你指導的群組

AI 只看得到你的 NexRex 帳號本來就能看的資料。教練連接時，也會遵守每位運動員的分享設定。NexRex 傳給 AI 應用程式的內容，之後由該應用程式依它自己的條款處理；NexRex 如何處理你的資料，請看隱私權政策。

儲存計畫、套用變更、幫運動員報名和指派群組計畫，都會改動真實的行事曆。請明確下指示，並在核准前看清楚 AI 應用程式顯示的內容。詳見下方「AI 動手前會問你什麼」。

AI 動手前會問你什麼

NexRex 和你的 AI 應用程式會在三個時間點跟你確認。

讀取與寫入權限

第一次連接時，NexRex 通常只給 AI 讀取權限：它可以查看你的訓練，但不能草擬計畫或提出調整建議。等它第一次需要這麼做時，AI 應用程式會帶你回到 NexRex 核准寫入權限，選 允許存取 就能繼續。有些應用程式會在連接時一次要求兩種權限。

修改行事曆和計畫之前

下表「覆寫或排程」標示為「是」的工具，會覆寫草稿或改動行事曆，核准前請看清楚。AI 應用程式執行工具前，會先讓你看到請求內容：

Claude 會請你核准這次工具呼叫，你可以只允許這一次，或之後都允許這個工具。
ChatGPT 會在 NexRex 做出變更前請你確認。
Claude Code、Codex 和 VS Code 會在執行工具前請你允許，除非你已在它們的設定中允許這個工具。

如果你把應用程式設成一律允許 NexRex 工具，它就不會再問你，所以請清楚說明你要改什麼。像「幫我處理待審的修改」這種模糊的要求，請先讓 AI 列出內容，再由你逐一核准。

Garmin 與運動員通知

AI 幫運動員報名計畫或指派團體計畫時，NexRex 也會把課表送到每位已連接 Garmin 的運動員手錶。教練幫運動員報名時，運動員會在 NexRex App 收到通知。

AI 可以使用的工具

工具	功能	權限	覆寫或排程
`get_current_user`	顯示目前連接的 NexRex 帳號	讀取	否
`get_athlete_profile`	讀取運動員的個人資料、體能和訓練區間	讀取	否
`get_account_summary`	讀取個人最佳成績、目標和比賽紀錄	讀取	否
`get_activities`	列出最近的活動	讀取	否
`get_training_plan`	讀取訓練計畫和各週內容	讀取	否
`get_week_workouts`	列出某一週的課表	讀取	否
`get_race_info`	讀取比賽資訊	讀取	否
`get_race_prediction`	預測比賽完賽時間	讀取	否
`get_group_info`	讀取群組和成員	讀取	否
`get_coach_athletes`	列出你指導的運動員	讀取	否
`get_team_overview`	整理團隊概況和需要關注的運動員	讀取	否
`get_coach_weekly_report`	讀取最新的教練週報	讀取	否
`find_athlete`	用名字找到你指導的運動員	讀取	否
`analyze_performance`	分析單一運動員或整個群組的表現	讀取	否
`get_training_status`	讀取訓練負荷和恢復狀況	讀取	否
`get_nutrition_log`	讀取營養紀錄	讀取	否
`create_training_plan`	草擬訓練計畫，不會儲存	寫入	否
`save_training_plan`	儲存草稿，也可以排進運動員的行事曆	寫入	是
`move_draft_workout`	在草稿裡移動一堂課	寫入	是
`rescale_draft_week`	調整草稿某一週的訓練量	寫入	是
`edit_draft_workout`	修改草稿裡的某一天	寫入	是
`add_draft_test_race`	在草稿裡加入測驗賽	寫入	是
`get_plan_draft`	逐週讀取計畫草稿	讀取	否
`propose_workout_adjustment`	提出單堂課調整，等待核准	寫入	否
`get_group_plan`	讀取群組計畫和課表	讀取	否
`propose_plan_revision`	提出計畫修改，等待核准	寫入	否
`list_plan_revisions`	列出待審的計畫修改	讀取	否
`approve_plan_revision`	把提出的修改套用到行事曆	寫入	是
`reject_plan_revision`	拒絕提出的修改	寫入	是
`recommend_training_plans`	為運動員排序目錄計畫	讀取	否
`enroll_training_plan`	讓運動員報名目錄計畫	寫入	是
`list_group_plans`	列出群組的計畫	讀取	否
`assign_group_plan`	指派群組計畫並讓成員報名	寫入	是

連接 ChatGPT

在 ChatGPT 的 Plugins 頁面加入 NexRex。ChatGPT 常調整選單名稱，下面的名稱以英文介面為準；如果你看到的不一樣，請參考 OpenAI 的自訂 MCP 伺服器說明。你的 ChatGPT 方案或工作區管理員可能會限制自訂 MCP 伺服器。

新增自訂 MCP 伺服器

開啟 chatgpt.com/plugins，選擇 +，再選 Add custom MCP server。

輸入 NexRex 網址

名稱填 NexRex，在 Connection 貼上 https://mcp.nexrex.ai/mcp。登入方式保留 ChatGPT 自動偵測到的 OAuth，不需要填 client ID 或 secret。

建立 plugin

看完 ChatGPT 的警告後，勾選 I understand and want to continue，再選 Create as a plugin。

登入 NexRex

安裝這個 plugin 後，ChatGPT 會在瀏覽器開啟 NexRex。登入後確認是哪個應用程式提出請求，再選允許存取。

開始問你的訓練

開一個新對話，輸入 @ 選擇 NexRex，然後問問看，例如「我這週跑得怎麼樣？」

連接 Claude

以下步驟適用 Claude 的 Free、Pro 和 Max 方案，Free 方案可以加一個自訂連接器。選單名稱以英文介面為準；如果你看到的不一樣，請參考 Anthropic 的自訂連接器說明。

新增自訂連接器

在 Claude 開啟 Customize，再選 Connectors。選擇 + Add，再選 Add custom connector。

輸入 NexRex 網址

名稱填 NexRex，貼上 https://mcp.nexrex.ai/mcp，再選 Continue。Claude 會自動偵測登入方式，保留 Sign in now 和 Use Claude’s published identity (Recommended)，然後選 Add。

登入 NexRex

Claude 會在瀏覽器開啟 NexRex。登入後確認是哪個應用程式提出請求，再選 允許存取。

在對話中開啟

在對話中選擇 +，再選 Connectors，把 NexRex 打開。

Team 和 Enterprise 方案由 Owner 先在 Organization settings 的 Connectors 加入 NexRex 一次。之後每位成員到 Customize 的 Connectors，在 NexRex 旁邊選 Connect。

連接 Claude Code

在終端機執行：

claude mcp add --transport http nexrex https://mcp.nexrex.ai/mcp

接著登入：

claude mcp login nexrex

瀏覽器會開啟 NexRex，登入後選 允許存取。你也可以在 Claude Code 裡執行 /mcp，選擇 nexrex 後依照提示登入。

連接 Codex

在終端機執行：

codex mcp add nexrex --url https://mcp.nexrex.ai/mcp

Codex 會在瀏覽器開啟 NexRex，登入後選 允許存取。如果瀏覽器沒有開啟，或之後 Codex 要你重新登入，請執行：

codex mcp login nexrex

連接 VS Code

以下步驟適用搭配 GitHub Copilot 的 VS Code。

加入 NexRex

選擇將 NexRex 加入 VS Code，讓瀏覽器開啟 VS Code，再選 Install。也可以在終端機執行：

code --add-mcp '{"name":"nexrex","type":"http","url":"https://mcp.nexrex.ai/mcp"}'

登入 NexRex

VS Code 詢問是否要驗證 NexRex 時選擇允許，瀏覽器會開啟 NexRex。登入後選 允許存取。

開始問你的訓練

在 agent 模式開啟 Copilot Chat，問問看，例如「我這週跑得怎麼樣？」

其他 AI 應用程式

其他 MCP 應用程式只要支援登入（OAuth），也能用同一個網址連接。NexRex 不發放可以貼上的權杖，所以只接受權杖的應用程式無法連接。

查看與中斷連線

在網頁版前往 設定 → 整合服務。將 NexRex 連接到你的 AI 卡片上的 已連接的 AI 助理 會列出你連接過的每個應用程式，以及連接時間和最後使用時間。選擇 中斷連線 就會結束該連線，應用程式會立刻失去存取權。之後要再使用，重新連接即可。在 AI 應用程式裡移除 NexRex，只會讓那個應用程式不再使用 NexRex。若要連 NexRex 這一端的連線也一併結束，請在 設定 → 整合服務 中斷連線。

連線可以維持多久

只要持續使用，連線就會一直有效。如果某個應用程式 30 天都沒有使用 NexRex，連線就會結束，下次使用時再登入一次即可。如果偵測到應用程式的登入憑證被異常使用，例如同時從兩個地方使用，NexRex 也會結束連線。重新連接就能繼續使用。

疑難排解

2026 年 10 月 21 日之後 NexRex 無法使用

NexRex 在 2026 年 10 月 21 日把所有 AI 連線改為登入制。如果你在這之前就連接過，請重新連接一次：

ChatGPT 或 Claude：移除 NexRex，再依照上面的步驟重新加入。
Claude Code：執行 claude mcp login nexrex。
Codex：執行 codex mcp login nexrex。

如果你當初是用權杖設定 NexRex，例如在 Claude Code 用了 --header、在 Codex 用了 http_headers，請先用 claude mcp remove nexrex 或 codex mcp remove nexrex 移除，再用你的應用程式對應的指令重新加入。

AI 應用程式要你重新登入

代表連線已經結束：可能是 30 天沒有使用、有人在 NexRex 中斷了連線，或 NexRex 為了保護你的帳號而結束連線。重新登入就能再連接。

Codex 在連線結束後持續重試

如果 Codex 一直回報 invalid_grant，請清除已儲存的 NexRex 登入狀態，再重新連接：

codex mcp logout nexrex
codex mcp login nexrex

如果你設定的伺服器名稱不是 nexrex，請改用該名稱。完成 NexRex 登入並選擇 允許存取 後，開啟新的 Codex 工作階段。持續重試無法恢復已結束的連線，重新登入才會建立新連線。你不需要登出 Codex 帳號。

AI 顯示的是別的帳號的資料

NexRex 登入頁的 連線帳號 會顯示你正在連接哪個帳號。請先在 設定 → 整合服務 中斷該應用程式的連線，再用正確的帳號登入並重新連接。

「無法完成連線」

登入過程被中斷或等太久。請回到 AI 應用程式，重新開始連接。

指定使用某個工具

AI 應用程式會自己挑選要用的 NexRex 工具。如果你知道需要什麼，也可以直接指名要它用哪一個。

尋找你自己的運動員資料

get_current_user 工具會回傳你連接的帳號：

{
  "user_id": "usr_8f2k...",
  "athlete_id": "usr_8f2k...",
  "email": "you@example.com",
  "display_name": "Jamie Chen",
  "roles": ["coach"],
  "org_id": "org_x1y2...",
  "profile_available": true
}

給教練：你自己的帳號可能不在你的運動員名單上，所以搜尋名單時可能找不到你。請 AI 先呼叫 get_current_user，再用回傳的 athlete_id 取得你自己的個人資料、課表和活動。

尋找並報名目錄計畫

如果你想讓 AI 幫你或你指導的運動員，從 NexRex 目錄挑一個現成的計畫，而不是草擬新計畫，請用這兩個工具。

工具	類型	功能
`recommend_training_plans`	唯讀	為運動員排序你可以檢視的目錄計畫
`enroll_training_plan`	寫入（需確認）	讓運動員報名一個目錄計畫

recommend_training_plans 在輸入相同時，結果一定相同。NexRex 會拿每個計畫的距離、目標、長度、每週跑量、程度和每週天數，跟運動員近期的訓練、比賽成績預測和主要賽事比對評分。這個工具不會更改任何資料。你可以用下列選填參數縮小範圍：

distance：full、half、hyrox、start 或 none（也接受 marathon 和 half marathon）
goal：finish、time_target、base_building 或 maintenance
race_date：YYYY-MM-DD
days_per_week：1 到 7
target_time：H:MM:SS
top_k：回傳幾個候選計畫，1 到 10（預設 3）

結果會列出候選計畫、推薦理由和不足之處，並附上這些旗標：

missing_inputs：AI 重新推薦前應該先問你的資訊
health_hold：傷病或恢復狀況顯示不宜加量時為 true。這時 AI 不會推薦或報名計畫，而是建議你先恢復，或跟教練討論。
no_good_match：沒有合適的目錄計畫時為 true。只有這種情況，AI 才會提議用 create_training_plan 草擬新計畫。

enroll_training_plan 會讓運動員從 start_date（YYYY-MM-DD）開始參加目錄計畫。NexRex 會把每一堂課排進運動員的行事曆，並設為主要計畫。選填參數有 training_days_per_week（2 到 7）和 long_run_preference（saturday、sunday 或 weekend）。如果運動員已經報名，NexRex 會回傳既有的 plan_instance_id 和 already_enrolled: true，不會重複報名。

{
  "athlete_id": "usr_8f2k...",
  "training_plan_id": "plan_half_12w...",
  "plan_instance_id": "pi_3c9d...",
  "already_enrolled": false,
  "start_date": "2026-11-02"
}

AI 只會在運動員明確確認計畫和開始日期之後，才呼叫 enroll_training_plan。

`plan_recommendation` 提示

NexRex 也提供 plan_recommendation 提示，在會列出提示的應用程式中，標題是Recommend a training plan。它會帶 AI 走完整個流程：

用 get_current_user 確認運動員身分。
查看運動員的訓練狀態、比賽成績預測和個人資料。
呼叫 recommend_training_plans，只詢問它回傳的 missing_inputs。
如果 health_hold 是 true 就停下來。
用白話說明首選計畫和它的不足之處。
只有 no_good_match 是 true 時，才提議使用 create_training_plan。
等你確認計畫和開始日期後，呼叫一次 enroll_training_plan。

你可以把需求放進選填的 athlete_request 參數，例如：「幫我找一個半馬計畫，比賽在 3 月 15 日，每週跑 4 天。」

指派群組計畫（教練）

如果你指導群組，AI 可以查看和指派群組計畫。

list_group_plans（唯讀）會列出群組的計畫，包括計畫實例 ID、名稱、範本、開始日期、週數、狀態，以及成員和子群組數量。預設只回傳進行中的計畫；把 status 設為空字串就會列出全部。
assign_group_plan 會把已儲存的群組計畫範本指派給群組，並讓成員報名。必填參數是 group_id、training_plan_id 和 start_date（YYYY-MM-DD），選填參數是 sub_groups、assignments 和 plan_name。

assign_group_plan 預設會指派群組目前所有成員，並使用範本的子群組。計畫有兩個以上子群組時，必須提供 assignments，把每位成員的使用者 ID 對應到子群組名稱。每位被指派的人都必須是群組目前的成員。你需要在群組所屬的組織擔任教練，而且你的組織要能使用群組訓練計畫。 NexRex 會把成員的課表排程放進佇列處理。結果會列出被指派的 member_user_ids 和 member_scheduling: "queued"，不會回報每位成員各自的結果。 AI 只會在你明確確認範本、開始日期和成員分配之後，才呼叫 assign_group_plan。教練常見的流程：

用帶 group_id 的 create_training_plan 草擬計畫。
用 save_mode: "template_only" 的 save_training_plan 存成群組計畫範本。
用存好的 training_plan_id 呼叫 assign_group_plan。
用 list_group_plans 和 get_group_plan 查看指派好的計畫。
之後要修改時，用 scope: "group" 的 propose_plan_revision，再呼叫 approve_plan_revision。

更新紀錄

3.0.1 — 2026 年 10 月 29 日

查詢仍在產生中的訓練計畫草稿時，NexRex 會最多等候 20 秒讓它完成，AI 通常不必等你再問一次就能顯示草稿。

3.0.0 — 2026 年 10 月 28 日

訓練計畫草稿現在會在背景產生。AI 可以查詢進度，完成後先讓你檢視，再編輯或儲存；儲存前不會變更你的行事曆。
當任務需要寫入權限時，ChatGPT 可以請你重新連線授權。授權後，儲存計畫或套用行事曆變更仍需要你的指示。

2.0.0 — 2026 年 10 月 28 日

AI 一開始只有讀取權限，要取得寫入權限前會先詢問你。在這之前建立的連線保有兩種權限，不必重新連接。
活動、運動員名單和計畫等較長的清單改為分頁回傳，AI 可以從上次停下的地方接著讀。
儲存前，AI 可以逐週查看較長的計畫草稿。
可以從 VS Code 連接。

1.0.0 — 2026 年 10 月 21 日

所有應用程式都改用 NexRex 帳號登入連接，不再接受貼上權杖。

開發者 API

API 參考

將 NexRex 連接到你的 AI

AI 能幫你做什麼

AI 動手前會問你什麼

讀取與寫入權限

修改行事曆和計畫之前

Garmin 與運動員通知

AI 可以使用的工具

連接 ChatGPT

連接 Claude

連接 Claude Code

連接 Codex

連接 VS Code

其他 AI 應用程式

查看與中斷連線

連線可以維持多久

疑難排解

2026 年 10 月 21 日之後 NexRex 無法使用

AI 應用程式要你重新登入

Codex 在連線結束後持續重試

AI 顯示的是別的帳號的資料

「無法完成連線」

指定使用某個工具

尋找你自己的運動員資料

尋找並報名目錄計畫

`plan_recommendation` 提示

指派群組計畫（教練）

更新紀錄

3.0.1 — 2026 年 10 月 29 日

3.0.0 — 2026 年 10 月 28 日

2.0.0 — 2026 年 10 月 28 日

1.0.0 — 2026 年 10 月 21 日

​AI 能幫你做什麼

​AI 動手前會問你什麼

​讀取與寫入權限

​修改行事曆和計畫之前

​Garmin 與運動員通知

​AI 可以使用的工具

​連接 ChatGPT

​連接 Claude

​連接 Claude Code

​連接 Codex

​連接 VS Code

​其他 AI 應用程式

​查看與中斷連線

​連線可以維持多久

​疑難排解

​2026 年 10 月 21 日之後 NexRex 無法使用

​AI 應用程式要你重新登入

​Codex 在連線結束後持續重試

​AI 顯示的是別的帳號的資料

​「無法完成連線」

​指定使用某個工具

​尋找你自己的運動員資料

​尋找並報名目錄計畫

​plan_recommendation 提示

​指派群組計畫（教練）

​更新紀錄

​3.0.1 — 2026 年 10 月 29 日

​3.0.0 — 2026 年 10 月 28 日

​2.0.0 — 2026 年 10 月 28 日

​1.0.0 — 2026 年 10 月 21 日

AI 能幫你做什麼

AI 動手前會問你什麼

讀取與寫入權限

修改行事曆和計畫之前

Garmin 與運動員通知

AI 可以使用的工具

連接 ChatGPT

連接 Claude

連接 Claude Code

連接 Codex

連接 VS Code

其他 AI 應用程式

查看與中斷連線

連線可以維持多久

疑難排解

2026 年 10 月 21 日之後 NexRex 無法使用

AI 應用程式要你重新登入

Codex 在連線結束後持續重試

AI 顯示的是別的帳號的資料

「無法完成連線」

指定使用某個工具

尋找你自己的運動員資料

尋找並報名目錄計畫

`plan_recommendation` 提示

指派群組計畫（教練）

更新紀錄

3.0.1 — 2026 年 10 月 29 日

3.0.0 — 2026 年 10 月 28 日

2.0.0 — 2026 年 10 月 28 日

1.0.0 — 2026 年 10 月 21 日