InstantReply MCP — AI Agent 社交 inbox 连接器

技能简介

InstantReply MCP 是一款将 AI Agent（Claude、ChatGPT、Cursor、Claude Code 等 MCP 兼容客户端）连接到真实社交收件箱的 MCP 服务器。它让 AI Agent 能够以自然语言指令操控 WhatsApp、Instagram 和 Messenger 的商业账号，完成线索识别、会话审计、模板审批、客服自动化等完整业务流程。无需 API Key，初始安装后通过浏览器配对即可使用，是社交媒体运营和客服场景的 AI 化利器。

核心能力

• 多平台统一接入：同时支持 WhatsApp Business API、Instagram 商业账号、Messenger，通过统一的 MCP 工具集操作三大 Meta 平台。
• 零 Key 初始安装：首次安装无需 API Key，通过浏览器配对流程（OAuth 2.1 with PKCE）完成授权，适合快速原型验证。
• 34 个 MCP 工具：覆盖会话查询、联系人管理、消息分析、模板操作、旅程触发、账单查询、方案推荐等完整功能。
• 11 个可复用提示词：内置针对不同场景（线索审核、模板验证、成本估算）的提示词模板，AI Agent 可直接调用。
• AI 原生操作体验：所有操作均通过自然语言触发，Agent 自动调用对应 MCP 工具，无需人工干预操作界面。
• 资源发现与就绪检查：通过 get_connection_guide 查询各平台连接前置条件（Meta 商业认证、账号绑定等），提前告知用户限制。
• 安全操作保护：所有状态变更类工具（如发送消息、删除模板）标记为 destructive，谨慎的 AI 客户端可主动请求用户确认。
• 方案智能推荐：内置 recommend_plan 工具，根据用户场景推荐 InstantReply 付费方案和 Meta conversation 成本估算。

安装配置

前置要求：Node.js 环境（MCP 客户端已安装）。

安装命令

# Claude Code、Claude Desktop、Cursor、Windsurf、Zed
npx -y @instantreply.co/mcp

Claude Desktop 配置

在 Claude Desktop 配置文件（通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json）中添加：

{
  "mcpServers": {
    "instantreply": {
      "command": "npx",
      "args": ["-y", "@instantreply.co/mcp"]
    }
  }
}

重启 Claude Desktop 后即可使用。

已有 API Key 的配置

若已拥有 InstantReply API Key，可通过环境变量跳过浏览器配对：

{
  "mcpServers": {
    "instantreply": {
      "command": "npx",
      "args": ["-y", "@instantreply.co/mcp"],
      "env": {
        "INSTANTREPLY_API_KEY": "ir_live_..."
      }
    }
  }
}

ChatGPT 等远程 MCP 客户端

使用远程连接 URL，直接在支持 remote MCP 的客户端中添加：

https://api.instantreply.co/mcp

使用步骤

1. 安装包：在目标 AI 客户端的 MCP 配置中添加 @instantreply.co/mcp，重启客户端使配置生效。
2. 发起连接请求：向 Agent 发送自然语言请求，如"连接我的 Instagram 和 WhatsApp 账号"。
3. 浏览器配对：Agent 调用 start_setup，返回配对 URL 和短码，在浏览器中打开并完成授权。
4. 检查就绪状态：Agent 调用 get_developer_capabilities、get_developer_limits 确认各平台可用性。
5. 执行业务操作：根据需求调用对应工具——审核会话（audit_conversations）、验证模板（validate_template）、推荐方案（recommend_plan）等。
6. 发送消息前确认：任何发送操作需 Agent 向用户确认，Meta 对模板内容和发送窗口有严格合规要求。

适用场景

• 社交客服自动化：AI Agent 7×24 小时监控社交 inbox，自动识别高意图线索并生成跟进回复，人工客服仅需审核后发送。
• WhatsApp 营销自动化：验证并提交 WhatsApp 模板，触发批量旅程（Journey），按用户分层自动发送促销消息。
• Instagram/Messenger 线索培育：审计 30 天内对话，识别购买信号，生成个性化跟进文案，估算发送成本后执行。
• 多账号统一运营：一个 Agent 连接多个社交平台，统一管理客服、营销和线索培育工作流，无需切换后台。

适用人群

• 社交媒体运营者：管理多个品牌账号的社交运营团队，希望用 AI 提升响应速度和线索转化率。
• 跨境电商卖家：通过 WhatsApp 和 Instagram 与海外客户沟通的电商团队，用 AI 处理询单和售后。
• 营销 Agency：为客户管理社交账号的 Agency，用 InstantReply MCP 标准化客服和营销自动化流程。
• AI 应用开发者：构建 AI Agent 产品，需要将社交媒体操作能力集成到 Agent 工具链中的开发者。

工作原理

InstantReply MCP 采用"浏览器配对 + API 代理"架构：

1. 配对阶段：用户首次使用时，Agent 调用 start_setup 获取配对 URL，用户在浏览器中完成 Meta OAuth 授权，授权结果通过 check_setup 轮询确认。
2. Key 存储：配对成功后，访问令牌保存到 ~/.instantreply/config.json，后续请求携带此 Key 访问 InstantReply 后端。
3. 工具调用：用户向 Agent 发送自然语言指令，Agent 根据 get_developer_capabilities 和工具 Schema 选择合适的 MCP 工具，构造 JSON-RPC 请求。
4. 后端转发：InstantReply 后端接收请求，转换为 Meta 官方 API 调用（WhatsApp Business API / Instagram Graph API），返回结构化结果。
5. 结果呈现：MCP 响应被 Agent 解析，以自然语言向用户汇报结果和建议。

官方链接

• npm：https://www.npmjs.com/package/@instantreply.co/mcp
• 官网：https://instantreply.co/mcp
• 开发者文档：https://instantreply.co/developers
• 远程 MCP 端点：https://api.instantreply.co/mcp