> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pathors.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP 整合

> 透過 Model Context Protocol 連接 Pathors，以 AI 原生方式管理你的語音助理

Pathors MCP 伺服器讓你直接從 Claude Desktop、Claude Code、Cursor 及任何相容 MCP 的用戶端管理 AI 助理。工具會自動發現，不需要記住任何端點。

## 連接

伺服器預設使用 **OAuth** — 首次連接時會自動引導你完成認證流程，不需要手動設定。

### Claude

Pathors 支援 **Claude Custom Connector** — 你可以直接從 **Claude Desktop** 或 **claude.ai** 新增，不需要任何設定檔：

1. 前往 **Settings > MCP**（或 **Integrations**）
2. 點擊 **Add Custom Connector**
3. 輸入伺服器 URL：`https://api.pathors.com/mcp`
4. 依照提示完成 OAuth 認證

### 用戶端設定

其他用戶端或偏好使用設定檔的方式，請將以下內容加入對應的 MCP 設定：

<CodeGroup>
  ```json Claude Desktop (claude_desktop_config.json) theme={null}
  {
    "mcpServers": {
      "pathors": {
        "type": "streamable-http",
        "url": "https://api.pathors.com/mcp"
      }
    }
  }
  ```

  ```bash Claude Code theme={null}
  claude mcp add pathors --transport streamable-http https://api.pathors.com/mcp
  ```

  ```json Cursor (.cursor/mcp.json) theme={null}
  {
    "mcpServers": {
      "pathors": {
        "type": "streamable-http",
        "url": "https://api.pathors.com/mcp"
      }
    }
  }
  ```

  ```json Windsurf theme={null}
  {
    "mcpServers": {
      "pathors": {
        "serverUrl": "https://api.pathors.com/mcp"
      }
    }
  }
  ```
</CodeGroup>

<Note>
  所有上述用戶端在首次連接時都會自動觸發 OAuth 認證。
</Note>

## 可用工具

連接後，MCP 用戶端會自動發現以下類別的工具：

| 類別      | 功能                   |
| ------- | -------------------- |
| 專案      | 建立、列出、更新、刪除專案        |
| 助理設定    | 取得和更新助理設定            |
| 對話流程    | 設計對話流程（節點 + 邊）       |
| Session | 查詢對話歷史和分析            |
| 測試      | 管理測試案例、測試套件、執行測試     |
| 工具設定    | 設定助理工具（REST API、搜尋等） |

所有工具的參數和說明都由 MCP 協定本身提供 — 你的 AI 助手會知道如何使用。