Skip to main content

​
概览

Nudgen 在应用来源的 /mcp 端点托管 MCP 服务器。该服务器通过 Streamable HTTP 使用 MCP 2026-07-28，并要求 OAuth 2.1。请连接支持此传输方式的客户端。在浏览器中登录 Nudgen，选择一个工作区，并批准客户端请求的权限。即使你之后在仪表盘中切换工作区，该连接仍会绑定到原先选择的工作区。

​
为什么这很重要

你的助手无需处理仪表盘会话或个人访问令牌，即可读取联系人和活动、查找附近商家、起草内容，以及准备启动活动。每次实际发送或排期都必须由你在浏览器中审核后才能继续。

​
连接客户端

生产环境端点为：
在支持 OAuth 的客户端中，将其添加为远程 HTTP MCP 服务器。客户端会从该端点发现 Nudgen 的授权服务器，并在浏览器中打开登录和授权流程。选择你希望客户端访问的工作区，并且只批准其需要的权限范围。 发现文档： 授权服务器使用带 PKCE S256 的授权码流程、资源绑定和刷新令牌轮换。它接受客户端 ID 元数据文档和动态客户端注册。 对于 Codex CLI，请使用：
如果已经配置名为 nudgen 的客户端，请将该条目的 URL 更新为 /mcp。 如果只需查看数据，请请求 campaigns:read。如果客户端需要更改联系人、草稿、品牌设置或已导入的潜在客户，请添加 campaigns:write。只有当客户端需要请求活动启动批准时，才添加 campaigns:send。
个人访问令牌用于验证开发人员 API，但不能用于验证 /mcp。MCP 客户端必须完成 OAuth 登录。

​
可用工具

create_campaign 会保存一个活动草稿（one-time、drip 或 lifetime），不能直接发送或排期。通过 get_campaign，你可以在启动前检查主题、内容、链接、受众和发件人。 服务器还通过 campaigns:read 提供只读资源：

​
查找并导入地图潜在客户

  1. 让助手使用地点和商家关键词调用 search_map_leads，例如某个城市和 marketing agency。
  2. 可选筛选条件包括 radiusKm（1–100）、lat、lng，以及仅保留公开邮箱商家的 emailOnly。
  3. 如果结果包含 nextPageToken，请将其作为 pageToken 传入以加载下一页。
  4. 让助手使用相同的地点和关键词调用 import_map_leads，并附上要保存的潜在客户对象。每次调用最多接受 200 个潜在客户。
导入操作会在已连接的工作区中写入联系人。没有邮箱的潜在客户会被跳过；已经存在的潜在客户会被更新。

​
批准活动启动

  1. 让助手通过 get_campaign 检查草稿。
  2. 让助手使用活动 ID 以及你指定的立即发送时间或确切排期时间调用 prepare_campaign_launch。该调用会返回一次性批准 URL，此时尚未发送任何邮件。
  3. 打开该 URL，检查工作区、预计收件人数、内容、发件人和发送时间，然后点击批准启动。
  4. 返回客户端，让它使用相同的活动 ID、发送时间和 approvalId 调用 launch_campaign。
批准将在 10 分钟后过期，并且只能使用一次。如果活动或发件人发生变化，请请求新的批准。启动时，Nudgen 会再次检查发件人就绪状态、符合条件的收件人、订阅、配额和队列可用性。只有活动工作进程处理启动任务后，邮件才会开始投递。
批准并完成 launch_campaign 可能会发送真实邮件。在批准向真实受众发送前，请先使用仪表盘中的测试发送流程检查收件箱预览。

​
管理访问权限

打开设置 → API 密钥 → 已连接的 MCP 应用，查看每个已连接客户端的工作区和权限范围。如果某个连接不应再拥有访问权限，可在此将其撤销。撤销后，其令牌和待处理的活动启动批准都会失效。之后你仍可通过 OAuth 重新连接。 OAuth 授权最长有效 90 天。如果你失去某个工作区的访问权限，客户端也将无法继续使用该工作区的连接。

​
故障排除

如需在脚本中使用 Bearer 令牌和直接 REST 端点，请参阅开发人员 API。

​
搜索半径与信息补充

API和MCP默认使用5 km，接受整数 radiusKm 1–100，不显示仪表板确认对话框。将 nextPageToken 作为 pageToken 传递时保持搜索参数不变。空页面仍可能有下一页。 enrichmentPending表示网站调查尚未完成。查看可用的 businessSummary 和 businessSources。导入的企业背景可帮助个性化营销活动的开场内容。没有邮箱可能是调查仍在等待完成。 收到 enrichmentRetryToken 时，使用 campaigns:read 权限调用 retry_map_leads_enrichment 并传入 token。令牌绑定已连接的工作空间，15分钟后过期，只能使用一次。导入前按 placeId 合并结果。emailOnly筛选当前响应；重试后可能出现更多潜在客户。

​
编辑草稿与功能覆盖

使用 update_campaign 编辑现有草稿，使用 delete_campaign 删除草稿。两者均需要 campaigns:write，不会发送或安排邮件。新增产品领域需要独立的 OAuth 权限。收到提示时，请重新连接并批准这些权限。 工具列表提供可用工具及其参数。跳转浏览器不会执行操作：请在浏览器中完成付款、提供商授权、发送邀请、切换工作区及敏感收款设置。MCP 连接始终绑定到已授权的工作区。管理功能、凭据、Webhook、跟踪回调和内部助手不在范围内。 使用 get_api_capabilities 查看 API 覆盖范围。测试发送、lifetime 激活或 lifetime 事件需要先通过 prepare_campaign_action 请求浏览器批准，再以相同参数调用 send_test_email、activate_lifetime_campaign 或 trigger_lifetime_campaign。批准十分钟后失效，且只能使用一次。