Peach Whatsapp Business Api Mcp

@peachai/mcp

面向 Peach WhatsApp 消息平台的 MCP（Model Context Protocol）服务。让 Claude 等 AI 助手直接通过你的 Peach 账户发送消息、管理模板、联系人和媒体。

要求

• Node.js 18 或更高版本
• Peach 账户和 API 密钥

获取 API 密钥

登录 app.trypeach.ai，前往 Settings → API，然后复制你的 API 密钥。

设置

托管服务设置

推荐 Peach 提供托管 MCP 服务。我们建议使用此服务。

{
  "mcpServers": {
    "peach": {
      "url": "https://app.trypeach.ai/api/mcp",
      "headers": {
        "Authorization": "<YOUR PEACH API KEY>"
      }
    }
  }
}

Claude Desktop

将以下内容添加到你的 claude_desktop_config.json：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "peach": {
      "command": "npx",
      "args": ["-y", "@peachai/mcp"],
      "env": {
        "PEACH_API_KEY": "your-api-key"
      }
    }
  }
}

重启 Claude Desktop。你应该会在对话中看到可用的 Peach 工具。

Cursor

前往 Settings → MCP 并添加：

{
  "peach": {
    "command": "npx",
    "args": ["-y", "@peachai/mcp"],
    "env": {
      "PEACH_API_KEY": "your-api-key"
    }
  }
}

Claude Code

运行此命令，将 Peach AI 添加到你的 Claude Code 设置中：

claude mcp add --scope user --env PEACH_API_KEY=your-api-key peach -- npx -y @peachai/mcp

或者手动将其添加到你的 .mcp.json：

{
  "mcpServers": {
    "peach": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@peachai/mcp"],
      "env": {
        "PEACH_API_KEY": "your-api-key"
      }
    }
  }
}

Antigravity

前往 Antigravity 设置 -> Customizations。点击 Open MCP Config 并添加以下内容：

{
  "mcpServers": {
    "peach": {
      "serverUrl": "https://app.trypeach.ai/api/mcp",
       "headers": {
        "Authorization": "<YOUR PEACH API KEY>"
      }
    }
  }
}

可用工具

消息发送

工具	说明
peach_send_template_message	向联系人发送 WhatsApp 模板消息
peach_send_app_message	触发流程或由应用发起的消息
peach_connect_to_ai_agent	发送模板并将联系人连接到 AI Agent
peach_get_event_status	检查已发送事件的状态
peach_list_template_messages	按筛选条件列出已发送的模板消息

群发

工具	说明
peach_launch_broadcast	创建并启动群发活动

模板

工具	说明
peach_list_templates	列出所有 WhatsApp 模板
peach_get_template	按 ID 或名称获取指定模板
peach_create_template	创建新的 WhatsApp 模板
peach_update_template	更新现有模板
peach_submit_template	提交模板以供 Meta 审核
peach_pause_template	暂停已批准的模板
peach_archive_template	归档模板

联系人

工具	说明
peach_create_contact	创建或写入单个联系人
peach_create_contacts	批量创建或写入联系人
peach_update_contact	按电话号码更新联系人

媒体

工具	说明
peach_list_media	列出已上传的媒体文件
peach_upload_media	上传媒体文件（base64）
peach_delete_media	删除媒体文件

消息

工具	说明
peach_list_messages	按可选筛选条件列出消息

示例提示词

• "向 +14155552671 发送 order_confirmation 模板，订单 ID 为 12345"
• "创建一个名为 summer_sale 的新 MARKETING 模板，正文写着“本周末享受 8 折优惠！”"
• "列出我所有已批准的 WhatsApp 模板"
• "将联系人 +14155552671 的姓名更新为 John Smith"
• "使用模板 promo_v2 向受众列表 abc123 发起群发"