Troubleshooting

Common issues and how to resolve them

"Authentication required" error

You need to authenticate before using the server:

npx mcp-google-marketing login

Then restart Claude Code to reconnect the MCP server.

"Google OAuth connection is no longer valid"

Your Google connection may have expired or been revoked:

npx mcp-google-marketing login

This will re-authenticate and refresh your connection.

Port 8085 already in use

The login callback server uses port 8085:

# Find and stop the process using that port
lsof -i :8085
kill <PID>

Check authentication status

Verify your authentication is working:

npx mcp-google-marketing status

Expected output when authenticated:

✓ Authenticated with Metrifyr
  API Key: mtfr_****...****
  Config file: ~/.credentials/config.json
  Metrifyr URL: https://www.metrifyr.cloud

✓ Ready to use Google Marketing tools!

Migration from v1.x

If you were using the previous version with local OAuth:

Your old .credentials/tokens.json file is no longer used
Run npx mcp-google-marketing login to authenticate via Metrifyr
Update your Claude Code registration (remove --env flags):

claude mcp remove google-marketing
claude mcp add google-marketing npx mcp-google-marketing

Claude Code Not Recognizing Tools

If Claude Code doesn't see the MCP tools:

Check the server is registered:
```
claude mcp list
```

Re-register if needed:

claude mcp add google-marketing npx mcp-google-marketing

Restart Claude Code