如何通过 MCP 将 Constant Contact 连接到 Gemini

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Constant Contact、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Constant Contact + Gemini

在任意 AI 智能体中使用 Constant Contact 账户：带邮件许可状态的联系人、列表、标签、自定义字段和细分，批量修改列表和标签，用你自己的 HTML 创建邮件营销活动并预览和发送测试，查看活动、链接和单个联系人的报告。通过 OAuth 登录使用 V3 API；排程发送和删除操作在安装时关闭。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

CONSTANT_CONTACT_CLIENT_ID、CONSTANT_CONTACT_CLIENT_SECRET（由 Authorize with Provider 自动填写：CONSTANT_CONTACT_REFRESH_TOKEN）

步骤 1 — 获取凭证

设置大约需要 10 分钟。你需要在 Constant Contact 开发者门户注册自己的应用，并用要连接的账户登录。

1. 打开 V3 开发者门户 https://app.constantcontact.com/pages/dma/portal，用该账户的 Constant Contact 登录信息登录。新应用是私有的：在 Constant Contact 批准之前，只有创建应用的用户才能授权它。
2. 点击 New Application 并命名（名称会显示在授权同意页面上）。选择 Authorization Code Flow and Implicit Flow，以及一种刷新令牌类型：Rotating Refresh Tokens（推荐）或 Long Lived Refresh Tokens。然后创建应用。
3. 通过 Edit 打开应用，添加 redirect URI <your AnythingMCP URL>/api/mcp-oauth/callback，在 AnythingMCP Cloud 上填写 https://cloud.anythingmcp.com/api/mcp-oauth/callback，逐字符一致。
4. 点击 Generate Client Secret。密钥只显示一次。保存应用。
5. 把应用的 API Key（即 OAuth 客户端 ID）粘贴到 CONSTANT_CONTACT_CLIENT_ID，把密钥粘贴到 CONSTANT_CONTACT_CLIENT_SECRET。CONSTANT_CONTACT_REFRESH_TOKEN 留空，然后安装。
6. 在连接器页面点击 Authorize with Provider 并登录 Constant Contact。连接器请求的 scope 为 account_read contact_data campaign_data offline_access（offline_access 用于获取刷新令牌）。
7. 运行 constant_contact_get_account_summary：它会显示组织信息并确认登录成功。

访问令牌有效期 24 小时，会通过刷新令牌自动续期。使用轮换刷新令牌时，每次续期都会返回新的刷新令牌，旧的随即失效，所以不要在其他地方使用已保存的令牌；使用长期刷新令牌时，同一个令牌一直有效。两种令牌在 180 天未使用后都会过期，届时请重新授权。AI 能做什么还取决于登录的 Constant Contact 用户的权限（constant_contact_get_user_privileges）。

可读取的内容：账户概要、账户的发件地址及其确认状态、已登录用户的权限。按邮箱、状态、列表、标签、细分或创建、更新、退订日期筛选的联系人，包括邮件许可、订阅和退订详情，以及按需返回的列表、标签、自定义字段、电话、地址和备注；各许可状态下的联系人数量。带成员数的列表、带联系人数的标签、自定义字段，以及带条件的细分。后台任务及其进度。邮件营销活动及其活动项，一封邮件的主题、发件人、受众和 HTML，HTML 预览、排程和发送历史。报告：近期活动的结果（发送、打开、点击、转发、退订、退信、垃圾邮件投诉），按活动和按活动项的统计，每个链接的点击，每个数字背后的联系人，以及单个联系人的邮件历史和打开率、点击率。

可写入的操作：添加或更新联系人（constant_contact_create_or_update_contact 按邮箱匹配，只修改传入的字段，是安全的默认选择；constant_contact_update_contact 会替换整个联系人，所以 AI 会先读取），创建和重命名列表、标签和自定义字段，批量把联系人加入或移出列表和标签，用你的 HTML 创建邮件营销活动草稿，设置受众，重命名，发送测试邮件，以及取消已排程的发送。批量修改在后台运行并返回 activity_id，AI 会用 constant_contact_get_activity 跟踪，直到状态为 completed。

