ClickSend MCP Server

这是由 ClickSend 团队开发的官方 ClickSend MCP Server。出于安全考虑，请勿使用非官方版本的 ClickSend MCP。

用途

ClickSend MCP 旨在将 ClickSend 的短信能力扩展到现代 AI 生态和平台 - 使开发者无需编写自定义代码即可通过 ClickSend 轻松发送 SMS。

这加速了采用并实现 AI 驱动的新用例，使 ClickSend 在智能自动化时代成为灵活消息的通信平台。

Related MCP server: Twilio MCP Server

运行要求

• Node.js >= 18

  • 你可以使用 nvm（Node Version Manager）来设置正确的版本，以避免运行此应用

安装

下载一个 AI desktop client。例如 Claude for Desktop，你可以点 这里 下载。

配置

服务器需要两个环境变量：

• CLICKSEND_USERNAME: 你的 ClickSend 用户名

• CLICKSEND_API_KEY: 你的 ClickSend API Key

点击注册 ClickSend 后，你可以通过 https://dashboard.clicksend.com/account/subaccounts 找到用户名和 Key。

Claude Desktop 配置

• 打开 Claude Desktop Desktop

• 从系统菜单栏进入 Settings

• 在设置窗口，进入 Developer 标签并点击 Edit Config。这样会打开配置文件，位于：

  • macOS in: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows：%APPDATA%\Claude\claude_desktop_config.json

• 使用 NPM Package

{
  "mcpServers": {
    "clicksend": {
      "command": "npx",
      "args": [
        "-y",
        "@clicksend/clicksend-mcp-server@latest"
      ],
      "env": { 
        "CLICKSEND_USERNAME": "<username>",
         "CLICKSEND_API_KEY": "<api-key>"
      }
    }
  }
}

• 使用 Local Build

{
  "mcpServers": {
    "clicksend": {
      "command": "node",
      "args": [
        "/path/to/repository/build/clicksend-mcp.js"
      ],
      "env": {
        "CLICKSEND_USERNAME": "your clicksend username",
        "CLICKSEND_API_KEY": "your API Key"
      }
    }
  }
}

之后，请重启 Claude Desktop 以重新加载配置。如果可以连接，点击锤子图标时应该会看到 clicksend-send-sms。

与 Claude 的示例交互

以下是一些通过 Claude 与服务器交互的自然方式：

Simple SMS：

Send a text message to the number 61411111111 saying "I'm using ClickSend MCP server to sent SMS!"

功能

• 只通过设置clicksend用户名与API Key一次发送一条 SMS

• 计算向联系人列表发送消息的价格

• 通过搜索联系人（Contact）或联系人列表（Contact）并向其发送消息

• 查看 SMS Templates，并使用其发送消息

• 查看/取回 SMS 历史记录

• 获取过去30天 SMS 统计

支持的 API

1. POST /v3/sms/send

• Operation ID: send-sms

• Summary: Send: reciprocal交流 emails

• Description: 向接收者发送消息，可指定为手机号码或从 contact list 中指定的联系人

2. POST /v3/sms/price

• Operation ID: calculate-sms-price

• Summary: 计算 SMS 价格

• Description: 根据消息类型和长度计算发送消息的价格

3. GET /v3/sms/templates

• Operation ID: view-sms-templates

• Summary: 查看 SMS 模板

• Description: 通过过滤选项取回 SMS 模板

4. GET /v3/sms/history

• Operation ID: view-sms-history

• Summary: 查看 SMS 历史

• Description: 按过滤条件和分页选项查看以往发送的 SMS

5. GET /v3/statistics/sms

• Operation ID: view-sms-statistics

• Summary: 查看 SMS 统计

• Description: 获取最近 30 天的 SMS 统计

6. GET /v3/search/contact-lists

• Operation ID: view-contact-lists

• 摘要： 查看联系人列表

• Description： 获取已搜索的联系人列表

重要说明

1. Phone 格式：所有手机号都必须采用E.164格式（例如 +61411111111）

2. 调用限制：注意你的 ClickSend 帐户的速率限制和计费方式

3. 安全：妥善保管你的 ClickSend 凭据，切勿将其提交至版本控制

故障排除

常见的错误消息及解决办法：

1. “Phone number must be in E.164 format”

   • 请确认手机号码以“+”开始并包含国家代码

2. “Invalid credentials”

   • 请再次确认你的 CLICKSEND_USERNAME 和 CLICKSEND_API_KEY。你可以从 ClickSend Dashboard 进行复制

敬请知会贡献欢迎！请提交 PULL Request 前先阅读我们的贡献指南。

许可证

本项目采用 MIT 许可证 - 详细信息请参见 License 文件。

安全

请合格避免在 GitHub issue 或 pull request 中包含任何敏感信息（如手机号码或 ClickSend 凭据）。