Instagram MCP Server（也支持 WhatsApp 和 Messenger）

一个 MCP 服务器，让 Claude、Cursor、Claude Code 以及任何其他 MCP 客户端都能读取和回复 Instagram 私信、WhatsApp 消息和 Facebook Messenger 会话，全程通过官方 Meta Business API 完成。

你可以让你的助手 “找到那位在 Instagram 上询问价格的潜在客户，并把预约模板发送给他”，这个操作会在真实账号上直接完成。

它为什么与众不同

大多数 Instagram 和 WhatsApp MCP 服务器驱动的是个人账号：它们依靠浏览器自动化会话、非官方桥接，或者逆向工程的移动端 API。一旦 Meta 有所变动，它们就会失效，还会让账号面临被封禁的风险。

本项目通过 SetSmart 的 Meta 批准企业应用（Meta-approved Business app），连接的是官方 Instagram Messaging API、WhatsApp Cloud API 和 Messenger Platform。没有已经 Meta 批准的应用，你就无法以编程方式在 Instagram、WhatsApp 或 Messenger 上收发消息——这正是这个桥接需要一个 SetSmart 工作区，而不是你的 Instagram 密码的原因。

说白了，这就是权衡：它不能针对你自己的个人账号，需要 SetSmart API 密钥。

Requirements

• Node.js 18 或更高版本

• SetSmart 工作区，且至少已连接一个渠道（Instagram、WhatsApp 或 Messenger）

• 你的工作区 API 密钥，可以从 Settings（设置）→ Integrations（集成）中获取

快速开始

Claude Desktop / Claude Code

把以下配置添加到你的 MCP 配置文件中（claude_desktop_config.json；Claude Code 使用 .mcp.json）：

{
  "mcpServers": {
    "setsmart": {
      "command": "npx",
      "args": ["-y", "github:setsmart-git/instagram-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 个工具，按它们控制的对象分组。

消息 Messaging

会话（Conversations）

联系人（Contacts）

AI 控制

Instagram

定时发送、模板与统计

它明确不做的事

API 密钥是长期有效的静态密钥，因此只提供了受限的操作面。下面这些能力只能通过远程服务器上的交互式 OAuth 完成，并不会通过这个桥接公开发布：

• 计费和订阅变更

• 工作区设置

• 连接或断开渠道

• 创建或改写 AI 助手

• 批量删除、黑名单名、被屏蔽国家

如果你在 SetSmart 设置中更换了这个密钥，从下一个请求开始，它就会立即失效，之前授予的访问权限也会被撤销。

配置

工作原理

这个包本身不包含任何消息处理逻辑。它是一个从 stdin 到 Streamable HTTP 的请求转发通道：你的客户端通过 stdin/stdout 走 MCP 协议，桥接层会将每个请求转发到托管的 SetSmart MCP 服务器，在 Authorization 头中携带你的 API 密钥，并把回复流式传回来。代码只有大约 150 行，放在 src/index.js 里，所以你在把自己的真实账号交给它之前，可以完整读一遍。

链接

• SetSmart

• REST API 文档

• Model Context Protocol

许可证

MIT