Metrifyr
Guides

Troubleshooting

Fix common issues

Troubleshooting

Common Issues

"MCP server not connecting"

Cause: MCP client not restarted or config error

Fix:

  1. Verify config file path is correct
  2. Check API key is valid
  3. Restart MCP client (Claude Desktop, Cursor, etc.)

"401 Unauthorized"

Cause: Invalid or revoked API key

Fix:

  1. Check API key in config matches dashboard
  2. Verify key hasn't been revoked
  3. Create new key if needed

"403 Forbidden"

Cause: Missing OAuth scope or tool disabled

Fix:

  1. Reconnect Google account with required scopes
  2. Check tool is enabled for your API key
  3. Verify you have access to the resource

"404 Not Found"

Cause: Property/account doesn't exist or no access

Fix:

  1. Verify property ID is correct
  2. Check you have access in Google Analytics
  3. Try listing properties first

"429 Too Many Requests"

Cause: Rate limit exceeded

Fix:

  1. Wait for limit to reset (midnight UTC)
  2. Reduce request frequency
  3. Consider upgrading to Pro tier

Getting Help

Check docs:

Report bugs: GitHub Issues

Next Steps

On this page

Troubleshooting | Metrifyr Docs | Metrifyr