Sinch Docs MCP Server

什么是 Sinch Docs MCP Server？

Sinch Docs MCP Server 是 Sinch 官方的文档 MCP 服务器，托管在 developers.sinch.com/mcp，让 AI 编程助手搜索 Sinch 文档并读取其 API 定义，以编写集成代码。它无需 API 密钥，自身也从不调用 Sinch API。

Sinch 是一个通信平台，通过 Conversation API 提供 SMS、WhatsApp、RCS 等渠道的 API，另外还有语音通话、电话号码、验证、号码查询、传真和 SIP 中继等 API。Sinch 在每个 API 的 “AI best practices” 页面中介绍了这个 MCP 服务器，同时提供 llms.txt 索引和每个页面的 Markdown 版本。

如何使用 Sinch Docs MCP Server？

无需安装任何东西。把下面的 URL 添加到任何支持远程 Streamable HTTP 服务器的 MCP 客户端即可：

https://developers.sinch.com/mcp

我们的探测无需凭据即可连接。Sinch 的指南提到某些客户端可能会显示登录提示；遇到时按提示完成即可，但不涉及任何 Sinch API 密钥。

Claude Code

Sinch 文档给出了这条命令；服务器名称可以任取：

claude mcp add --transport http sinch-docs https://developers.sinch.com/mcp

然后在 Claude Code 中输入 /mcp，确认服务器及其工具已列出。

Claude Desktop 和 claude.ai

打开 Settings > Connectors，选择 Add custom connector，命名为 “Sinch Docs”，并粘贴 https://developers.sinch.com/mcp。

Cursor

打开命令面板，运行 “Open MCP settings”，选择 “Add custom MCP”，然后添加 Sinch 指南中的配置：

{
  "mcpServers": {
    "sinch-mcp": {
      "url": "https://developers.sinch.com/mcp"
    }
  }
}

VS Code

在命令面板中运行 “MCP: Add Server”，选择 “HTTP”，输入 URL 和名称。也可以添加到 .vscode/mcp.json：

{
  "servers": {
    "sinch-docs": {
      "type": "http",
      "url": "https://developers.sinch.com/mcp"
    }
  }
}

Sinch Docs MCP Server 的主要功能

• Sinch 官方文档介绍的服务器；免费且无需密钥。
• 仅限文档：Sinch 明确表示它不会调用所找到的端点。生成的代码需要你加入自己的项目，并使用自己的凭据。
• 搜索整个 Sinch 开发者文档，包括其中的代码示例。
• 结构化访问二十多个 OpenAPI 定义，包括 Conversation API、Voice API 和 Voice API v2、Numbers、Number Lookup、Verification、Fax、Elastic SIP Trunk、Provisioning、10DLC 注册、Access Keys 和 Subprojects。
• 端点查询会返回参数、示例、安全要求和服务器 URL。
• 可与 Sinch 发布的 agent skills（npx skills add sinch/skills）搭配，在编程工具中获得更多指引。

Sinch Docs MCP Server 工具

我们的探测返回了两个 MCP 工具，它们封装了一组文档函数：

• describe-tools 返回沙箱函数的精确 TypeScript 签名，让助手不必猜测参数。
• execute 在一个唯一全局对象为 tools、没有网络访问的沙箱中运行 JavaScript。助手通过它调用：
  • listApis 列出已记录的 API，getEndpoints 列出某个 API 的路径和方法。
  • getEndpointInfo 获取单个端点的完整信息，getSecuritySchemes 获取其认证方式。
  • getFullApiDescription 获取完整的 OpenAPI 文档。
  • search 查找相关文档内容。
  • submitFeedback 报告有误或不完整的页面。

Sinch 的指南把这些函数列为独立的工具，名称使用连字符（例如 list-apis 和 get-endpoint-info）。线上服务器目前通过 execute 提供它们，因此你在客户端中只会看到上面两个工具。

Sinch Docs MCP Server 的使用场景

• 发送消息：“根据 Sinch 文档，写一个调用 Conversation API 发送 SMS 的 Node.js 请求。”
• 语音：“哪个 Voice API 端点用于发起外呼，需要哪些参数？”
• 验证：“告诉我如何用 Verification API 发起一次短信验证。”
• 号码：“列出 Numbers API 中用于搜索和激活电话号码的端点。”
• 美国合规：“注册 10DLC 品牌和活动需要哪些步骤？”

Sinch Docs MCP Server 常见问题排查

• 工具调用因未知函数而失败： 让助手先运行 describe-tools，并使用它返回的确切名称。
• 答案基于旧的 API 版本： 多个定义共用同一标题（例如 Number Lookup v1 和 v2）。请指明具体版本，或传入 listApis 返回的 filePath。
• 生成的代码调用 Sinch 失败： 该服务器只读取文档。请检查项目中的凭据和区域，并按 Sinch 的建议对照文档审查代码。