---
title: "把 Replai 連接到 Claude Code、Codex、ChatGPT 或其他 MCP 用戶端 · Replai"
url: https://replai.tw/zh-TW/guide/connect-ai-agents
language: zh-TW
last_updated: 2026-10-18
publisher: "Replai · AIthentic LLC"
---

# 把 Replai 連接到 Claude Code、Codex、ChatGPT 或其他 MCP 用戶端

Replai 的遠端 MCP 伺服器網址是 https://api.replai.tw/mcp。Claude Code 和 Codex 用一行指令加入；ChatGPT 和其他 MCP 用戶端使用這個網址。第一次連線時，瀏覽器會請你登入、選擇一個 Workspace 並核准存取，之後隨時可以撤銷。

## 開始之前

你需要一個 Replai 帳號、一個支援遠端 MCP 伺服器與 OAuth 登入的 AI 工具，以及同一台電腦上可以核准存取的瀏覽器。不需要手動複製 API 金鑰或權杖。

- **Replai 帳號：**在 [replai.tw](https://replai.tw/zh-TW/) 用 Google 登入。第一次登入時，Replai 會建立一個 Workspace。
- **AI 工具：**Claude Code、Codex、ChatGPT，或其他能透過 Streamable HTTP 連接遠端 MCP 伺服器、並用 OAuth 登入的用戶端。
- **瀏覽器：**第一次連線時會在瀏覽器打開 Replai，讓你核准存取。

## 連接 Claude Code

把 Replai 加為遠端 HTTP 伺服器，再從 Claude Code 裡完成登入。

```
claude mcp add --transport http replai https://api.replai.tw/mcp
```

1. 在終端機執行上面的指令。
2. 啟動 Claude Code，執行 /mcp，選擇 replai 後選 Authenticate。
3. 在打開的瀏覽器視窗核准存取，再回到 Claude Code。

## 連接 Codex

用網址加入 Replai。Codex 會自動找到 Replai 的登入方式，不需要其他設定。

```
codex mcp add replai --url https://api.replai.tw/mcp
```

1. 在終端機執行上面的指令。
2. 在打開的瀏覽器視窗核准存取。如果沒有打開視窗，執行 codex mcp login replai。
3. 啟動 Codex，請它在 Replai 裡工作。

## 連接 ChatGPT 或其他 MCP 用戶端

能連接遠端 MCP 伺服器的用戶端，都使用同一個網址並選擇 OAuth 驗證。在 ChatGPT 中，遠端 MCP 伺服器要在開發人員模式下以 App 加入，前提是你的方案與工作區管理員允許。

```
https://api.replai.tw/mcp
```

- **傳輸方式：**Streamable HTTP。
- **驗證：**OAuth。Replai 公開登入資訊供用戶端自動探索，支援動態用戶端註冊，並要求 PKCE。
- **ChatGPT：**用上面的網址建立 App，驗證方式選 OAuth。

## 第一次連線會請你做什麼

瀏覽器會打開 Replai，請你用 Replai 帳號登入。接著選擇這個 AI 工具可以存取的一個 Workspace，確認它能做的事，再按「允許存取」。瀏覽器會帶你回到 AI 工具。

1. 用你登入 Replai 的 Google 帳號登入。
2. 選擇 AI 工具可以存取的 Workspace。
3. 確認 AI 工具要求的權限，再按「允許存取」。
4. 回到 AI 工具。它現在可以在那個 Workspace 使用 Replai 的工具。

每個已連接的 AI 工具都能讀取你的 Agent、知識、測試、對話與 Workspace 資訊。它也可能要求編輯 Agent 草稿、建立 Agent、發布、管理知識來源、測試與渠道、在收件匣回覆、管理關聯的工程議題、連接外部資源、更新 Workspace 設定或刪除 Agent。對 Agent 的修改會留在草稿，直到發布為止。

## Replai 提供哪些工具

工具涵蓋完整的設定流程與日常客服工作：Agent 與草稿、知識、測試、發布、渠道、收件匣、工程議題與分析。AI 工具連線時會從 Replai 讀取確切的工具清單。

**Replai MCP 工具分類**

| 類別 | AI 工具可以做什麼 | 工具範例 |
| --- | --- | --- |
| Workspace 與 Agent | 查看已連接的 Workspace、列出與建立 Agent、讀取與編輯 Agent 草稿 | connection_context、agents_list、agent_create、agent_draft_edit |
| 知識 | 探索並匯入網站頁面、匯入 Google 雲端硬碟檔案與 GitHub 儲存庫、新增文字、重新匯入或撤下來源 | website_discover、website_import、source_add、source_refresh |
| 測試與知識缺口 | 把問題存成測試、執行測試、讀取結果，並檢視答不出來的問題 | test_case_create、test_case_run、knowledge_gaps_list |
| 發布 | 檢視確切的發布內容、發布、暫停，或把先前的版本還原到草稿 | publication_review、publication_publish、publication_restore |
| 渠道 | 開啟網站 Widget 並讀取安裝程式碼、調整 Widget 與 LINE 群組設定、檢查 LINE 狀態 | widget_enable、widget_installation_read、line_behavior_edit |
| 收件匣 | 讀取對話、回覆、核准或退回草稿、接手、交還 AI 與標記解決 | inbox_list、inbox_reply、inbox_draft_approve、inbox_return_to_ai |
| 工程 | 從對話提出並建立 Linear 議題、記錄發布並追蹤客戶後續通知 | engineering_propose、engineering_approve、engineering_release_decide |
| 分析 | 讀取 Agent 分析、渠道活動與用量 | agent_analytics、agent_kpis_read、workspace_usage |

有幾個步驟刻意留在瀏覽器完成：從電腦上傳檔案、輸入 LINE 渠道憑證，以及連接 Google 雲端硬碟、GitHub 或 Linear，都會回傳一個 Replai 連結讓你打開，AI 工具再讀取結果。

## 撤銷存取

打開工作區設定 → MCP 與 CLI。在「已連接」找到該工具，按「撤銷授權」，它會立即失去存取。

1. 在 Replai 打開 工作區設定 → MCP 與 CLI。
2. 在「已連接」找到該 AI 工具。每一筆都會列出權限與存取的有效期限。
3. 按「撤銷授權」。

如果也要從 AI 工具移除 Replai，在 Claude Code 執行 claude mcp remove replai，在 Codex 執行 codex mcp remove replai。只在 AI 工具移除，不會撤銷 Replai 裡的授權。

## 改用 Replai CLI

Replai CLI 在終端機完成同樣的設定、測試、發布與收件匣工作，適合透過 shell 指令工作的程式開發 Agent。安裝後在瀏覽器登入一次即可。

```
curl -fsSL https://replai.tw/install.sh | sh
```

1. 執行上面的安裝指令。
2. 執行 replai login，在瀏覽器核准存取。
3. 執行 replai status 查看已連接的 Workspace，執行 replai --help 查看指令。

指令涵蓋 Agent、草稿、知識來源、網站匯入、Widget、測試、發布前檢視與發布，以及收件匣。結果以 JSON 輸出。執行 replai logout 會撤銷 CLI 的存取並刪除儲存的憑證。

[疑難排解：Agent 沒有回覆或回答錯誤時](https://replai.tw/zh-TW/guide/troubleshooting)

## 延伸閱讀

- [Replai 如何運作Replai 根據你的產品知識回答客戶，需要時轉給真人。設定步驟、影響回答的設定，以及讓回答更準的方法。](https://replai.tw/zh-TW/guide/how-it-works)
- [知識來源Replai Agent 可以從檔案、網頁、網站、Google Drive、GitHub 儲存庫與文字學習。各來源的限制，以及如何讓知識保持最新。](https://replai.tw/zh-TW/guide/knowledge-sources)
- [頻道一個 Agent 同時回答網站 Widget 與 LINE 官方帳號（含群組）上的客人，共用同一套知識和轉接設定。Messenger、Instagram 搶先體驗中，也說明 WhatsApp 的支援狀態。](https://replai.tw/zh-TW/guide/channels)

Replai · AIthentic LLC  最後更新 2026 年 10 月 18 日
