跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 GoHighLevel,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
摘要
单个子账户的 GoHighLevel(HighLevel、LeadConnector)CRM:带标签、备注和任务的联系人,会话以及发送短信、邮件或 WhatsApp,商机和销售管道,日历和预约,工作流,表单和问卷提交,发票、付款和 Social Planner 帖子。通过 Private Integration 令牌连接。
试试这样问
GoHighLevel 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → GoHighLevel、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
GoHighLevel + Cursor
单个子账户的 GoHighLevel(HighLevel、LeadConnector)CRM:带标签、备注和任务的联系人,会话以及发送短信、邮件或 WhatsApp,商机和销售管道,日历和预约,工作流,表单和问卷提交,发票、付款和 Social Planner 帖子。通过 Private Integration 令牌连接。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
GOHIGHLEVEL_API_TOKEN, GOHIGHLEVEL_LOCATION_ID
步骤 1 — 获取凭证
设置大约需要 5 分钟。你需要拥有 AI 要使用的那个 HighLevel 子账户(location)的管理员权限。
- 在子账户中打开 Settings、Private Integrations,点击 Create new Integration。给它起个名字,例如 AnythingMCP。
- 选择工具需要的权限范围:
locations.readonly、locations/customFields.readonly、locations/tags.readonly、contacts.readonly、contacts.write、conversations.readonly、conversations/message.readonly、conversations/message.write、opportunities.readonly、opportunities.write、calendars.readonly、calendars/events.readonly、calendars/events.write、users.readonly、workflows.readonly、forms.readonly、surveys.readonly、invoices.readonly、invoices.write、payments/orders.readonly、payments/transactions.readonly、payments/subscriptions.readonly、socialplanner/account.readonly、socialplanner/post.readonly、socialplanner/post.write。不希望 AI 拥有的写入权限请不要勾选。 - 把令牌(以
pit-开头,只显示一次)复制到GOHIGHLEVEL_API_TOKEN。它以Authorization: Bearer <token>发送;粘贴时不要带Bearer前缀。 - 把 Settings、Business Profile 中的 Location ID(也可以从 URL 中
/location/之后取得)复制到GOHIGHLEVEL_LOCATION_ID。所有工具都在这个子账户中工作。 - 安装连接器并运行
gohighlevel_get_location:它会显示子账户信息,并确认令牌和 Location ID 可用。
HighLevel 要求的 Version 请求头由连接器自动发送(2021-07-28,会话和日历为 2021-04-15)。
可读取的内容:子账户信息、自定义字段(customFields 所需的 id)、标签、用户(assignedTo 所需的 id)、带阶段的销售管道、日历和工作流;按自由文本或筛选条件查找的联系人,及其标签、来源、DND 设置、自定义字段值、备注、任务和预约;跨短信、邮件、WhatsApp、Facebook、Instagram 和在线聊天的会话及其消息;按管道、阶段、状态、联系人、负责人或日期查找的商机;日历的空闲时段和日程;表单、问卷及其提交;带明细行和应付金额的发票、付款订单、交易(收款和退款)和订阅;Social Planner 中已连接的账户和帖子。
可写入的内容:所有写入工具在安装时都已开启,因此 AI 能改什么由 Private Integration 的权限范围决定。联系人:gohighlevel_create_contact、gohighlevel_upsert_contact(按邮箱或电话避免重复)、gohighlevel_update_contact,标签用 gohighlevel_add_contact_tags 和 gohighlevel_remove_contact_tags,以及 gohighlevel_create_contact_note、gohighlevel_create_contact_task 和 gohighlevel_update_contact_task。自动化:gohighlevel_add_contact_to_workflow 和 gohighlevel_remove_contact_from_workflow(仅限已发布的工作流),或添加会触发工作流的标签。销售:gohighlevel_create_opportunity、gohighlevel_update_opportunity(移动阶段)和 gohighlevel_update_opportunity_status(won、lost、abandoned)。预约:先 gohighlevel_get_free_slots,再 gohighlevel_create_appointment,用 gohighlevel_update_appointment 改期、确认、取消或标记爽约。资金:gohighlevel_create_invoice(草稿)和 gohighlevel_send_invoice。社交:gohighlevel_create_social_post。
会送达他人的操作:gohighlevel_send_message 会立即向联系人发送短信、邮件、WhatsApp 或社交消息,可能消耗短信或邮件额度;在某个渠道开启 DND 的联系人不会通过该渠道收到消息。gohighlevel_send_invoice 会给联系人发送付款链接,gohighlevel_create_social_post 会在预定时间公开发布。执行这些操作前,AI 会先向你展示文本、收件人或帖子内容,等你同意。安装时没有关闭任何工具。
数据格式:id 是 20 个字符的字符串。记录中的日期为 UTC 的 ISO 8601;日历空闲时段和日程使用毫秒级 Unix 时间;预约的开始和结束为带时区偏移的 ISO 8601;商机搜索的日期格式为 mm-dd-yyyy;表单、问卷、发票和付款的筛选使用 YYYY-MM-DD。发票和付款金额以货币单位表示(120.5 = 120.50),不是分。电话号码为 E.164 格式。空闲时段每次调用最多覆盖 31 天。
分页:联系人使用 page 和 page_limit(每页最多 500 条,总共最多 10,000 条;超出时 AI 传入最后一个联系人的 search_after)。商机使用 page 和 limit(最多 100),或 meta 中的 startAfter 和 startAfterId。会话使用 limit 和 start_after_date,消息使用 last_message_id 和 nextPage。发票和付款使用 limit 和 offset,表单和问卷使用 page 和 limit。
限制:HighLevel 允许每个子账户每 10 秒 100 次请求、每天 200,000 次请求;超出时返回 429。
常见错误:401 表示令牌错误或已删除,或属于另一个子账户。403 或 “The token is not authorized for this scope” 表示 Private Integration 缺少该权限范围:编辑它,添加权限范围并保存。422 会列出无效字段。
连接器只在一个子账户中工作,不涉及整个代理商账户。它不删除记录,不创建或编辑工作流、漏斗或日历,也不发起退款。
步骤 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 — 在 Cursor 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换
YOUR_MCP_API_KEY。 - 保存文件并重启 Cursor。
- 打开 Cursor → Settings → MCP,确认
anythingmcp已列出并处于已连接状态。 - 开始对话,智能体现在可以调用
GoHighLevel的工具。
可用工具
| Tool | What it does |
|---|---|
gohighlevel_get_location | Details of the configured sub-account (location): name, address, phone, email, website, timezone, business info and settings |
gohighlevel_list_custom_fields | List the custom fields of the sub-account with id, name, fieldKey (contact.my_field), data type, picklist options and model (contact or… |
gohighlevel_list_tags | List the contact tags defined in the sub-account with id and name |
gohighlevel_search_contacts | Search contacts of the sub-account by free text (name, email, phone, company) and/or filters, sorted and paged |
gohighlevel_get_contact | Get one contact by id with name, email, phone, address, tags, source, DND settings, custom field values, assigned user, followers and dates |
gohighlevel_create_contact | Create a contact in the sub-account with name, email, phone, address, tags, source, custom fields and assigned user |
gohighlevel_upsert_contact | Create a contact or update the existing one with the same email or phone (following the sub-account's duplicate settings) |
gohighlevel_update_contact | Update a contact by id: name, email, phone, address, tags (replaces the list), DND, custom fields, source or assigned user |
gohighlevel_add_contact_tags | Add tags to a contact without touching its other tags |
gohighlevel_remove_contact_tags | Remove the given tags from a contact; its other tags stay |
gohighlevel_list_contact_notes | List the notes on a contact with id, body, user and date added |
gohighlevel_create_contact_note | Add a note to a contact, e.g. a call summary |
gohighlevel_list_contact_tasks | List the tasks of a contact with id, title, body, due date, completed flag and assigned user |
gohighlevel_create_contact_task | Create a follow-up task on a contact with title, description, due date and assigned user |
gohighlevel_update_contact_task | Update a contact task: title, description, due date, assignee, or mark it completed |
gohighlevel_list_contact_appointments | List the calendar appointments of a contact with id, calendar, title, status, start and end time |
gohighlevel_add_contact_to_workflow | Enroll a contact in a published workflow, now or from a given start time |
gohighlevel_remove_contact_from_workflow | Remove a contact from a workflow so its remaining steps do not run for that contact |
gohighlevel_list_workflows | List the workflows of the sub-account with id, name, status (draft or published) and dates |
gohighlevel_search_conversations | Search conversations (one thread per contact across SMS, email, WhatsApp, Facebook, Instagram, chat) by contact, text, assignee, status or… |
gohighlevel_get_conversation | Get one conversation by id: contact, channel, assigned user, unread count, starred flag and last message |
gohighlevel_list_messages | List the messages of a conversation, newest first: direction (inbound or outbound), type, body, status, attachments and date |
gohighlevel_send_message | Send an SMS, email, WhatsApp, Instagram, Facebook or live chat message to a contact through the sub-account, now or scheduled |
gohighlevel_list_pipelines | List the opportunity pipelines of the sub-account with their stages (id, name, position) |
gohighlevel_search_opportunities | Search opportunities (deals) by text, pipeline, stage, status, contact, assignee or date |
gohighlevel_get_opportunity | Get one opportunity by id: name, pipeline and stage, status, monetary value, contact, assigned user, custom fields and dates |
gohighlevel_create_opportunity | Create an opportunity (deal) for a contact in a pipeline stage with name, status, value, assignee and custom fields |
gohighlevel_update_opportunity | Update an opportunity: move it to another stage or pipeline, rename, change value, status, assignee or custom fields |
gohighlevel_update_opportunity_status | Set only the status of an opportunity: open, won, lost (optionally with a lost reason) or abandoned |
gohighlevel_list_calendars | List the calendars of the sub-account with id, name, type, team members, slot duration and widget settings |
gohighlevel_get_free_slots | Free booking slots of a calendar between two dates (at most 31 days apart), grouped by day, in the requested time zone |
gohighlevel_list_calendar_events | List appointments and events between two times for a calendar, a user or a calendar group (one of the three is required), with contact… |
gohighlevel_get_appointment | Get one appointment by id: calendar, contact, assigned user, title, status, address or meeting link, start and end time |
gohighlevel_create_appointment | Book an appointment for a contact in a calendar at a start time, with status, assigned user, location and notes |
gohighlevel_update_appointment | Update an appointment: reschedule, change status (confirmed, cancelled, showed, noshow), assignee, title, location or notes |
gohighlevel_list_users | List the users (team members) of the sub-account with id, name, email, phone, role and permissions |
gohighlevel_get_user | Get one user by id: name, email, phone, role, type, permissions and the sub-accounts it can access |
gohighlevel_list_forms | List the forms of the sub-account with id and name; form ids filter gohighlevel_list_form_submissions |
gohighlevel_list_form_submissions | List form submissions with contact id, name, email, the submitted fields and date |
gohighlevel_list_surveys | List the surveys of the sub-account with id and name; survey ids filter gohighlevel_list_survey_submissions |
gohighlevel_list_survey_submissions | List survey submissions with contact, answers and date |
gohighlevel_list_invoices | List invoices of the sub-account with number, name, contact, status (draft, sent, paid, void, partially_paid, ...), total, amount due… |
gohighlevel_get_invoice | Get one invoice by id: number, contact and business details, line items, discount, taxes, totals, amount paid and due, status, dates and… |
gohighlevel_create_invoice | Create a draft invoice for a contact with line items, currency, issue and due date, business details, discount and terms |
gohighlevel_send_invoice | Send an invoice to the contact by email, SMS, both, or mark it as sent manually |
gohighlevel_list_orders | List payment orders (funnel, store and payment link sales) with contact, amount, currency, status, payment status and date |
gohighlevel_get_order | Get one order by id: contact, line items with products and prices, amount, currency, status, payment status, source and fulfillment |
gohighlevel_list_transactions | List payment transactions (charges and refunds) with contact, amount, currency, status, payment provider, source (funnel, invoice, store)… |
gohighlevel_get_transaction | Get one payment transaction by id: amount, currency, status, contact, provider charge id, source entity and refund state |
gohighlevel_list_subscriptions | List recurring payment subscriptions with contact, product, amount, interval, status and dates |
gohighlevel_list_social_accounts | List the social media accounts connected to the Social Planner (Facebook, Instagram, LinkedIn, Google Business, TikTok, X, ...) with their… |
gohighlevel_list_social_posts | List Social Planner posts in a date range: content, accounts, media, status (scheduled, published, draft, failed) and schedule date |
gohighlevel_create_social_post | Create a Social Planner post for one or more connected accounts: text, media, as draft or scheduled for a date |
示例提示
- “找到邮箱为 [email protected] 的联系人,显示她的标签、备注和未完成的任务。”
- “现在哪些会话有未读消息?分别概括每个会话的最后一条消息。”
- “把张氏贸易的商机“网站改版”移到“已发送报价”阶段,并把金额设为 4,500。”
- “在销售日历中找下周二一个 30 分钟的空闲时段,为联系人 Marco Rossi 预约。保存前先给我看预约内容。”
- “列出已发送但尚未付款的发票,附上联系人、应付金额和到期日。”
FAQ
Cursor 免费套餐支持自定义 MCP 服务器吗? 支持,Hobby、Pro 和 Business 套餐均可使用 MCP。
下一步
这份指南对你有帮助吗?