ClickSend MCP Server

ClickSend MCP 服务

这是由 ClickSend 团队开发的官方 ClickSend MCP 服务。出于安全原因，请勿使用非官方版本的 ClickSend MCP。

用途

ClickSend MCP 旨在将 ClickSend 的消息功能扩展到现代 AI 生态系统和平台中，让开发者无需编写自定义代码即可轻松通过 ClickSend 发送 SMS。

这能加速普及、支持新的 AI 驱动用例，并使 ClickSend 成为智能自动化时代面向未来的消息平台。

要求

• Node.js >= 18
  • 可以使用nvm（Node Version Manager）设置运行此应用所需的版本

安装

下载一个 AI 桌面客户端。例如，可以下载 Claude for Desktop，点击**此处**获取。

配置

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

• CLICKSEND_USERNAME：你的 ClickSend 用户名
• CLICKSEND_API_KEY：你的 ClickSend API 密钥

注册 ClickSend 后，可在 https://dashboard.clicksend.com/account/subaccounts 找到用户名和密钥。

Claude Desktop 配置

• 打开 Claude for Desktop

• 在系统菜单栏中打开设置

• 在设置窗口中，转到开发者选项卡，然后点击编辑配置。 这会打开位于以下路径的配置文件：

  • macOS：~/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 与此服务交互的一些自然方式：

简单 SMS：

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

功能

• 设置 ClickSend 用户名和 API 密钥后，每次发送一条 SMS
• 获取向联系人列表发送消息的价格
• 搜索联系人或联系人列表，并向其发送消息
• 获取 SMS 模板并使用模板发送消息
• 查看/检索 SMS 历史记录
• 获取最近 30 天的 SMS 统计信息

支持的 API

1. POST /v3/sms/send

• 操作 ID： send-sms
• **摘要：**发送 SMS
• **描述：**向收件人发送消息，收件人可以是电话号码，也可以是联系人列表中的联系人。

2. POST /v3/sms/price

• 操作 ID： calculate-sms-price
• **摘要：**计算 SMS 价格
• **描述：**根据消息类型和长度计算发送消息的价格。

3. GET /v3/sms/templates

• 操作 ID： view-sms-templates
• **摘要：**查看 SMS 模板
• **描述：**检索 SMS 模板，并提供筛选选项。

4. GET /v3/sms/history

• 操作 ID： view-sms-history
• **摘要：**查看 SMS 历史记录
• **描述：**查看之前发送的 SMS，并提供筛选和分页选项。

5. GET /v3/statistics/sms

• 操作 ID： view-sms-statistics
• **摘要：**查看 SMS 统计信息
• **描述：**获取最近 30 天的 SMS 统计信息。

6. GET /v3/search/contacts-lists

• 操作 ID： view-contact-lists
• **摘要：**查看联系人列表
• **描述：**获取搜索到的联系人列表。

重要说明

1. 电话号码格式：所有电话号码都必须采用 E.164 格式（例如，+61411111111）
2. 速率限制：请注意 ClickSend 账户的速率限制和定价
3. 安全性：妥善保管 ClickSend 凭据，切勿将其提交到版本控制系统

故障排除

常见错误消息及解决方案：

1. “电话号码必须采用 E.164 格式”

   • 确保电话号码以“+”和国家代码开头

2. “凭据无效”

   • 仔细检查 CLICKSEND_USERNAME 和 CLICKSEND_API_KEY。可以从 ClickSend Dashboard 复制这些信息

贡献

欢迎贡献！提交拉取请求前，请先阅读我们的贡献指南。

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

安全

请勿在 GitHub issue 或拉取请求中包含任何敏感信息（例如电话号码或 ClickSend 凭据）。