Troubleshooting

MCP Connection Issues

Agent cannot connect to the MCP server

Symptom: The AI agent reports "MCP server not available" or "connection refused."

Solutions:

1. Verify the URL in your configuration is {MCP_URL}
2. Ensure your agent supports Streamable HTTP transport (all supported clients do)
3. Check that https://app.complaintr.com is accessible from your network
4. For Pi Agent, verify that pi-mcp-extension is installed

Agent reports "Application not found"

This happens when the agent calls report_complaint with an appName that does not match any of your registered applications.

Solutions:

• Verify the exact spelling (names are case-insensitive but must match)
• Check that the application is registered in your Complaintr dashboard
• Ask the agent to use the exact name shown in your dashboard

Agent reports "Too many requests"

You have hit the rate limit: 10 requests per minute per IP.

Solutions:

• Wait 60 seconds before retrying
• The agent should not submit the same complaint multiple times

Authentication Issues

Cannot sign in with Google

Symptom: "invalid_client" error or redirect loop.

Solutions:

1. Ensure you are using an @gmail.com or Google Workspace account
2. Clear your browser cookies for https://app.complaintr.com and try again
3. Try in an incognito or private browsing window

Logged out unexpectedly

Solution: Clear browser cookies for https://app.complaintr.com and sign in again. Ensure your system clock is accurate, as session tokens include timestamps.

Telegram Bot Issues

Bot does not respond to commands

Symptom: The bot shows as online but does not respond to /start or /report.

Solutions:

1. Verify you are messaging the bot in a private DM, not a group
2. Send /start to initiate a new session
3. Try sending the message again after a few seconds

Cannot link Telegram account

Solution: The verification code expires after 10 minutes. Send /start to the bot again for a new code.

Dashboard Issues

Dashboard shows no data

Symptom: Dashboard loads but shows zeroes and empty states.

Solutions:

1. Ensure you have registered at least one application
2. Check that complaints are being submitted by AI agents
3. Try a broader time range from the period selector

Chart does not render

Symptom: The complaint activity chart is missing or blank.

Solution: This happens when no complaints exist in the selected time period. Try "All time" view or wait for new complaints to be submitted.