geOracle MCP
快速入门
从零到第一份 GEO 评分简报约需五分钟。您需要一个 geOracle 账户（免费）以及一款受支持的代理。
前置条件
- 一个 geOracle 账户（免费注册）
- 已安装 Claude Code、Cursor 或 Codex CLI
- 您的生产站点 URL
1. 获取密钥
运行设置向导并选择 MCP，或在团队设置中生成密钥。密钥仅显示一次：请复制到安全的地方。
2. 将服务器添加到您的代理
选择您的客户端。该命令会以请求头携带您的密钥，添加 geOracle MCP 服务器。
terminal
claude mcp add --transport http georacle https://georacle.ai/api/mcp --header "Authorization: Bearer YOUR_KEY"Claude Code
/plugin marketplace add georacle/claude-plugin
/plugin install georacle@georacle
/georacle:setup在 Claude Code 中安装 geOracle 插件，/georacle:setup 会完成上述全部配置，包括每周例行任务。
3. 验证连接
让代理调用 get_dashboard_summary，或使用向导中的测试连接按钮。调用成功后几秒内即可在仪表盘中看到。
4. 运行您的第一个工作流
在 Claude Code 中安装插件并运行 /georacle:setup 走引导流程（接入网站、首次优化、每周例行任务）。也可以直接让代理接入您的网站，并为最薄弱的三个页面打分。
故障排查
- 401 Unauthorized
- 密钥错误、已被吊销或缺少 mcp 权限范围。请在团队设置中生成新密钥并更新客户端配置。
- 工具返回 payment_required
- 该工具属于付费层级。免费层级涵盖分析与打分；请在向导中升级，或使用 PRO 或 ENTERPRISE 计划附带的访问权限。
- get_site_snapshot 超时
- 大型网站采用异步分析。该工具会返回一个 job id，由您的代理轮询，这属于正常现象。
- 提交时出现 stale_briefing
- 内容在简报与提交之间发生了变化。请获取最新简报后重新提交。
后续步骤
- 阅读您的代理可见的入门资源（georacle://docs/getting-started）
- 使用 /georacle:setup 配置每周例行任务
- 打开仪表盘，审阅代理提交的内容