Geovory 内置一个 Model Context Protocol 服务器，让 Claude 等 AI 助手和 Cursor 等编辑器可以直接查询你的可见度数据——"本周我最大的引用缺口是什么？"变成一句可以直接问助手的话。
端点：https://geovory.com/mcp（streamable HTTP 传输）
认证
MCP 服务器使用与 REST API 相同的工作区 API 密钥。在 仪表盘 → 设置 → API 密钥 创建一把，作为 Bearer token 传入。
可用工具
所有工具均为只读且不需要参数——API 密钥已经标识了你的工作区。
| 工具 | 返回内容 |
| --- | --- |
| get_visibility | 最新评级、提及率、引用漏斗、平台与上周对比。 |
| list_prompts | 每周扫描所问的买家问题，含标签与状态。 |
| get_sources | 最近一次扫描中 AI 回答引用的域名。 |
| get_gaps | 引用缺口——引用了竞品而没有你的品牌的 URL。 |
在 Claude Desktop 中接入
在 claude_desktop_config.json 中加入（需要支持 streamable HTTP 的桥接器，如 mcp-remote）：
``json``
{
"mcpServers": {
"geovory": {
"command": "npx",
"args": [
"mcp-remote",
"https://geovory.com/mcp",
"--header",
"Authorization: Bearer rk_你的API密钥"
]
}
}
}
在 Cursor 中接入
在 Cursor 设置 → MCP 中添加一个类型为 streamableHttp 的服务器：
``json``
{
"mcpServers": {
"geovory": {
"url": "https://geovory.com/mcp",
"headers": { "Authorization": "Bearer rk_你的API密钥" }
}
}
}
协议细节
- 传输：streamable HTTP——每个
POST /mcp携带一条 JSON-RPC 2.0 消息并收到一条 JSON 响应。通知类消息以202确认。 - 协议版本：
2025-03-26。 - 速率限制：与 REST API 共用——每个密钥每分钟 60 次。
- 错误遵循 JSON-RPC 约定（
-32601未知方法，-32602未知工具，-32700解析错误）。
安全
MCP 服务器暴露的数据与 REST API 完全相同且只读——通过它无法更改任何内容。请像对待密码一样对待 API 密钥：不要提交到代码库，泄露的密钥请在 设置 → API 密钥 中立即吊销。