SendSeven Messaging

SendSeven MCP 服务

这是 SendSeven 官方的 Model Context Protocol（MCP）服务。SendSeven 是一个统一的消息 API 平台，支持 WhatsApp、Instagram 私信、Telegram、SMS、Messenger、Live Chat 和 Email。

将 SendSeven 账户连接到 Claude、ChatGPT、Gemini、Cursor 或任何兼容 MCP 的 AI 助手，即可管理统一收件箱、发送全渠道消息（WhatsApp、Instagram 私信回复、Telegram、SMS、Messenger、Email）、运行营销活动、组建团队聊天机器人，并通过自然语言搜索知识库——所有操作均通过现有的客户支持和消息 API 平台完成。

快速开始

选项 1：远程服务（推荐）

无需安装。添加到 AI 客户端：

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "sendseven": {
      "url": "https://mcp.sendseven.com/mcp",
      "auth": {
        "type": "oauth2",
        "authorizationUrl": "https://mcp.sendseven.com/authorize",
        "scopes": ["conversations:read", "messages:create", "contacts:read"]
      }
    }
  }
}

Claude Code（.claude/settings.json）：

{
  "mcpServers": {
    "sendseven": {
      "url": "https://mcp.sendseven.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

ChatGPT（Settings > Connectors > Add custom connector）：

MCP Server URL: https://mcp.sendseven.com/mcp
Authentication: OAuth

ChatGPT 会自动引导你完成 OAuth 授权确认和功能选择器设置——无需配置文件。

选项 2：API Token（开发者设置）

开发者和 CI/CD 流水线可使用静态 API Token：

1. 在 SendSeven 中生成 API Token：Settings > API Tokens
2. 在 MCP 客户端中将 Token 配置为 Bearer 标头

选项 3：可自托管

git clone https://github.com/SendSeven-GmbH/sendseven-mcp-server.git
cd sendseven-mcp-server
npm install
npm run dev  # Runs on localhost:8787

可以做什么？

支持运营

• “显示未结束的会话” - 列出并筛选会话
• “John 的会话是关于什么的？” - 查看会话详情
• “用备注‘已退款’关闭工单 #123” - 关闭会话
• “将这个分配给 Sarah” - 分配给团队成员

消息

• “给 +49 170 1234567 发送 WhatsApp 消息：您的订单已准备就绪” - 多渠道消息
• “给 [email protected] 发邮件，告诉他会议的事” - 自动检测最佳渠道
• “查找所有 VIP 客户” - 搜索联系人

营销

• “创建一条关于限时促销的推送通知活动” - 创建营销活动
• “向企业客户名单发送电子邮件简报” - 电子邮件营销活动
• “WhatsApp 营销活动要花多少钱？” - 费用估算

知识库

• “我们的 FAQ 关于退款是怎么说的？” - AI 驱动的知识库搜索
• “如何设置 WhatsApp 集成？” - 自助解答

可用工具

工具根据 OAuth 连接期间选择的功能进行注册。下表按功能对工具进行分组，以便阅读；OAuth 授权页面会将相同的 45 个工具分为 8 个较宽泛的功能组（对话、消息、电子邮件、联系人、营销活动、知识库、Webhook、团队聊天机器人）——授权某个组即会授予该组下方列出的所有工具。完整的参数参考：docs/TOOLS.md。

类别	工具
对话	list_conversations, get_conversation, send_reply, close_conversation, reopen_conversation, snooze_conversation, assign_conversation, add_internal_note, email_conversation_transcript, get_attachment_summary
消息	send_message_to_contact, send_whatsapp_template, send_email, upload_attachment
联系人	search_contacts, create_contact, update_contact
标签	list_tags, create_tag, tag_conversation, untag_conversation, tag_contact, untag_contact
营销活动	list_contact_lists, list_campaigns, get_campaign_status, create_and_send_campaign, list_email_campaigns, get_email_campaign_analytics
知识库	query_knowledge_base, list_knowledge_base_folders
渠道	list_channels, list_email_mailboxes, list_verified_email_domains, list_whatsapp_templates, get_whatsapp_template
团队	list_team_members, set_out_of_office, end_out_of_office
团队聊天机器人	list_team_chat_channels, send_team_chat_channel_message, send_team_chat_direct_message
Webhook（开发者）	list_webhooks, create_webhook, delete_webhook

身份验证

OAuth 2.0 + PKCE（推荐）

该服务是面向 MCP 客户端的完整 OAuth 2.0 授权服务，支持动态客户端注册（DCR），因此无需预先注册应用：

端点	URL
MCP 端点	https://mcp.sendseven.com/mcp（Streamable HTTP）
授权	https://mcp.sendseven.com/authorize
令牌	https://mcp.sendseven.com/token
动态客户端注册	https://mcp.sendseven.com/register

大多数 MCP 客户端（Claude、Cursor 等）会自动从 https://mcp.sendseven.com/mcp 发现这些信息，只需要基础 URL——请参阅上方的 claude-desktop.json 示例和 examples/ 目录。 对于需要明确列出授权流程的客户端：

1. 客户端通过 DCR（POST /register）注册自身，并获取 client_id。
2. 客户端携带 PKCE code_challenge 和所请求的作用域，将用户引导至 /authorize。
3. 用户使用 SendSeven 账号登录，并在授权页面批准所请求的作用域。
4. 使用 PKCE code_verifier 在 /token 兑换授权码，获取访问令牌和刷新令牌。
5. 每次 MCP 请求都会将访问令牌作为 Bearer 令牌发送；服务会使用刷新令牌自动刷新访问令牌。

用户只能授予其 SendSeven 角色已有权限的作用域——没有营销活动权限的支持专员无论客户端请求什么，都不会看到营销活动工具。

API 令牌（开发者）

在 SendSeven 控制面板中生成令牌（Settings > API Tokens），并将其作为 Bearer 标头传递——这对 CI/CD 和脚本而言更简单，但不会自动刷新，必须手动轮换。

Claude 技能

此代码库包含工作流指南（Skills），用于向 AI 助手介绍最佳实践：

• 营销活动创建 - 分步营销活动工作流
• 对话管理 - 分类处理、回复并解决问题
• 联系人消息 - 查找联系人并向其发送消息
• 团队聊天机器人 - 向 Team Chat 频道和用户发送机器人消息

配置示例

配置文件请参阅 examples/ 目录：

• claude-desktop.json - Claude Desktop
• claude-code.json - Claude Code CLI
• cursor.json - Cursor IDE

定价

所有 SendSeven 客户均可免费使用。 每个套餐均包含 MCP 服务访问权限。

• 读取操作：不限量（受速率限制约束）
• 写入操作：按常规 API 用量计费
• 速率限制：根据套餐不同，为 20-500 req/min

开发

# Install dependencies
npm install

# Run locally
npm run dev

# Run tests
npm test

# Type check
npm run typecheck

# Deploy to Cloudflare Workers
npm run deploy

安全

• 使用 OAuth 2.0 和 PKCE（浏览器中无需客户端密钥）
• 所有令牌均经过静态加密
• 基于作用域的访问控制（27 个细粒度 OAuth 作用域，分为 8 个能力组以供授权）
• 租户隔离（禁止跨租户访问数据）
• 按套餐实施速率限制
• 可通过 SendSeven 设置撤销令牌

许可证

MIT - 参见 LICENSE

链接

• SendSeven - 统一消息 API
• MCP Specification - Model Context Protocol
• API Documentation - SendSeven REST API