SetSmart

Instagram MCP 服务（也支持 WhatsApp 和 Messenger）

一个 MCP 服务，可通过 Meta 官方商务 API，让 Claude、Cursor、Claude Code 以及任何其他 MCP 客户端读取并回复Instagram 私信、WhatsApp 消息和 Facebook Messenger 对话。

让你的助手“找出在 Instagram 上询问价格的潜在客户，并向他们发送预约模板”，它就会在真实账号上完成操作。

它有何不同

大多数 Instagram 和 WhatsApp MCP 服务都会操作个人账号：通过浏览器自动化会话、非官方桥接，或逆向工程的移动 API。Meta 一旦更改内容，这些服务就会失效，还可能导致账号被停用。

本服务通过 SetSmart 获得 Meta 认证的商务应用，使用官方 Instagram Messaging API、WhatsApp Cloud API 和 Messenger Platform。若没有经过认证的应用，就无法以编程方式在 Instagram、WhatsApp 或 Messenger 上发送消息，因此此桥接需要 SetSmart 工作区，而不是你的 Instagram 密码。

坦诚地说，这就是其中的取舍：它无法针对你自己的账号进行自托管，而且需要 SetSmart API 密钥。

要求

• Node.js 18 或更高版本
• 一个已连接至少一个渠道（Instagram、WhatsApp 或 Messenger）的 SetSmart 工作区
• 你的工作区 API 密钥，可在 Settings 中的 Integrations 页面找到

快速开始

Claude Desktop / Claude Code

将以下内容添加到 MCP 配置中（Claude Desktop 使用 claude_desktop_config.json，Claude Code 使用 .mcp.json）：

{
  "mcpServers": {
    "setsmart": {
      "command": "npx",
      "args": ["-y", "setsmart-mcp"],
      "env": {
        "SETSMART_API_KEY": "your-workspace-api-key"
      }
    }
  }
}

Cursor

将相同内容添加到 ~/.cursor/mcp.json 中。

远程 MCP，无需此桥接

SetSmart MCP 服务也可以通过带 OAuth 的 Streamable HTTP 直接访问，因此支持远程 MCP 的客户端可以完全跳过此软件包：

https://setsmart.io/api/mcp

如果你的客户端只支持 stdio，或者你更愿意使用静态 API 密钥而非交互式 OAuth 授权，请使用此桥接。

工具

共有 30 个工具，按操作对象分组。

消息

工具	功能
message_send_text	在 Instagram、WhatsApp 或 Messenger 上发送文本消息
message_send_image	发送图片
message_send_video	发送视频
message_send_audio	发送语音消息
message_send_template	发送已获批准的 WhatsApp 模板
message_send_reaction	对消息作出回应

对话

工具	功能
conversation_list	列出工作区中的对话
conversation_search	按名称、号码或内容搜索对话
conversation_get	读取一段对话及其状态
conversation_get_messages	读取消息历史记录
conversation_add_tag	为对话添加标签
conversation_remove_tag	移除标签
conversation_set_notes	写入内部备注

联系人

工具	功能
contact_find	按电话、电子邮件、Instagram 用户名或标签查找联系人
contact_get	读取单个联系人
contact_import	创建联系人
contact_add_tags	添加标签
contact_remove_tags	移除标签

AI 控制

工具	功能
ai_get_all_status	查看 AI 助手在哪些位置处于启用状态
ai_pause_conversation	暂停某段对话中的助手，以便转交给人工处理
ai_resume_conversation	将对话交还给助手
ai_pause_channel	暂停整个渠道
ai_resume_channel	恢复渠道

Instagram

工具	功能
instagram_post_list	列出账号的帖子
instagram_post_get_triggers	读取帖子上的评论触发条件
comment_reply_get_auto_reply	读取自动评论回复设置

排期、模板和统计数据

工具	功能
scheduled_list	列出已排期但尚未发送的消息
scheduled_cancel	取消已排期的消息
template_list	列出消息模板
analytics_stats	查看对话和回复统计数据

它刻意不提供的功能

API 密钥是长期有效的静态机密，因此其权限范围受到限制。以下操作只能通过远程服务上的交互式 OAuth 完成，不能通过此桥接服务进行：

• 账单和订阅变更
• 工作区设置
• 连接或断开频道
• 创建或改写 AI 助手
• 批量删除、黑名单、屏蔽国家/地区

在 SetSmart 设置中轮换密钥后，访问权限会立即撤销，并在下次请求时生效。

配置

变量	默认值	用途
SETSMART_API_KEY	required	您的工作区 API 密钥
SETSMART_MCP_URL	https://setsmart.io/api/mcp	覆盖上游端点

工作原理

此软件包不包含任何消息处理逻辑。它是一个从 stdio 到 Streamable HTTP 的管道：您的客户端通过 stdin 和 stdout 使用 MCP 通信，桥接服务在 Authorization 标头中附上您的密钥，将每个请求转发到托管的 SetSmart MCP 服务，并将响应流式传回。代码约 150 行，位于 src/index.js，因此您可以在信任它处理账户之前通读全部代码。

链接

• SetSmart
• REST API 文档
• Model Context Protocol

许可证

MIT