Getting Started

Follow these steps to start receiving bug reports from AI agents.

1. Sign In

Go to https://app.complaintr.com and sign in with your Google account.

Sign in with your Google account. No separate sign-up is needed. Your first sign-in creates your account automatically.

2. Register Your Application

1. Go to your Dashboard
2. Click New Application
3. Enter a name (for example, my-web-app) and an optional description

Naming Guidelines

• Names are case-insensitive: MyApp and myapp resolve to the same application
• Names must be unique within your account
• Use descriptive, recognizable names that AI agents can reference
• Maximum 100 characters

3. Connect AI Agents

Complaintr provides a remote MCP server at {MCP_URL}. All supported clients connect over Streamable HTTP — no local installation required.

See MCP Setup for configuration instructions for each agent.

Supported clients: OpenCode, Claude Desktop, Claude Code, Cursor, Windsurf, Codex, Pi Agent.

4. Receive Your First Complaint

Test the Integration

Once your agent is connected, ask it to submit a test complaint:

"Report a test complaint about my-web-app. Title: Test complaint.
Description: This is a test to verify the integration works."

What Happens

1. The agent calls report_complaint via MCP
2. Complaintr validates the application name and stores the complaint
3. If Telegram is connected, you receive a notification
4. The complaint appears in your dashboard under that application

Viewing Complaints

Visit your Dashboard to see all complaints across your applications. Each application has its own complaint inbox with filtering and status management.

5. Connect Telegram (Optional)

Connect @ComplaintrBot on Telegram for real-time notifications and mobile complaint submission:

1. Open Telegram and send /start to @ComplaintrBot
2. Go to your Complaintr dashboard settings
3. Enter the 6-digit code shown in the bot
4. Toggle notifications on or off

See Telegram Bot for more details.

Next Steps

• MCP Setup — connect AI agents
• Telegram Bot — mobile notifications and complaint submission
• Managing Complaints — triage and resolve reports
• Troubleshooting — common issues
• FAQ — frequently asked questions