Claude Code

Claude Code

优先走 skill 路径，然后再退回到原始 MCP 方案。

先决条件

• 本地已安装 Claude Code
• 可以访问你想连接到 Agent Analytics 的 Google 或 GitHub 身份，以便在 Claude Code 打开浏览器审批时登录

推荐：安装 Claude Code skill

npx skills add agent-analytics/skills

这个路径会让 Claude Code 学会如何配置跟踪、查询分析和运行实验。默认情况下，它使用浏览器审批和 agent session。只有在高级/手动 fallback 中才需要原始 API key。

验证安装

向 Claude Code 询问：

• Set up Agent Analytics for this project. Install it here if needed. Open the browser for me or give me a login link, then wait. I will sign in with Google or GitHub, approve it, and paste back any finish code if you need it. Then create the project, add tracking and key events, and verify the first event.
• List my Agent Analytics projects
• How is my-site doing this week?
• What are the top pages for my-site this week?

如果 skill 工作正常，Claude Code 应该能直接访问你的账户，而不需要你手写 HTTP 请求。

如果你还没有创建第一个真正的项目，请继续阅读5 分钟创建首个项目。

更低层的备选方案：仅添加 MCP 服务器

如果你只想要 MCP 服务器而不需要 skill 层：

claude mcp add agent-analytics --transport http https://mcp.agentanalytics.sh/mcp

使用 --transport http。托管的 MCP 服务器未配置旧版的 SSE transport。

故障排除

• 确认 Claude Code 使用浏览器审批连接的是你想接入 Agent Analytics 的 GitHub 或 Google 账户。
• 如果 skill 停在审批步骤，请完成浏览器登录，然后让 Claude Code 继续。
• 如果你有意为了直接进行 HTTP 调试而使用兼容的 API 密钥，请确保环境中暴露了 AGENT_ANALYTICS_API_KEY。
• 如果 MCP 命令失败，检查你是否使用了 --transport http。

相关内容

• 快速入门
• 5 分钟创建首个项目
• Claude Desktop / Cowork
• Authentication
• API Reference