跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 GetResponse,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
摘要
在任意 AI 智能体中使用 GetResponse 账户:联系人列表(campaign)、带标签和自定义字段的联系人、已保存的细分和按条件搜索联系人、从草稿到发送的新闻邮件及其统计、自动回复邮件及其结果、发件地址以及列表增长报告。使用 API 密钥调用 API v3,支持 GetResponse MAX;删除联系人在安装时关闭。
试试这样问
GetResponse 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → GetResponse、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
GetResponse + Microsoft Copilot
在任意 AI 智能体中使用 GetResponse 账户:联系人列表(campaign)、带标签和自定义字段的联系人、已保存的细分和按条件搜索联系人、从草稿到发送的新闻邮件及其统计、自动回复邮件及其结果、发件地址以及列表增长报告。使用 API 密钥调用 API v3,支持 GetResponse MAX;删除联系人在安装时关闭。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
GETRESPONSE_API_URL、GETRESPONSE_API_KEY(仅 GetResponse MAX:GETRESPONSE_DOMAIN)
步骤 1 — 获取凭证
设置大约需要 2 分钟。你需要一个 GetResponse 账户。
- 在 GetResponse 中打开 Tools、Integrations and API、API(https://app.getresponse.com/api)并生成一个 API 密钥。它拥有账户的全部权限,90 天未使用的密钥会过期。
- 只把密钥本身粘贴到
GETRESPONSE_API_KEY;连接器以X-Auth-Token: api-key <key>的形式发送。 - 普通 GetResponse 账户把
GETRESPONSE_API_URL设为https://api.getresponse.com/v3。 - GetResponse MAX:把
GETRESPONSE_API_URL设为https://api3.getresponse360.com/v3(波兰数据中心为https://api3.getresponse360.pl/v3),把GETRESPONSE_DOMAIN设为你的 MAX 域名,只填名称,例如example.com;它通过X-Domain请求头发送。其他情况下GETRESPONSE_DOMAIN留空。 - 安装连接器并运行
getresponse_get_account:它会显示账户并确认密钥有效。
在 GetResponse API 中,campaign 指的是联系人列表。新闻邮件(newsletter)是一次性的群发。
可读取的内容:账户、发送限额以及 GetResponse 支持的时区(含排程发送所需的 timeZoneId)。列表及其设置和联系人,每个列表的概要,以及随时间的变化:列表规模、按来源(api、import、webform、landing page 等)统计的新订阅、按原因(退订、退信、投诉、被用户或 API 移除)统计的移除。按邮箱或姓名、列表、来源或日期搜索整个账户的联系人,单个联系人及其标签、字段值、评分、互动评分和周期天数,以及联系人的行为(发送、打开和点击;未设置 created_from 时只返回最近 14 天)。标签、自定义字段定义、已保存的细分及其条件和匹配的联系人、按条件搜索联系人,以及发件地址。新闻邮件的主题、发件人、发送设置和内容,自动回复邮件的触发条件和内容,以及一封或多封新闻邮件和自动回复邮件的统计(发送、送达、打开、点击、退信、投诉、退订)。
可写入的操作:创建列表(每个账户最多 1000 个)、标签和自定义字段;把联系人加入列表、修改联系人、添加标签和设置字段值;创建新闻邮件,发送草稿,以及停止已排程或正在发送的新闻邮件(它会变回草稿;已送达的邮件仍然有效)。
发送是真实操作:类型为 broadcast 的 getresponse_create_newsletter 和 getresponse_send_newsletter_draft 会给真实的人发邮件。AI 优先使用 draft 类型,先向你展示主题、发件人、内容和收件人,得到你的确认后才发送。send_settings 使用 GetResponse 自己的键名,例如 {"selectedCampaigns": ["V"], "excludedSegments": ["R"], "sendOn": {"date": "2026-11-14T07:00:00", "timeZone": {"timeZoneId": 282}}};没有 sendOn 时会立即开始发送。创建新闻邮件每天最多 256 次调用。
添加联系人:getresponse_create_contact 返回正文为空的 202:联系人进入队列,稍后才出现,所以 AI 之后会用 getresponse_list_contacts(email 加 exact_match: exactMatch)查找。409 表示该邮箱已在这个列表中。如果列表的 API 渠道启用了双重确认,联系人会先收到确认邮件;未确认的联系人只会出现在带 subscribers_type: ["unconfirmed"] 的 getresponse_search_contacts 结果中。联系人也可能在队列后期被拒绝;几分钟后仍找不到,就说明没有添加成功。只添加同意接收你邮件的人。
标签和字段:标签格式为 [{"tagId": "..."}],字段值格式为 [{"customFieldId": "...", "value": ["..."]}](value 始终是字符串列表)。在 getresponse_update_contact 中,tags 和 custom_field_values 会替换联系人现有的值,指定新列表会把联系人连同历史记录移到该列表;getresponse_upsert_contact_tags 和 getresponse_upsert_contact_custom_fields 只添加,不删除。
按条件搜索:getresponse_search_contacts 接受 subscribers_type、section_logic_operator(or 或 and)和 section;section 是由 campaignIdsList、logicOperator、subscriberCycle、subscriptionDate 和 conditions 组成的区块列表,例如标签条件 {"conditionType": "tag", "operatorType": "exists", "operator": "exists", "value": "<tagId>"}。它虽然是 POST,但只读取数据。参考:https://apidocs.getresponse.com/v3/case-study/segments-manual
安装时关闭:getresponse_delete_contact(无法撤销;带上 message_id 时会记录为从该邮件退订,而不是简单移除)。团队需要时由工作区管理员开启。
数据格式:ID 是短字符串(V、pV3r)。时间为 UTC 的 ISO 8601 格式;日期筛选(created_from、created_to 等)接受 YYYY-MM-DD 或 ISO 8601。统计数据按 group_by(hour、day、month、total)以周期起始时间(或 total)为键返回。打开和点击数取决于账户的打开追踪许可设置。fields(逗号分隔)可以让返回更小,例如 fields: name,email。
分页:列表默认每页 100 条;per_page 最多 1000,page 从 1 开始。返回中带有 _headers,包含 totalcount、totalpages 和 currentpage;当 currentpage 等于 totalpages 或返回空页时,AI 停止翻页。
限制:每个账户每 10 分钟 30,000 次调用,每秒 80 次,最多 10 个并行请求。429 会在 context.timeToReset 中说明需要等待多少秒。
常见错误:错误以 JSON 返回,包含 httpStatus、code、message 和 context。代码 1014 的 401 表示密钥错误、过期或缺失(在 GetResponse MAX 上也可能是缺少 GETRESPONSE_DOMAIN 或 API 地址错误)。400 会在 context 中指出无效字段。403 表示密钥对应的用户没有该区域的权限,或套餐不包含 API。404 表示未知 ID。409 表示重复(联系人已在列表中、名称已存在)。429 表示触发速率限制。
该连接器不涵盖落地页、网络研讨会、表单、电商、短信、工作流或事务性邮件,也不创建或编辑自动回复邮件。
步骤 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 — 在 Microsoft Copilot 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器:把 AnythingMCP 作为工具添加到智能体,然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接,AnythingMCP 支持这种方式。
- 在 Copilot Studio 中打开你的智能体(或新建一个),进入 Tools,选择 Add a tool → New tool → Model Context Protocol。
- 填写 Server name(例如
AnythingMCP)、说明连接器用途的 Server description,以及 Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。 - 身份验证选择 API key,把 Type 设为 Header,请求头名称填
X-API-Key,然后选择 Create。 - 在 Add tool 中选择 Create a new connection,粘贴 AnythingMCP 的 MCP API 密钥(MCP Servers → 你的服务器 → API keys),然后选择 Add to agent。
- 在智能体的 Test 窗格中试一试:提出需要用到
GetResponse的工具的请求。 - 选择 Publish,然后进入 Channels → Microsoft 365 and Microsoft Teams,保持勾选 Make agent available in Microsoft Copilot,再选择 Add channel。See agent in Teams 会为你安装该智能体;在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。
希望每个用户各自登录?请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥:每个用户会在智能体首次调用时登录 AnythingMCP。
自托管?请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接,因此 localhost 无法使用。
可用工具
| Tool | What it does |
|---|---|
getresponse_get_account | The GetResponse account the API key belongs to: login, name, email, company, country, time zone and language |
getresponse_get_sending_limits | The account's email sending limits: how many messages it may still send in the current period and the period's limits |
getresponse_list_timezones | Time zones GetResponse knows, with the numeric timeZoneId that a scheduled newsletter (send_on_timezone_id) needs |
getresponse_list_campaigns | List the campaigns, which GetResponse also calls contact lists: id, name, whether it is the default list, language and creation date |
getresponse_get_campaign | One campaign (contact list) with its settings: opt-in types, confirmation message, postal address, subscription notifications and profile |
getresponse_list_campaign_contacts | Contacts of one campaign (contact list), with email, name, origin and subscription date |
getresponse_get_campaigns_summary | Statistics summary per campaign (contact list): total subscribers, number of autoresponders, newsletters and landing pages, keyed by… |
getresponse_get_campaign_list_size | How many subscribers one or more campaigns had over time: the list size per period, keyed by date |
getresponse_get_campaign_subscriptions | New subscriptions to one or more campaigns per period and their origin (api, import, webform, landing page, ...), keyed by date |
getresponse_get_campaign_removals | Contacts removed from one or more campaigns per period and why (unsubscribed, bounced, complaint, removed by user or API), keyed by date |
getresponse_create_campaign | Create a campaign (contact list), up to 1000 per account |
getresponse_list_contacts | Search the contacts of the whole account: by email or name (partial match unless exact_match), campaign, origin, creation or change date |
getresponse_get_contact | One contact with its campaign, tags, custom field values, scoring, engagement score and autoresponder day of cycle |
getresponse_list_contact_activities | What a contact did: sends, opens and clicks of newsletters and autoresponders, with dates |
getresponse_create_contact | Add a contact to a campaign (contact list) |
getresponse_update_contact | Change a contact |
getresponse_upsert_contact_tags | Add tags to a contact without removing the ones it already has |
getresponse_upsert_contact_custom_fields | Set custom field values on a contact; fields you do not pass keep their values |
getresponse_delete_contact | Delete a contact |
getresponse_list_tags | List the account's tags with id, name and color |
getresponse_get_tag | One tag by id: its name, color and creation date |
getresponse_create_tag | Create a tag |
getresponse_list_custom_fields | List the custom field definitions (contact attributes): id, name, type, format, whether hidden and the allowed values |
getresponse_get_custom_field | One custom field definition by id: name, type, format, whether hidden and the allowed values |
getresponse_create_custom_field | Create a custom field for contacts |
getresponse_list_segments | List saved segments (search-contacts, called custom filters in the panel): id, name and creation date |
getresponse_get_segment | The conditions of one saved segment: subscriber types, sections, lists and conditions |
getresponse_list_segment_contacts | Contacts that currently match a saved segment, with email, name and list |
getresponse_search_contacts | Find contacts with ad-hoc segment conditions (tags, custom fields, email, opens, clicks, subscription date, ...) without saving a segment |
getresponse_list_from_fields | List the sender ('From') addresses: id, email, name, whether active and default |
getresponse_get_from_field | One sender ('From') address by id: email, sender name, whether it is active and the default |
getresponse_list_newsletters | List newsletters (one-off mailings): name, subject, type (draft, broadcast, splittest, automation), campaign and send date |
getresponse_get_newsletter | One newsletter with its subject, sender, send settings (lists, segments, exclusions, time), flags and content (HTML and plain text) |
getresponse_get_newsletter_statistics | Results of one newsletter: sent, delivered, opened, clicked, bounced, complaints, unsubscribed, per period or in total |
getresponse_get_newsletters_statistics | Combined results of several newsletters, chosen by newsletter ids or by campaign ids: sent, opened, clicked, bounced, unsubscribed, per… |
getresponse_create_newsletter | Create a newsletter. type draft saves it without sending (send it later with getresponse_send_newsletter_draft); type broadcast queues it… |
getresponse_send_newsletter_draft | Send a draft newsletter to the selected lists, segments or contacts, at once or at send_on_date |
getresponse_cancel_newsletter | Stop a scheduled or sending newsletter; it turns back into a draft |
getresponse_list_autoresponders | List autoresponders (messages sent on a day of the contact's cycle): name, subject, campaign, status, day of cycle and delivery figures |
getresponse_get_autoresponder | One autoresponder with its trigger (day of cycle), send settings, sender, flags and content |
getresponse_get_autoresponder_statistics | Results of one autoresponder: sent, delivered, opened, clicked, bounced, unsubscribed, per period or in total |
getresponse_get_autoresponders_statistics | Combined results of several autoresponders, chosen by autoresponder ids or campaign ids, per period or in total |
示例提示
- “我们上一封新闻邮件效果如何?列出发送、打开、点击、退信和退订。”
- “把 [email protected] 加入客户列表,并加上 vip 标签。她已同意接收我们的邮件。”
- “上个月 Newsletter 列表新增和流失了多少联系人?新联系人来自哪里?”
- “用这个主题和这段 HTML 为客户列表创建一封新闻邮件草稿。发送前先给我看发件人和收件人。”
- “找出所有带 webinar 标签、邮箱以 @example.com 结尾的已订阅联系人。”
FAQ
这适用于哪个 Copilot? 适用于工作中的 Microsoft 365 Copilot,通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。
我需要什么? 一个可以使用 Copilot Studio 的工作账户(许可证或试用版),用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限:把它共享给他们,或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略,这些策略同样适用于 MCP 服务器。
智能体不调用工具。 检查请求头名称是否正好是 X-API-Key,密钥是否属于与 URL 相同的 MCP 服务器,并把 Server description 写得具体:Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体;在已打开的对话中输入 "start over" 即可使用新版本。
下一步
这份指南对你有帮助吗?