使用说明
单击发送MCP服务器
这是官方 单击发送MCP服务器 由ClickSend团队开发。出于安全原因,请勿使用非官方版本的ClickSend MCP。
目的
ClickSend MCP旨在将ClickSend的消息传递功能扩展到现代人工智能生态系统和平台中 -允许开发人员通过ClickSend轻松发送短信,而无需编写自定义代码。
这加速了采用,实现了新的人工智能驱动用例,并将ClickSend定位为智能自动化时代面向未来的消息传递平台。
需求
- Node.js>=18
- 你可以使用
nvm(节点版本管理器)设置运行此应用程序的正确版本
- 你可以使用
安装
下载AI桌面客户端。一个例子是Claude for Desktop,您可以下载 这里.
配置
服务器需要两个环境变量:
CLICKSEND_USERNAME:您的ClickSend用户名CLICKSEND_API_KEY:您的ClickSend API密钥
您可以在以下网址找到用户名和密钥https://dashboard.clicksend.com/account/subaccounts一旦您注册了ClickSend。
Claude桌面配置
-
打开Claude桌面版
-
首选 设置 从系统的菜单栏
-
在设置窗口中,导航到 开发者 选项卡并单击 编辑配置. 这将打开位于以下位置的配置文件:
-
macOS:
~/Library/Application Support/Claude/claude_desktop_config.json -
视窗:
%APPDATA%\Claude\claude_desktop_config.json
-
-
使用NPM包
{
"mcpServers": {
"clicksend": {
"command": "npx",
"args": [
"-y",
"@clicksend/clicksend-mcp-server@latest"
],
"env": {
"CLICKSEND_USERNAME": "<username>",
"CLICKSEND_API_KEY": "<api-key>"
}
}
}
}
- 使用本地构建
{
"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与服务器交互的一些自然方式:
简单短信:
Send a text message to the number 61411111111 saying "I'm using ClickSend MCP server to sent SMS!"
特性
- 通过设置clicksend用户名和API密钥,一次发送一条短信
- 获取向联系人列表发送消息的价格
- 搜索联系人或联系人列表并向他们发送消息
- 获取短信模板,并使用该模板发送消息
- 查看/检索短信历史记录
- 获取过去30天的短信统计信息
支持的API
POST /v3/sms/send
- 操作ID:
send-sms - 摘要: 发送短信
- 说明: 向收件人发送消息,可以是电话号码或联系人列表中的联系人。
POST /v3/sms/price
- 操作ID:
calculate-sms-price - 摘要: 计算短信价格
- 说明: 根据消息类型和长度计算发送消息的价格。
GET /v3/sms/templates
- 操作ID:
view-sms-templates - 摘要: 查看短信模板
- 说明: 使用筛选选项检索短信模板。
GET /v3/sms/history
- 操作ID:
view-sms-history - 摘要: 查看短信历史记录
- 说明: 查看以前发送的带有过滤和分页选项的短信。
GET /v3/statistics/sms
- 操作ID:
view-sms-statistics - 摘要: 查看短信统计信息
- 说明: 获取过去30天的短信统计数据。
GET /v3/search/contacts-lists
- 操作ID:
view-contact-lists - 摘要: 查看联系人列表
- 说明: 获取搜索到的联系人列表列表。
重要说明
- 电话号码格式:所有电话号码必须采用E.164格式(例如+6141111111)
- 速率限制:请注意您的ClickSend帐户的费率限制和定价
- 安全:确保您的ClickSend凭据安全,永远不要将其提交给版本控制
故障排除
常见错误消息和解决方案:
-
“电话号码必须采用E.164格式”
- 确保电话号码以“+”和国家代码开头
-
“凭据无效”
- 双击您的CLICKSEND_USERNAME和CLICKSEND-API_KEY。您可以从 单击发送仪表板
贡献
欢迎投稿!在提交pull请求之前,请阅读我们的贡献指南。
许可证
此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。
安全
请不要在GitHub issues或pull请求中包含任何敏感信息(如电话号码或ClickSend凭据)。