这是一份完整指南，用于向Anthropic的MCP目录提交您的远程MCP服务器，以实现更广泛的分发和可发现性。
前置条件
在提交服务器之前，您应该具备：
一个经过充分测试的可工作的远程MCP服务器
已实现OAuth 2.0身份验证（如果需要身份验证）
所有工具都具有适当的安全注释
生产就绪的部署
专门的支持渠道（电子邮件或网络）
配置了包含示例数据的测试账户
全面的文档
初次接触远程MCP开发？请先查看使用远程MCP开始自定义连接器。有关技术最佳实践和协议详情，请查看MCP协议文档。
注意：本指南涵盖远程MCP服务器（云托管、HTTPS）。对于本地桌面扩展，请查看本地MCP服务器提交指南。
1. 目录概览
目录包含有什么好处？
可发现性和信任：
在官方Anthropic MCP目录中列出，可从Claude.ai访问
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 | 电子邮件、通知、webhooks |
仅内部缓存 | readOnlyHint: true | 内部优化可以 |
其他推荐的注释：
title - 用于UI显示的人类可读工具名称（改进用户体验）
我需要提供测试账户吗？
是的 - 如果您的服务器需要身份验证。
需要提供的内容：
测试账户凭证（用户名/密码或API密钥）
账户中的示例数据（功能测试所需）
测试环境的设置说明
访问限制（如有）
测试账户应该具有：
访问所有正在审查的工具
代表性的示例数据
适当的权限以进行完整功能测试
在审查期间及之后保持活跃状态
如何提供：
在提交表单中包含凭证（最好通过安全方法共享，例如1Password链接）
确保账户在审查期间和之后保持活跃，以便进行定期的审批后审查
提供足够的访问权限以进行全面测试
是否需要OAuth 2.0？
是的 - 如果您的服务器需要身份验证。
OAuth实现要求：
必须使用OAuth 2.0授权代码流
来自公认权威机构的证书
允许列表本地MCP客户端（例如Claude Code、MCP Inspector）回调URL：
http://localhost:6274/oauth/callback
http://localhost:6274/oauth/callback/debug
允许列表Claude回调URL：
正确的重定向URI配置
常见的OAuth问题需要避免：
无效的重定向URI错误（确保两个回调URL都在允许列表中）
没有令牌的HEAD请求（在OAuth流程后优雅处理）
实现指导：有关完整的OAuth实现详情，请查看OAuth 2.0授权框架。
是否有防火墙要求？
是的 - 必须允许列表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"或"开发"
所有功能都已完全实现和测试
适当的错误处理和优雅失败
可扩展的基础设施和监控
完整的文档和支持渠道
无法包含：测试版、开发服务器或有限访问服务。
必须满足哪些技术要求？
必须满足核心技术合规标准。
传输和性能：
必须支持Streamable 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状态和稳定的生产部署
影响：在生产就绪之前无法包含
预防：完成内部测试和稳定性验证
5. 隐私政策/支持渠道问题
问题：隐私政策/支持渠道的URL缺失或无法访问
修复：提供适当的隐私政策和支持渠道（电子邮件或网络）
影响：由于政策要求立即拒绝
预防：在提交前验证隐私政策/支持渠道可访问性
我如何避免这些问题？
遵循这些预防最佳实践：
1. 彻底完成检查清单
逐项遵循提交前检查清单
不要跳过任何要求
如果可能