制作邮件：constant_contact_create_email_campaign 用你自己的 HTML 创建草稿（自定义代码邮件，format_type 5）。HTML 必须包含 [[trackingImage]] 才能统计打开，发件人和回复地址必须是 constant_contact_list_account_emails 中已确认的地址。之后用 constant_contact_update_email_campaign_activity 设置 contact_list_ids 或 segment_ids；它会替换整个活动项，所以 AI 会先读取并重新发送所有字段。用 constant_contact_get_email_preview 和 constant_contact_send_test_email 检查效果（每次测试最多 5 个地址，每个账户每天最多 50 个测试收件人）。

安装时关闭：constant_contact_schedule_email_campaign_activity（会发送给列表中的每个联系人，开始发送后无法撤回）、constant_contact_delete_contact 和 constant_contact_delete_contact_list。团队需要时由工作区管理员开启。开启排程后，AI 也会先向你展示主题、发件人、受众和时间，得到你的确认后才排程。

许可：只添加同意接收该企业邮件的联系人，绝不要为未订阅的人把 permission_to_send 设为 explicit。已退订的联系人无法在没有本人操作的情况下通过 API 重新订阅。一个联系人最多可在 50 个列表中。

数据格式：联系人、列表、标签、自定义字段、营销活动和活动项的 ID 是 UUID；细分 ID 是整数。一个营销活动有多个活动项：报告、预览、测试和排程使用 primary_email 活动项的 campaign_activity_id，而不是 campaign_id。时间为 UTC 的 ISO 8601 格式（2026-10-30T14:05:00.000Z）。营销活动的 current_status 为 Draft、Scheduled、Executing、Done、Error 或 Removed；permission_to_send 为 explicit、implicit、not_set、pending_confirmation、temp_hold 或 unsubscribed。除非报告另有说明，报告中的计数为唯一联系人数，比率为百分比。

分页：只要还有更多页，列表就会带有 _links.next.href。联系人、列表、标签、自定义字段、后台任务和营销活动把该链接中的 cursor= 值作为 cursor 传入；报告和细分把 next= 值作为 next 传入。翻页时 AI 保持其他筛选条件不变。

限制：每个应用每天 10,000 次请求（UTC 00:00 重置），每秒 4 次；超过任一限制时 API 返回 429（quota_exceeded 或 throttled）。

常见错误：401 表示令牌已过期或被撤销：再次点击 Authorize with Provider，并确认 API Key 和密钥属于同一个应用。登录时出现重定向错误，说明 redirect URI 不完全一致。403 表示缺少 scope 或用户权限（constant_contact_get_user_privileges 会显示缺少哪个）。404 表示未知 ID。409 表示邮箱、列表、标签或营销活动名称重复。400 会在 error_key 和 error_message 中说明无效输入。带细分调用 constant_contact_list_contacts 返回 202，表示结果仍在生成中：请再查询一次。

该连接器不涵盖活动报名（Events）、短信营销、社交媒体帖子或合作伙伴端点，也不使用拖放编辑器制作邮件。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Gemini 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list），anythingmcp 应显示为已连接。
4. 开始输入提示，Gemini CLI 现在可以调用 Constant Contact 的工具。

可用工具

示例提示

• “我们最近三次邮件营销活动效果如何？比较打开、点击、退订和退信。”
• “把 [email protected] 以名字 Anna 加入 Newsletter 列表。她是在我们网站上订阅的。”
• “上周的营销活动里谁点击了价格页面的链接？列出他们的邮箱。”
• “用这段 HTML 为 VIP 客户列表创建一个营销活动草稿，先给我发一封测试邮件。”
• “给 Webinar 十月列表里的所有联系人加上 webinar-2026 标签，批量修改完成后告诉我。”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Cursor
• 连接到 Meta Muse
• 连接到 Microsoft Copilot