跳至主要內容

透過遠端 MCP 伺服器建立自訂連接器

使用遠端 MCP 的自訂連接器可在 Claude、Cowork 和 Claude Desktop 上供免費、Pro、Max、Team 和 Enterprise 方案的使用者使用。免費使用者限制為一個自訂連接器。此功能目前處於測試版。

建立遠端 MCP 伺服器

若要開始使用遠端伺服器,請從以下資源開始:

其他資源(例如 此資源)也可能有助於了解建立、部署和疑難排解遠端伺服器時的考量事項。

此外,某些 Cloudflare 等解決方案提供具有內建自動擴展、OAuth 權杖管理和部署的遠端 MCP 伺服器託管。

MCP 支援

平台

  • Pro、Max、Team 和 Enterprise 方案支援在 Claude 和 Claude Desktop 上使用遠端 MCP 伺服器。

    • 若要在 Claude Desktop 中設定遠端 MCP 伺服器以供使用,請透過 自訂 > 連接器新增它們。Claude Desktop 不會連接到直接透過 claude_desktop_config.json 設定的遠端伺服器。

  • 自 7 月起,Claude for iOS 和 Android 也支援遠端 MCP 伺服器!

    • 使用者可以使用他們已透過 claude.ai 新增的遠端伺服器中的工具、提示和資源。使用者無法直接從 Claude Mobile 新增新伺服器。

網路可達性

所有遠端 MCP 連接都源自 Anthropic 的雲端基礎設施,無論使用者執行的是哪個 Claude 用戶端。您的伺服器必須接受來自 Anthropic IP 範圍的入站 HTTPS 連接 — 請參閱 Anthropic IP 位址以取得目前清單。

即使使用者在本機執行 Cowork 或 Claude Desktop,這也適用。透過 自訂 > 連接器新增的遠端連接器由伺服器端代理,因此對您 MCP 伺服器的請求來自 Anthropic,而不是來自使用者的機器。

如果您的伺服器在私人網路內執行,請設定您的防火牆或入口以允許來自 Anthropic 已發佈 IP 範圍的入站流量。只能透過 VPN 或位於阻止 Anthropic 出站 IP 的防火牆後面的伺服器將無法連接。

傳輸和驗證

  • Claude 支援基於 SSE 和 Streamable HTTP 的遠端伺服器,儘管 SSE 的支援可能在未來幾個月內被棄用。

  • Claude 支援無驗證和基於 OAuth 的遠端伺服器。

驗證支援

  • Claude 支援 3/26 驗證規格和(自 7 月起)6/18 驗證規格

  • Claude 支援 動態用戶端註冊 (DCR)。

    • OAuth 伺服器可以向 Claude 發出信號,表示 DCR 用戶端已被刪除,Claude 應該透過從權杖端點傳回 HTTP 401 並出現 invalid_client 錯誤來重新註冊用戶端,如 RFC 6749 中所述。

    • 自 7 月起,使用者也能夠在設定不支援 DCR 的伺服器時指定自訂用戶端 ID 和用戶端密碼。

  • Claude 的 OAuth 回呼 URL 是 https://claude.ai/api/mcp/auth_callback,其 OAuth 用戶端名稱是 Claude。

    • 此回呼 URL 未來可能會變更為 https://claude.com/api/mcp/auth_callback — 如果您選擇將 MCP 用戶端回呼 URL 加入允許清單,請同時將此回呼 URL 加入允許清單,以確保您的伺服器繼續與 Claude 搭配運作。

  • Claude 支援權杖過期和重新整理 — 伺服器應支援此功能,以便為使用者提供最佳體驗。

請參閱 此處以取得 Claude 用於 MCP 伺服器入站和出站連接的 IP 位址。希望禁止非 Claude MCP 用戶端的伺服器開發人員可以將這些 IP 位址、Claude 的 OAuth 回呼 URL 和/或 Claude 的 OAuth 用戶端名稱加入允許清單。

協議功能

  • Claude 支援工具、提示和資源。

    • Claude 支援文字和影像型工具結果。

    • Claude 支援文字和二進位型資源。

  • Claude 尚不支援資源訂閱、取樣和其他更進階或草稿功能。

測試遠端 MCP 伺服器

測試和驗證伺服器的最佳方式是嘗試 將其新增至 Claude

或者,使用 檢查器工具。這將允許您驗證:

  • 您的伺服器成功啟動並完成驗證流程。

  • 您的伺服器正確實作驗證流程的各個部分。

  • 您的伺服器公開的工具、提示、資源和其他 MCP 功能。

請參閱 MCP 文件以取得有關使用檢查器的更多詳細資訊,以及有關如何偵錯和疑難排解伺服器的其他提示。

此外,其他解決方案(例如 Cloudflare 的 AI Playground)允許您測試遠端 MCP 伺服器功能。

是否回答了您的問題?