Skip to content
Agent Analytics

Claude Code

Claude Code

Use the plugin path first. It gives Claude Code both the MCP server connection and the analytics-specific workflow layer in one install.

Prerequisites

Section titled “Prerequisites”
  • Claude Code installed locally
  • Access to the Google or GitHub sign-in you want to connect when Claude Code opens browser approval
Section titled “Recommended: install the plugin”
Terminal window
/plugin marketplace add Agent-Analytics/agent-analytics-plugin
/plugin install agent-analytics

This is the shortest hosted path for Claude Code because it packages the MCP connection and the workflow guidance around the same analytics surface together.

Verify the install

Section titled “Verify the install”

Ask 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?

If the plugin is working, Claude Code should be able to reach your account without asking you to hand-roll HTTP requests.

If you have not created your first real project yet, continue with First Project in 5 Minutes.

Fallback: install the Claude Code skill

Section titled “Fallback: install the Claude Code skill”

If you do not want the full plugin, use the skill path before raw MCP:

Terminal window
npx skills add Agent-Analytics/agent-analytics-skill

This path teaches Claude Code how to set up tracking, query analytics, and run experiments. It uses browser approval and agent sessions by default. Use a raw API key only as the advanced/manual fallback.

Lower-level fallback: add only the MCP server

Section titled “Lower-level fallback: add only the MCP server”

If you want the MCP server without the plugin or skill layer:

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

Use --transport http. The hosted MCP server is not configured for legacy SSE transport.

Troubleshooting

Section titled “Troubleshooting”
  • Make sure Claude Code completes browser approval with the same GitHub or Google account you want connected to Agent Analytics.
  • If the skill or plugin pauses on approval, complete the browser sign-in and let Claude Code continue.
  • If you intentionally use the advanced/manual API-key path, confirm the environment exposes AGENT_ANALYTICS_API_KEY.
  • If the MCP command fails, verify you used --transport http.
Section titled “Related”