Attentive MCP Server

什么是 Attentive MCP Server？

Attentive MCP 服务器将你自己的 AI 助手（例如 Claude 或 ChatGPT Codex）连接到你的 Attentive 账户，让它可以获取报表、起草和编辑短信、RCS、邮件和推送活动，并构建旅程和细分人群。这是 Attentive 官方托管的服务器，目前处于测试阶段。

Attentive 是一个面向短信、邮件和其他消息渠道的营销平台。它的 MCP 服务器本身不是 AI：它是一组受管控的工具（最多 74 个），由你的助手调用，权限范围与你在 Attentive 界面中能做的事情一致。Attentive 的产品内代理（如 Reporting Agent）仍然独立存在；MCP 服务器是连接你的外部 AI 工具和跨平台工作流的扩展入口。

如何使用 Attentive MCP Server？

前提条件：

1. 一个已为你的公司开启 MCP 测试权限的 Attentive 账户（如不确定，请咨询你的 Attentive 客户团队）。
2. 一个 MCP 客户端。测试版已在 Claude Code 和 ChatGPT Codex 上验证；其他支持带 OAuth 的远程 Streamable HTTP 服务器的客户端也可以连接。
3. 对你要使用的公司和功能具有相应的 Attentive 权限。

认证通过 Attentive 标准登录的 OAuth 完成：首次连接时，客户端会在浏览器中打开 Attentive 登录页面。你无需在配置文件中填写密码或 API 密钥。每个连接默认只读；在 URL 后追加 ?readOnly=false 即可启用写入工具。

Read only:     https://attentive-ui-mcp.attentivemobile.com/mcp
Read + write:  https://attentive-ui-mcp.attentivemobile.com/mcp?readOnly=false

Claude Code

claude mcp add --transport http attentive-mcp --scope user "https://attentive-ui-mcp.attentivemobile.com/mcp"

如需启用写入，请使用带 ?readOnly=false 的 URL。运行 /mcp，确认出现 attentive-mcp，并完成 Attentive 登录。

Claude Desktop

打开 Settings，进入 Connectors，选择 Add，然后选择 Add custom connector。输入名称（例如 Attentive MCP (Read only)）并粘贴上面的任一 URL；OAuth Client ID 和 Client Secret 字段留空。选择 Add，再点击 Connect，登录 Attentive 并批准所请求的权限。

Cursor

{
  "mcpServers": {
    "attentive": {
      "url": "https://attentive-ui-mcp.attentivemobile.com/mcp"
    }
  }
}

将其添加到 ~/.cursor/mcp.json；Cursor 会在浏览器中打开 Attentive 登录页面。

VS Code

{
  "servers": {
    "attentive": {
      "type": "http",
      "url": "https://attentive-ui-mcp.attentivemobile.com/mcp"
    }
  }
}

将其添加到 .vscode/mcp.json，启动服务器后登录。

Codex

codex mcp add attentive-mcp --url "https://attentive-ui-mcp.attentivemobile.com/mcp"
codex mcp login attentive-mcp

Attentive 还提供了 Codex 桌面应用和 Microsoft Copilot Studio（OAuth 2.0 动态发现）的配置说明。

Attentive MCP Server 的主要功能

• get_user、list_user_companies 和 switch_company 等账户工具，用于在你有权访问的多个公司之间切换工作。
• 通过 list_metrics、query_metrics 和 get_campaign_metrics 获取报表。
• 覆盖短信、RCS、邮件和推送的活动与消息：创建草稿、消息组和 A/B 变体，并安排、暂停和恢复发送。
• 旅程：读取结构和配置，创建旅程并编辑节点和分支。
• 细分人群：列出、创建、更新和删除细分人群并获取受众数量；list_segment_subscribers 会返回订阅者联系方式，需要写入模式。
• 邮件模板、创意素材、品牌套件和品牌语调设置。
• 默认只读；启用写入后，支持确认的客户端会在每次更改前请你确认。

Attentive MCP Server 的使用场景

• 每周报表：“总结上周短信和邮件活动的表现，并标出点击率最低的活动。”
• 起草活动：“用节日模板为我们的春季促销创建一个邮件活动草稿。”
• 检查旅程：“显示我们欢迎旅程的结构，并列出它的分支。”
• 构建细分人群：“创建一个过去 30 天有点击但未购买的订阅者细分。”
• 跨工具分析：“获取 3 月份的 Attentive 指标，方便我和广告投放表进行对比。”

Attentive MCP Server 常见问题排查

• 服务器没有出现。 检查是否使用了 Streamable HTTP 传输和正确的 URL，重启客户端并运行 /mcp；如有提示，请完成 Attentive 登录。
• 工具比预期少。 工具取决于你的权限、所选公司、已启用的产品和连接模式。确认测试权限，让助手执行 switch_company，或使用 ?readOnly=false 重新连接。
• 无法创建或编辑任何内容。 连接默认是只读的；请添加 ?readOnly=false。
• 写入操作没有生效。 在支持确认的客户端中，写入需要你确认；请批准确认提示。
• 会话过期。 重新连接并再次完成 OAuth；如果工具列表没有刷新，请重启客户端。