MCP Server Troubleshooting
Common issues and solutions for the Aurora MCP server.
Authentication Issues
"Subscription required" error
You need an active Aurora Intelligence subscription to use the MCP server. Sign in at aurora-intelligence.tech and ensure your subscription is active.
OAuth flow doesn't complete
- Make sure your browser allows popups from your AI client
- Try clearing cookies for
aurora-mcp.aurora-intelligence.workers.dev - If using Claude Desktop, restart the app after updating the config
Token expired
OAuth tokens expire after 7 days. Your AI client should automatically prompt you to re-authenticate. If not, remove and re-add the MCP server connection. To avoid the weekly re-login, use a Personal Access Token instead.
"Token has been revoked" / "Invalid personal access token"
The token was revoked from Profile → Personal Access Tokens (or the OAuth grant was revoked). Create a new token, or re-run the OAuth sign-in.
Write tools are missing
Tools like create_prompt only appear when the connection has write access: either check "Allow write access" on the OAuth consent screen, or create a Personal Access Token with write access enabled.
create_campaign is missing even though I granted write access
Campaign creation is a separate grant, not part of write access. Reconnect and tick the campaign-creation checkbox as well, or create a Personal Access Token with that option enabled. Existing tokens do not gain it retroactively — that is deliberate, since creating a campaign starts recurring billable tracking.
If the tool is present but the call returns Missing required scope: campaigns:write, the token itself lacks the grant; issue a new one.
Data Issues
No campaigns returned
- Verify you have at least one campaign in your Aurora dashboard
- Ensure you're signed in with the same account that owns the campaigns
Empty results for brand visibility / citations / keyword counts
- Check that the campaign has completed tracking jobs
- Try widening the date range or omitting date filters entirely
- New campaigns may take up to 24 hours to generate their first results
Data seems outdated
Aurora tracks AI providers on a scheduled basis. Data freshness depends on your campaign's tracking frequency. Check your campaign settings in the Aurora dashboard.
Connection Issues
"Failed to connect" in Claude Desktop
- Verify the URL is exactly:
https://aurora-mcp.aurora-intelligence.workers.dev/mcp - Check your internet connection
- Restart Claude Desktop
Server not responding
The MCP server runs on Cloudflare Workers with global availability. If you experience issues:
- Check Cloudflare Status for outages
- Try again in a few minutes
- Contact support at aurora-intelligence.tech if the issue persists