這是一份完整指南，用於將您的遠端 MCP 伺服器提交至 Anthropic 的 MCP 目錄，以實現更廣泛的發佈和可發現性。
先決條件
在提交伺服器之前，您應該具備：
一個經過完整測試的遠端 MCP 伺服器
已實現 OAuth 2.0 身份驗證（如果需要身份驗證）
所有工具都具有適當的安全註解
生產就緒的部署
專用支援管道（電子郵件或網路）
已配置的測試帳戶和範例資料
全面的文件
剛開始使用遠端 MCP 開發？請先參閱使用遠端 MCP 開始使用自訂連接器。如需技術最佳實踐和協議詳細資訊，請參閱 MCP 協議文件。
注意：本指南涵蓋遠端 MCP 伺服器（雲端託管、HTTPS）。如需本地桌面擴充功能，請參閱本地 MCP 伺服器提交指南。
1. 目錄概述
目錄包含有什麼好處？
可發現性和信任：
列在可從 Claude.ai 存取的官方 Anthropic MCP 目錄中
可供所有平台上的 Claude 使用者存取（網路、桌面、行動）
為您的服務提供專業可見性
使用者體驗：
從目錄一鍵連接
與 Claude 的連接器介面整合
跨平台的標準化呈現
無縫處理 OAuth 流程
支援和信譽：
Anthropic 對品質、安全性和合規性的審查
與其他經過驗證的連接器並列
社群可見性和反饋
專業發佈管道
哪些 Claude 平台支援遠端 MCP 伺服器？
所有主要 Claude 平台：
Claude.ai（網路） - 完全支援 OAuth
Claude Desktop - 完全支援 OAuth
Claude Code - 從使用者機器直接連接（支援 OAuth）
Claude API - 整合支援
Claude 行動應用程式 - 連接器支援
2. 強制性要求
本節中的所有要求都是目錄批准的強制性要求。缺少其中任何一項將導致拒絕或修訂請求。
是否需要安全註解？
是 - 每個工具都必須具有準確的安全註解。
每個工具上必需的：
readOnlyHint: true - 適用於僅讀取資料的工具
destructiveHint: true - 適用於修改資料或有副作用的工具
請參閱 MCP 協議 - 工具註解以了解完整的架構和實現詳細資訊。
不是可選的。這是源自MCP 目錄政策的硬性要求。
如何決定使用哪個註解：
工具行為 | 註解 | 範例 |
僅讀取資料 | readOnlyHint: true, destructiveHint: false | search、get、list、fetch、read |
寫入/修改資料 | destructiveHint: true, readOnlyHint: false | create、update、delete、send |
建立臨時檔案 | destructiveHint: true | 即使是臨時寫入也算 |
傳送外部請求 | destructiveHint: true | 電子郵件、通知、Webhook |
僅內部快取 | readOnlyHint: true | 內部最佳化可以 |
其他建議的註解：
title - 用於 UI 顯示的人類可讀工具名稱（改善使用者體驗）
我需要提供測試帳戶嗎？
是 - 如果您的伺服器需要身份驗證。
要提供的內容：
測試帳戶認證（使用者名稱/密碼或 API 金鑰）
帳戶中的範例資料（功能測試所需）
測試環境的設定說明
存取限制（如果有）
測試帳戶應具備：
存取所有正在審查的工具
代表性範例資料
適當的權限以進行完整功能測試
在審查期間及之後保持活躍狀態
如何提供：
在提交表單中包含認證（最好透過安全方法共享，例如 1Password 連結）
確保帳戶在審查期間和之後保持活躍，以進行定期的入選後審查
提供足夠的存取權限以進行全面測試
是否需要 OAuth 2.0？
是 - 如果您的伺服器需要身份驗證。
OAuth 實現要求：
必須使用 OAuth 2.0 授權代碼流程
來自公認機構的憑證
允許列表本地 MCP 用戶端（例如 Claude Code、MCP Inspector）回呼 URL：
允許列表 Claude 回呼 URL：
適當的重定向 URI 配置
要避免的常見 OAuth 問題：
無效的重定向 URI 錯誤（確保兩個回呼 URL 都在允許列表中）
沒有令牌的 HEAD 請求（在 OAuth 流程後優雅地處理）
實現指南：請參閱 OAuth 2.0 授權框架以了解完整的 OAuth 實現詳細資訊。
是否有防火牆要求？
是 - 必須允許列表 Claude 的 IP 位址以實現 claude.ai 相容性
對於防火牆後面的伺服器，允許列表來自 https://docs.claude.com/en/api/ip-addresses 的 IP 位址。
必需項目：Claude.ai 和 Claude Desktop
不需要：Claude Code（直接從使用者機器連接）
重要：不建議單獨使用 IP 允許列表作為安全措施。盡可能使用 OAuth 2.0 進行身份驗證。
需要什麼文件？
具有特定部分的全面伺服器文件。
建議的部分：
伺服器描述 - 清楚說明您的伺服器的功能
功能 - 主要功能和使用案例
設定說明 - 使用者如何連接和配置
身份驗證 - OAuth 設定和要求（如果適用）
使用範例 - 最少 3 個帶有提示的工作範例（必需）
隱私政策 - 完整隱私政策的連結
支援 - 使用者如何獲得幫助或報告問題
文件結構範例：
# [您的服務名稱] MCP 伺服器
## 描述
[服務整合和功能的簡要描述]
## 功能
- 功能 1：[描述和價值]
- 功能 2：[描述和價值]
- 功能 3：[描述和價值]
## 設定
1. 造訪 [Anthropic MCP 目錄](https://claude.com/connectors)
2. 尋找並連接到 [您的服務]
3. 完成 OAuth 身份驗證
4. 配置任何必需的設定
## 身份驗證
此伺服器需要 OAuth 身份驗證。您需要：
- 有效的 [您的服務] 帳戶
- [任何特定的權限或帳戶類型]
## 範例
[請參閱下面的最少 3 個範例部分]
## 隱私政策
請參閱我們的隱私政策：https://your-domain.com/privacy
## 支援
- 電子郵件：[email protected]
- 文件：https://your-domain.com/mcp-docs
- 問題：https://github.com/yourcompany/mcp-server/issues
需要多少個使用範例？
最少三個演示核心功能的工作範例。
什麼是好的範例：
顯示現實的使用者提示/請求
演示實際的伺服器功能
包括預期的輸出或行為
清晰易懂的工作流程
涵蓋不同的功能
範例格式：
## 範例
### 範例 1：搜尋文件
**使用者提示：**「在我的工作區中尋找最近的專案報告」
**發生的情況：**
- 伺服器搜尋您的工作區
- 傳回具有中繼資料的匹配文件
- 提供快速存取連結
### 範例 2：建立新內容
**使用者提示：**「為行銷活動建立新的任務清單」
**發生的情況：**
- 伺服器建立新的任務清單
- 根據上下文新增初始結構
- 傳回新建立清單的連結
### 範例 3：更新現有資料
**使用者提示：**「將專案狀態更新為「進行中」並新增今天的里程碑」
**發生的情況：**
- 伺服器找到專案
- 更新狀態欄位
- 新增具有目前日期的里程碑
- 確認所做的變更
要求：
最少 3 個範例（無上限）
涵蓋不同的工具/功能
顯示現實的使用者互動
演示價值主張
包括在伺服器文件中
生產就緒要求是什麼？
伺服器必須處於通用可用性 (GA) 狀態。
生產就緒意味著：
伺服器在生產中穩定可靠
未標記為「測試版」、「Alpha」或「開發」
所有功能都已完全實現和測試
適當的錯誤處理和優雅的故障
可擴展的基礎設施和監控
完整的文件和支援管道
無法包含：測試版、開發伺服器或有限存取服務。
必須滿足哪些技術要求？
必須符合核心技術合規標準。
傳輸和效能：
必須支援可串流 HTTP 傳輸（SSE 支援可能已棄用）
快速回應時間和高可用性
優雅的錯誤處理和有用的訊息
令牌高效的回應（每個工具結果最多 25,000 個令牌）
安全性和資料：
HTTPS/TLS 與有效的憑證
為瀏覽器用戶端正確配置 CORS
支援所有必需的 Claude 用戶端來源
僅收集功能所需的資料
不收集無關的對話資料
符合隱私的資料實踐
3. 提交流程
我如何提交我的遠端 MCP 伺服器？
按照此逐步提交流程：
1. 提交前檢查清單：
驗證強制性要求：
[ ] 所有工具都有 readOnlyHint 或 destructiveHint 註解
[ ] OAuth 2.0 已實現（如果需要身份驗證）
[ ] 伺服器可透過 HTTPS 存取
[ ] Claude IP 位址已允許列表（如果伺服器在防火牆後面）
[ ] 已發佈全面文件
[ ] 已發佈隱私政策並可存取
[ ] 專用支援管道（電子郵件或網路）
[ ] 測試帳戶已準備好（如果需要身份驗證）
[ ] 伺服器已生產就緒（GA 狀態）
測試您的伺服器：
[ ] 從 Claude.ai 正確運作
[ ] 從 Claude Desktop 正確運作
[ ] 從 Claude Code 正確運作（如果沒有 IP 限制）
[ ] OAuth 流程成功完成
[ ] 所有工具按文件所述運作
[ ] 錯誤訊息有幫助且使用者友善
[ ] 在負載下的效能可接受
2. 完成提交表單：
提交表單： MCP 目錄伺服器審查表單
必需資訊：伺服器詳細資訊、文件連結、測試認證、範例（最少 3 個）和聯絡資訊。表單提供完整清單。
雖然我們努力盡快審查每份提交，但由於興趣量很大，我們無法保證我們會接受您的提交或單獨回應。
4. 常見問題
修訂請求最常見的原因是什麼？
這些是基於提交資料的主要問題：
1. 缺少工具註解
問題：工具缺少必需的安全註解
修復：將 readOnlyHint 或 destructiveHint 新增到所有工具
影響：立即拒絕，需要程式碼變更
預防：在提交前驗證所有工具
2. OAuth 實現問題
問題：OAuth 流程失敗或有配置錯誤
常見原因：
OAuth 提供者中缺少回呼 URL
無效的重定向 URI 配置
防火牆配置錯誤
修復：使用 MCP Inspector、Claude Code 或 Claude.ai 徹底測試 OAuth 流程
影響：無法完成功能測試，延遲批准
3. 文件不完整
問題：缺少範例、設定說明不清楚或缺少必需的部分
修復：提供最少 3 個詳細範例並完成所有文件部分
影響：修訂請求，延遲批准
預防：完全按照文件範本進行
4. 生產就緒性問題
問題：伺服器標記為「測試版」或顯示不穩定問題
修復：確保 GA 狀態和穩定的生產部署
影響：在生