JinDaGe - mcp MCP Details

article

README

🚀 Infobip MCP 服务器

Infobip MCP 服务器允许你构建 AI 代理，通过模型上下文协议 (MCP) 与 Infobip 平台进行交互。连接到 Infobip，让你的代理能够执行各种操作，例如通过 SMS、WhatsApp 或 Viber 等渠道发送消息，或者在可控的生产级环境中管理客户数据。无需再进行复杂的集成或翻阅无尽的文档，只需接入并让你的 AI 开始工作。

🚀 快速开始

Infobip MCP 服务器支持你构建 AI 代理与 Infobip 平台交互，借助 MCP 协议，能让代理在生产级环境执行多种操作。

✨ 主要特性

✉️ 使用 SMS、WhatsApp、Viber 或 RCS 等渠道发送消息（更多渠道即将推出）
📱 设置并运行 2FA 流程
🧑‍💼 存储并激活你的客户信息
👤 管理 Infobip 用户账户

🌐 可用的远程 MCP 服务器

Infobip 远程 MCP 服务器支持可流式传输的 HTTP 传输。以下是可用的远程 MCP 服务器列表。

基础 URL：https://mcp.infobip.com

| 服务器 | 端点 | |--------------------------------------|----------------------------------------------| | SMS | https://mcp.infobip.com/sms | | WhatsApp | https://mcp.infobip.com/whatsapp | | Viber | https://mcp.infobip.com/viber | | RCS | https://mcp.infobip.com/rcs | | 2FA | https://mcp.infobip.com/2fa | | People | https://mcp.infobip.com/people | | 账户管理 | https://mcp.infobip.com/account-management | | CPaaSX 应用程序和实体 | https://mcp.infobip.com/application-entity | | Infobip 文档 | https://mcp.infobip.com/search |

有关支持的端点的更多详细信息，请参阅 Infobip MCP 文档。

使用不同框架的 Infobip MCP 服务器示例可在示例目录中找到。

如果你需要 SSE 传输支持，请在端点 URL 后附加 /sse（例如，https://mcp.infobip.com/sms/sse）。

使用 STDIO 传输桥

如果你的代理不支持远程 MCP 服务器，你可以使用像 mcp-remote 这样的桥接工具。

Claude Desktop 的示例配置：

{
  "mcpServers": {
    "infobip-sms": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.infobip.com/sms",
        "--header",
        "Authorization: App ${INFOBIP_API_KEY}"
      ],
      "env": {
        "INFOBIP_API_KEY": "<你的 Infobip API 密钥在此处>"
      }
    }
  }
}

🔐 身份验证和授权

要使用 Infobip MCP 服务器，你需要一个 Infobip 账户。如果你还没有，请创建一个免费试用的 Infobip 账户。

使用 API 密钥

如果你的 MCP 客户端支持通过配置或环境变量添加额外的标头，你可以使用你的 Infobip API 密钥，并在 Authorization 标头中使用以下格式提供它：App ${INFOBIP_API_KEY}。有关设置详细信息，请参阅上面的 mcp-remote 示例。

使用 OAuth 2.1

Infobip MCP 服务器支持 OAuth 2.1 身份验证。要使用 OAuth 2.1，你的 MCP 客户端必须支持 OAuth 2.1 身份验证和动态 OAuth 授权服务器元数据发现。要启动 OAuth 流程，请将你的 MCP 客户端配置为在不提供身份验证凭据的情况下连接到 Infobip MCP 服务器。你的 MCP 客户端应自动启动 OAuth 流程，将你重定向到 Infobip OAuth 服务器进行身份验证。

发现支持的范围

一些 MCP 客户端可能不支持自动发现 scopes_supported。在这种情况下，你必须在 MCP 客户端配置中手动配置范围。特定 MCP 服务器的范围可以在授权服务器元数据中找到，地址为 {server-url}/.well-known/oauth-authorization-server。

例如，对于 Infobip SMS MCP 服务器，范围可在以下地址找到： https://mcp.infobip.com/sms/.well-known/oauth-authorization-server

Claude Desktop 的示例配置：

{
  "mcpServers": {
    "infobip-sms": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.infobip.com/sms",
        "--debug",
        "--static-oauth-client-metadata",
        "{\"scope\":\"sms:manage profile\"}"
      ]
    }
  }
}

使用 SSE 传输端点时，不会触发 OAuth 流程。请使用可流式传输的 HTTP 传输端点以获得完整的 OAuth 支持。

🛠️ 故障排除

身份验证和授权问题

确保你有一个有效的 Infobip 账户和一个具有正确范围的 API 密钥。
如果你使用的是 OAuth 2.1，请验证你的 MCP 客户端是否支持动态元数据发现。
确认所需的范围已在你的 MCP 客户端中正确配置。

消息传递问题

确保收件人的电话号码有效且可访问。

其他问题

有关 HTTP 状态代码和错误详细信息，请参阅故障排除指南。

🤝 贡献

如果您有改进建议，请联系 devrel@infobip.com。

📄 许可证

本文档采用 MIT 许可证。有关详细信息，请参阅 LICENSE。

祝使用 Infobip MCP 开发愉快！🚀

mcp