> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 通过 MCP 将 AI 助手连接到 LanderLab

> 了解 LanderLab MCP 服务器的工作原理、它提供哪些工具，以及如何在任意 AI 助手中用自然语言管理你的落地页、数据分析、线索和 A/B 测试。

## 什么是 LanderLab MCP 服务器？

LanderLab MCP 服务器通过 [Model Context Protocol](https://modelcontextprotocol.io)（模型上下文协议）将你的 AI 助手连接到 LanderLab 账户。连接后，你的助手可以列出落地页、拉取数据分析、发布页面、管理线索、运行 A/B 测试等等，你完全不需要打开控制台。

**MCP 服务器 URL：**

```text theme={null}
https://api.landerlab.dev/mcp
```

* 使用你的 LanderLab 账户登录（OAuth）
* 无需 API 密钥、无需请求头、无需编辑配置文件
* 提供 30 多个工具
* 适用于 Claude、Cursor、Windsurf、Manus、ChatGPT、Codex 以及任何兼容 MCP 的客户端

## 适合谁使用？

希望提高效率的效果营销人员、媒体采买人员和团队。你无需在 AI 工具和 LanderLab 控制台之间来回切换，只需用自然语言描述你的需求，助手就会帮你完成。

## 工作原理

MCP 服务器提供一系列工具，供你的 AI 助手在对话中调用。当你说“列出工作区 1 中的落地页”时，助手会调用 `landers_list`，并直接在聊天中返回结果。

## 连接你的 AI 助手

选择你使用的工具，并按照对应的设置指南操作：

* [Claude.ai](/zh/mcp/ai-assistants/claude)
* [Claude Desktop](/zh/mcp/ai-assistants/claude-desktop)
* [Claude Code](/zh/mcp/ai-assistants/claude-code)
* [Cursor](/zh/mcp/ai-assistants/cursor)
* [Windsurf](/zh/mcp/ai-assistants/windsurf)
* [Manus](/zh/mcp/ai-assistants/manus)
* [ChatGPT](/zh/mcp/ai-assistants/chatgpt)
* [Codex](/zh/mcp/ai-assistants/codex)
* [Gemini CLI](/zh/mcp/ai-assistants/gemini-cli)

**Claude 可以在其连接器目录中找到 LanderLab。其他任何兼容 MCP 的客户端，只需指向** `https://api.landerlab.dev/mcp` **并完成登录提示即可连接。**

> **Grok、Perplexity 和 Copilot 呢？** 这些工具目前不支持作为客户端连接外部 MCP 服务器。Grok 和 Perplexity 可以作为 MCP 服务器，将自己的搜索工具提供给其他客户端，但它们的聊天界面无法连接到 LanderLab MCP 这样的服务器。Microsoft Copilot Studio 确实支持 MCP，但需要复杂的企业级配置，超出了本指南的范围。

## 工具参考

你的组织会根据你登录的账户自动识别，无需传入组织 ID。

### 只读工具

| 工具 | 功能 |
| - | - |
| `workspaces_list` | 列出所有工作区 |
| `landers_list` | 列出工作区中的落地页 |
| `domains_list` | 列出工作区中的域名 |
| `domains_list_global` | 列出整个组织的所有域名 |
| `integrations_list` | 列出已配置的集成 |
| `leads_list` | 列出某个落地页的线索 |
| `leads_list_org` | 列出整个组织的线索 |
| `variants_list` | 列出 A/B 测试变体 |
| `api_key_list` | 列出 API 密钥 |
| `dashboard_get` | 获取访问量、转化和线索统计 |
| `analytics_graphs` | 获取某个落地页的图表数据 |
| `analytics_stats` | 获取某个落地页的详细统计 |
| `analytics_reports` | 为某个落地页生成报告 |
| `reporting_get` | 运行多落地页报告 |
| `editor_load` | 加载某个变体的 HTML 和设置 |

### 变更类工具

| 工具 | 功能 |
| - | - |
| `lander_publish` | 发布落地页 |
| `lander_unpublish` | 取消发布落地页 |
| `editor_save` | 保存某个变体的 HTML 内容 |
| `editor_save_settings` | 保存变体设置 |
| `variants_set_weights` | 设置 A/B 测试流量分配 |
| `variants_enable` | 启用变体 |
| `variants_disable` | 停用变体 |
| `leads_update` | 更新线索 |
| `leads_delete` | 删除线索 |
| `leads_update_org` | 更新线索（组织级） |
| `leads_delete_org` | 删除线索（组织级） |
| `lander_integration_enable` | 在落地页上启用集成 |
| `lander_integration_disable` | 在落地页上停用集成 |
| `lander_integration_delete` | 从落地页移除集成 |
| `integration_create` | 创建组织级集成 |
| `api_key_revoke` | 吊销 API 密钥 |
| `api_key_update` | 更新 API 密钥 |

## 示例提示词

连接后，用自然语言和你的助手对话即可：

**“列出我所有的落地页及其状态”** 调用 `landers_list`，返回页面名称、URL 和发布状态。

**“显示落地页 X 最近 7 天的数据分析”** 使用该日期范围调用 `analytics_stats`，返回访问量、转化和线索。

**“取消发布落地页 X”** 调用 `lander_unpublish` 将页面下线。

**“将落地页 X 的 A/B 测试权重设置为 70/30”** 调用 `variants_set_weights` 调整变体之间的流量分配。

**“显示工作区 1 的所有线索”** 调用 `leads_list`，返回该工作区的线索数据。

## 身份验证

MCP 服务器使用 OAuth。你的助手首次连接时，会在浏览器中打开 LanderLab 登录页面。你只需批准一次访问请求，客户端就会保存一个 token 并自动刷新。

你的配置文件中不会存放任何敏感信息。你可以随时在 LanderLab 的 **Settings > Connected Apps** 中断开连接，或在你的 AI 工具中移除该连接器。

<Note>
  直接调用 REST API 时仍需使用 API 密钥，参见[生成 API 密钥](/zh/mcp/generate-api-key)。MCP 已不再使用 API 密钥。
</Note>

## 故障排查

**登录窗口没有打开** - 有些客户端会在首次连接时拦截弹窗。请为你的 AI 工具允许弹窗，然后重新连接。

**授权成功但没有显示任何工具** - 重启你的 AI 工具。大多数客户端只在会话开始时加载工具列表。

**401 Unauthorized** - 你的会话已过期或访问权限已被撤销。移除该连接器后重新添加，以触发新的登录。

**Not Acceptable** - `Accept` 请求头必须同时包含 `application/json` 和 `text/event-stream`。这个错误通常在使用 curl 或自定义客户端测试时出现。

**仍然指向旧 URL** - 如果你的配置中仍包含 `https://api.landerlab.dev/api/v2/mcp` 和 `X-API-Key` 请求头，请删除该条目，并使用 `https://api.landerlab.dev/mcp` 重新连接。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.