mcp-zenvia

@codespar/mcp-zenvia

Zenvia 的 MCP 服务——多渠道消息传递（SMS、WhatsApp、RCS）

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "zenvia": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-zenvia"],
      "env": {
        "ZENVIA_API_TOKEN": "your-token"
      }
    }
  }
}

Claude Code

claude mcp add zenvia -- npx @codespar/mcp-zenvia

Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "zenvia": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-zenvia"],
      "env": {
        "ZENVIA_API_TOKEN": "your-token"
      }
    }
  }
}

工具（18 个）

工具	用途
send_sms	发送 SMS 消息
send_whatsapp	发送 WhatsApp 消息
send_rcs	发送 RCS（富通信服务）消息
send_email	发送事务性电子邮件
send_voice	通过 TTS 或预录音频 URL 发送语音消息
send_facebook_message	发送 Facebook Messenger 消息
get_message_status	根据 ID 获取消息投递状态
list_channels	列出可用的消息渠道
create_subscription	创建消息事件的 webhook 订阅
list_subscriptions	列出所有 webhook 订阅
delete_subscription	根据 ID 删除 webhook 订阅
list_contacts	列出联系人库中的联系人
create_contact	在联系人库中创建联系人
delete_contact	根据 ID 删除联系人
send_template	发送 WhatsApp 模板消息（预先批准）
list_templates	列出已批准的消息模板（WhatsApp/SMS/RCS）
get_report_entries	获取指定日期范围内的消息报告条目
add_opt_out	将电话号码添加到退订列表（阻止后续消息）

身份验证

Zenvia 使用通过 X-API-TOKEN 标头传递的 API 令牌。

沙盒 / 测试

Zenvia 提供通过控制面板访问的沙盒，用于测试消息。

获取凭据

1. 前往 Zenvia
2. 创建账户
3. 从控制面板获取 API 令牌
4. 设置 ZENVIA_API_TOKEN 环境变量

环境变量

变量	必填	描述
ZENVIA_API_TOKEN	是	从 Zenvia 控制面板获取的 API 令牌

路线图

v0.2（计划中）

• create_contact_list — 为营销活动创建联系人列表
• send_batch — 向联系人列表批量发送消息
• get_report — 获取消息投递报告
• create_flow — 创建对话流程
• list_templates — 列出已批准的消息模板

v0.3（计划中）

• chatbot_integration — 与 Zenvia 聊天机器人构建器集成
• analytics_dashboard — 获取渠道分析数据和指标

想要参与贡献？提交 PR 或申请工具。

链接

• Zenvia 网站
• Zenvia API 文档
• MCP Dev LATAM
• 落地页

企业版

需要为 Agent 付款添加治理、预算限制和审计跟踪？CodeSpar Enterprise 可在这些 MCP 服务之上添加策略引擎、付款路由和合规模板。

许可证

MIT