MCP ServerStreamable HTTP28 个工具
Geolix MCP Server
把 Claude、Cursor 这类 AI 助手直接接到你的 Geolix 数据上。用自然语言提问,答案来自看板同一份数据。
claude mcp add geolix --transport http https://api.geolix.ai/mcp \
--header "x-api-key: glx_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"- 服务器
- https://api.geolix.ai/mcp
- 传输
- Streamable HTTP
- 认证
- x-api-key 请求头,与 REST API 共用同一把 Key
- 工具
- 2818 个只读,10 个会改配置;写工具执行前客户端会向你确认。
- 客户端
- Claude Code · Claude Desktop · Cursor · VS Code · Windsurf
概览
MCP(Model Context Protocol)是 AI 助手调用外部工具的开放协议。接上 Geolix MCP Server 之后,助手就能替你查品牌可见性、比竞品、看信源、加监测意图 —— 你只负责提问。
- 品牌可见性 — 在 ChatGPT、Perplexity、Gemini 等平台上被提及的频率、排名与情绪
- 竞品对比 — 可见性、声量份额、情绪的逐项对比与差距
- 信源分析 — AI 回答引用了哪些域名和 URL,以及它们各自的类型
- 原始记录 — 逐条问答、筛选与导出
接入
创建 API Key
登录 app.geolix.ai,打开 设置 → API Keys,创建并复制 Key。MCP 与 REST API 用的是同一种 Key。
在客户端添加服务器
所有客户端要填的是同三样东西:
| 配置项 | 值 |
|---|---|
| 服务器 URL | https://api.geolix.ai/mcp |
| 传输 | Streamable HTTP |
| 请求头 | x-api-key: glx_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
各客户端的具体位置见下一节。
提问
连上后直接说话,比如: “过去 30 天我们在 ChatGPT 上的可见性变化如何?” 助手会自己选工具、拉数据、给出回答。
各客户端配置
Claude Code
claude mcp add geolix --transport http https://api.geolix.ai/mcp \
--header "x-api-key: glx_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"Claude Desktop
设置 → 连接器 → 添加自定义连接器,填服务器 URL;认证选请求头,填 x-api-key.
Cursor
设置 → Tools & Integrations → MCP → Add Custom MCP,或直接写 .cursor/mcp.json:
{
"mcpServers": {
"geolix": {
"url": "https://api.geolix.ai/mcp",
"headers": { "x-api-key": "glx_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" }
}
}
}VS Code (GitHub Copilot)
在项目里创建 .vscode/mcp.json;Key 走环境变量,别提交明文:
{
"servers": {
"geolix": {
"type": "http",
"url": "https://api.geolix.ai/mcp",
"headers": { "x-api-key": "${env:GEOLIX_API_KEY}" }
}
}
}Windsurf
设置 → MCP → Add Server,填服务器 URL 与 x-api-key 请求头。
可以问什么
几个能直接用的问法。助手会把它们翻译成下面工具列表里的调用。
- “过去 30 天我们的品牌可见性有什么变化?哪个平台掉得最多?”
- “在 ChatGPT 上,哪家竞品的声量份额最高?和我们差多少?”
- “AI 引用最多的 10 个 URL 是哪些?有多少是我们自己的?”
- “帮我给「企业 SaaS 采购」这个主题再加 5 条监测意图。”
工作方式
助手连接后先拉取工具清单(名称、参数、是否只读),之后每次你提问,它挑合适的工具、带参数调用,服务器直接查 Geolix 数据库并把 JSON 结果交回助手组织成回答。
数据与看板完全同源:MCP Server 与 REST API 读同一个库、走同一套权限,中间没有额外的模型加工。
权限
28 个工具里 18 个只读,只拉数据;10 个会改配置(建品牌、加意图、触发或取消检测等)。
写工具在清单里标为 readOnlyHint: false,归档类工具另标 destructiveHint: true;支持这些标注的客户端会在执行前向你确认。
工具列表
按资源分组。工具名就是助手调用时用的名字。
品牌
| 工具 | 读/写 | 说明 |
|---|---|---|
list_brands | 读 | 列出品牌 |
get_brand | 读 | 品牌详情 |
create_brand | 写 | 创建品牌 |
update_brand | 写 | 更新品牌 |
项目与意图
| 工具 | 读/写 | 说明 |
|---|---|---|
list_projects | 读 | 列出项目 |
get_project | 读 | 项目详情 |
create_project | 写 | 创建项目 |
update_project | 写 | 更新项目设置 |
list_queries | 读 | 列出监测意图 |
add_queries | 写 | 添加监测意图 |
update_query | 写 | 更新一条意图 |
archive_query | 写 | 归档一条意图 |
suggest_topics | 读 | 由 AI 建议监测主题 |
suggest_queries | 读 | 由 AI 建议监测意图 |
检测
| 工具 | 读/写 | 说明 |
|---|---|---|
list_runs | 读 | 检测记录 |
get_run | 读 | 检测详情与进度 |
get_completion | 读 | 当前窗口的检测完成度 |
trigger_run | 写 | 手动触发一次检测 |
cancel_run | 写 | 取消进行中的检测 |
看板
| 工具 | 读/写 | 说明 |
|---|---|---|
get_board | 读 | 总览指标 |
get_board_sources | 读 | 信源排名 |
get_source_detail | 读 | 单个信源的详情 |
get_competitive_gap | 读 | 竞品差距 |
get_by_intent | 读 | 按意图拆分 |
get_chat_records | 读 | 原始问答记录 |
get_chat_facets | 读 | 记录的可筛选维度 |
export_chats | 读 | 导出问答记录 |
其他
| 工具 | 读/写 | 说明 |
|---|---|---|
reanalyze_project | 写 | 对项目历史数据重新聚合 |
故障排查
401 unauthorized
- Key 要带完整的
glx_live_前缀,共 41 个字符 - 到 app.geolix.ai 设置里确认 Key 没被吊销
403 forbidden
- 写工具需要 Owner 或 Admin 角色
- 账号尚未开通访问权限时也会返回 403
连接超时
- 确认 URL 是
https://api.geolix.ai/mcp,传输选 Streamable HTTP 而不是 SSE - 部分客户端默认超时较短,长查询可把超时调到 120 秒