跳至主要内容

AI 客戶端配置

Claude Code​

方式一：透過 CLI 新增​

在終端執行：

claude mcp add --transport http orbsis \
  https://mcp.orbsis.com/mcp \
  --client-id agt_xxxxxxxxxxxx \
  --client-secret

執行後，終端會提示輸入 OAuth Client Secret。Client Secret 不會寫入配置檔。首次使用時，Claude Code 會開啟瀏覽器，完成 OAuth 授權。

方式二：透過設定檔新增​

將以下配置新增到 ~/.claude.json 或專案目錄下的 .mcp.json：

{
  "mcpServers": {
    "orbsis": {
      "type": "http",
      "url": "https://mcp.orbsis.com/mcp",
      "oauth": {
        "clientId": "agt_xxxxxxxxxxxx"
      }
    }
  }
}

首次連線 ORBSIS MCP 服務時，客戶端會開啟瀏覽器完成 OAuth 授權。

Codex CLI​

在 ~/.codex/config.toml 中新增：

[mcp_servers.orbsis]
url = "https://mcp.orbsis.com/mcp"

[mcp_servers.orbsis.oauth]
client_id = "agt_xxxxxxxxxxxx"

然後執行登入命令：

codex mcp login orbsis

命令執行後，Codex CLI 會開啟瀏覽器。登入 ORBSIS Business Portal，並同意授權即可完成連線。首次授權完成後，Codex CLI 會保存授權狀態，後續通常無需重複登入。

**注意：**不要將 client_secret 直接寫入 ~/.codex/config.toml。Client Secret 應透過安全的 OAuth 授權流程處理。