跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 HeyReach，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
在任意 AI 智能体中使用 HeyReach 做 LinkedIn 外联：运行营销活动并添加或停止其中的线索，管理线索列表、公司列表和线索标签，在统一的 LinkedIn 收件箱中查看并回复对话，检查发送账户和一度人脉，对比外联统计并管理 Webhook。使用 HeyReach API 密钥；删除操作在安装时关闭。
试试这样问
HeyReach 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → HeyReach、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
HeyReach
在任意 AI 智能体中使用 HeyReach 做 LinkedIn 外联：运行营销活动并添加或停止其中的线索，管理线索列表、公司列表和线索标签，在统一的 LinkedIn 收件箱中查看并回复对话，检查发送账户和一度人脉，对比外联统计并管理 Webhook。使用 HeyReach API 密钥；删除操作在安装时关闭。
设置
设置大约需要 2 分钟。你需要一个 HeyReach 工作区。
- 在 HeyReach 中打开 Integrations 和 HeyReach API 部分。
- 点击 Get API Key，再点 New API Key，把密钥复制到
HEYREACH_API_KEY。密钥不会过期，但可以在那里删除或停用。一个密钥只属于一个工作区。 - 安装连接器并运行
heyreach_check_api_key：密钥可用时返回 200，响应体为空。
密钥通过 X-API-KEY 请求头发送。
Id：campaign_id 来自 heyreach_list_campaigns；发送者 id（account_id、linkedin_account_id、sender_id）来自 heyreach_list_linkedin_accounts；list_id 来自 heyreach_list_lists；conversation_id 来自 heyreach_list_conversations；webhook_id 来自 heyreach_list_webhooks。线索通过其 LinkedIn 个人资料 URL（https://www.linkedin.com/in/<slug>/）或 LinkedIn id（线索记录中的 linkedin_id）识别。
营销活动：
- 读取：
heyreach_list_campaigns（按状态或发送者筛选）、heyreach_get_campaign、heyreach_get_campaign_sequence（步骤树：好友邀请、消息、InMail、关注、点赞、查看资料，以及等待时间和文案）、heyreach_list_campaign_leads和heyreach_get_campaigns_for_lead。 - 控制：
heyreach_start_campaign启动一个已有序列、线索列表和至少一个已连接 LinkedIn 发送者的草稿；heyreach_pause_campaign和heyreach_resume_campaign用于暂停和继续。 - 线索：
heyreach_add_leads_to_campaign每次最多添加 100 条线索，可为每条线索指定发送者，并可在同一次调用中恢复已暂停的营销活动。heyreach_stop_lead_in_campaign停止单条线索，heyreach_update_lead_custom_fields设置在消息中用作变量的自定义字段。 - 营销活动状态：DRAFT、IN_PROGRESS、PAUSED、FINISHED、CANCELED、FAILED、STARTING、SCHEDULED。线索状态：Pending、InSequence、Finished、Paused、Failed、Excluded。
启动营销活动和添加线索会让你的 LinkedIn 账户对真实的个人资料执行操作，所以请先让 AI 展示营销活动、发送者和线索。
列表：heyreach_list_lists、heyreach_get_list、heyreach_list_list_leads、heyreach_list_list_companies、heyreach_get_lists_for_lead、heyreach_create_list（空的线索列表或公司列表）和 heyreach_add_leads_to_list（每次最多 100 条线索）。列表不是营销活动：已结束的营销活动不会接收列表中的新线索；这种情况请用 heyreach_add_leads_to_campaign。
线索和标签：heyreach_get_lead 按 URL 读取个人资料（姓名、标题、公司、职位、所在地、邮箱、标签、工作经历、教育经历）。另有 heyreach_get_lead_tags、heyreach_add_lead_tags（保留已有标签）和 heyreach_replace_lead_tags。
收件箱：heyreach_list_conversations 按时间从新到旧列出发送账户的对话，可按发送者、营销活动、线索、标签、已读状态和时间筛选。它不返回邮箱地址和自定义字段，这些可通过 heyreach_get_lead 获取。heyreach_get_conversation 返回全部消息，heyreach_send_message 从拥有该对话的发送者回复，heyreach_set_conversation_seen 将其标为已读或未读。发出的消息会立即在 LinkedIn 上送达线索，所以 AI 会先给你看文案。
发送者和人脉：heyreach_list_linkedin_accounts 和 heyreach_get_linkedin_account 显示限额、冷却期以及 Sales Navigator 和 Recruiter 状态；heyreach_get_linkedin_account_status 说明 LinkedIn 会话是否仍处于连接状态，若未连接则说明原因。heyreach_list_network 列出某个发送者的一度人脉，heyreach_is_connection 检查单条线索（个人资料 URL 或 LinkedIn id，二选一）。
统计：heyreach_get_overall_stats 和 heyreach_get_stats_by_campaign 接受 start_date 和 end_date（ISO 8601，例如 2026-10-01T00:00:00.000Z），以及可选的发送者 id 和营销活动 id。它们返回资料查看、点赞、关注、已发送和已接受的好友邀请、已发送和收到回复的消息与 InMail，以及接受率和回复率。
Webhook：heyreach_list_webhooks、heyreach_get_webhook、heyreach_create_webhook 和 heyreach_update_webhook。每个 Webhook 只对应一种事件类型：CONNECTION_REQUEST_SENT、CONNECTION_REQUEST_ACCEPTED、MESSAGE_SENT、MESSAGE_REPLY_RECEIVED、EVERY_MESSAGE_REPLY_RECEIVED、INMAIL_SENT、INMAIL_REPLY_RECEIVED、FOLLOW_SENT、LIKED_POST、VIEWED_PROFILE、CAMPAIGN_COMPLETED、LEAD_TAG_UPDATED。
安装时关闭：heyreach_delete_leads_from_list 和 heyreach_delete_webhook。这些操作无法撤销，因此由工作区管理员在团队需要时开启。
数据格式：时间为 ISO 8601，未注明偏移量时为 UTC。统计中的 byDayStats 按天（UTC）分组，比率为小数（0.23 = 23%）。
分页：大多数列表接受 offset 和 limit（最多 100），返回 totalCount 和 items；heyreach_list_list_leads 每页最多 1000 条，heyreach_list_network 使用 page_size（最多 100）。heyreach_list_conversations 使用游标分页（默认 10，最多 100）：AI 把 nextCursor 作为 cursor 传回，直到它为 null。
限制和常见错误：每个密钥每分钟 300 次请求，超出后 HeyReach 返回 429。401 表示密钥错误或已停用，404 表示 id 错误，400 表示请求体无效，例如自定义字段名包含字母、数字和下划线以外的字符。
创建营销活动、连接 LinkedIn 账户（密码、Cookie、代理）以及组织管理被有意排除在外；请在 HeyReach 应用中完成这些操作。
前提条件: HEYREACH_API_KEY
本地安装连接器
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
打开 http://localhost:3000/connectors/store，选择 HeyReach 并填入前提条件中列出的环境变量。
可用工具
| Tool | What it does |
|---|---|
heyreach_check_api_key | Check that the HeyReach API key works |
heyreach_list_campaigns | List LinkedIn outreach campaigns with status, lead list, sender accounts and progress counts (total, in progress, pending, finished, failed) |
heyreach_get_campaign | Get one campaign: status, lead list, sender accounts, exclusion settings and progress counts |
heyreach_get_campaign_sequence | Get the sequence of a campaign: the tree of steps (connection request, message, InMail, follow, like, view profile) with delays and message… |
heyreach_list_campaign_leads | List the leads of a campaign with their LinkedIn profile, status and last action |
heyreach_get_campaigns_for_lead | List the campaigns a lead is in, with campaign status and the lead status in each (Pending, InSequence, Finished, Paused, Failed, Excluded) |
heyreach_add_leads_to_campaign | Add up to 100 leads to a campaign, optionally pinning each lead to a sender account |
heyreach_stop_lead_in_campaign | Stop a lead in a campaign: it gets no further steps |
heyreach_pause_campaign | Pause a running campaign |
heyreach_resume_campaign | Resume a paused campaign so it continues its sequence where each lead stopped |
heyreach_start_campaign | Start a draft campaign |
heyreach_update_lead_custom_fields | Set custom field values on a lead in a campaign, for use as variables in its messages |
heyreach_list_conversations | List LinkedIn conversations of the sender accounts, newest first, with the last message, read state and the lead profile |
heyreach_get_conversation | Get one LinkedIn conversation with all its messages, senders and the lead profile |
heyreach_send_message | Send a LinkedIn message in an existing conversation from the sender account of that conversation |
heyreach_set_conversation_seen | Mark a LinkedIn conversation as read or unread in the HeyReach inbox |
heyreach_list_linkedin_accounts | List the LinkedIn sender accounts: name, email, active campaigns, whether the session is valid, Sales Navigator and Recruiter status… |
heyreach_get_linkedin_account | Get one LinkedIn sender account with its limits, cooldowns and session state |
heyreach_get_linkedin_account_status | Get the live connection status of a LinkedIn sender (Connected, Disconnected and why) and its Sales Navigator and Recruiter sessions |
heyreach_list_lists | List lead and company lists with their ids, sizes, type and the campaigns using them |
heyreach_get_list | Get one lead or company list: name, type, size, creation time and campaigns using it |
heyreach_list_list_leads | List the leads of a lead list with profile, company, position, tags, email and custom fields |
heyreach_list_list_companies | List the companies of a company list with name, LinkedIn URL and details, paged |
heyreach_get_lists_for_lead | List the lead lists a lead belongs to |
heyreach_create_list | Create an empty lead list or company list; fill it with heyreach_add_leads_to_list |
heyreach_add_leads_to_list | Add up to 100 leads to a lead list |
heyreach_delete_leads_from_list | Remove leads from a lead list by their LinkedIn profile URLs |
heyreach_get_lead | Get a lead by LinkedIn profile URL: name, headline, company, position, location, email, tags, experience and education |
heyreach_get_lead_tags | Get the tags of a lead, identified by its LinkedIn profile URL |
heyreach_add_lead_tags | Add tags to a lead (existing tags are kept) |
heyreach_replace_lead_tags | Replace all tags of a lead with the given ones |
heyreach_list_network | List the 1st-degree LinkedIn connections of a sender account, paged |
heyreach_is_connection | Check whether a lead is a 1st-degree connection of a sender |
heyreach_get_overall_stats | Get outreach results for a period, per day and in total: profile views, likes, follows, connection requests sent and accepted, messages and… |
heyreach_get_stats_by_campaign | Get the same outreach results as heyreach_get_overall_stats, broken down per campaign |
heyreach_list_webhooks | List the webhooks of the workspace with their URL, event type, campaigns and active state |
heyreach_get_webhook | Get one webhook with its URL, event type, campaigns and active state |
heyreach_create_webhook | Create a webhook that POSTs one event type to a URL, for all campaigns or selected ones |
heyreach_update_webhook | Change a webhook: name, URL, event type, campaigns, or switch it on or off |
heyreach_delete_webhook | Delete a webhook by id |
示例提示
- “我们上个月的 LinkedIn 外联效果如何？按营销活动列出已发送和已接受的好友邀请以及回复率。”
- “给我看最近 3 天未读的 LinkedIn 对话，附上线索姓名和最后一条消息。”
- “把这三个 LinkedIn 个人资料加入 Founders DACH 营销活动，并告诉我添加了多少个。”
- “我们现在有没有断开连接的 LinkedIn 发送账户？”
- “https://www.linkedin.com/in/jane-doe 在哪些营销活动中？她在每个活动中的状态是什么？”
下一步
这份指南对你有帮助吗?