MCP Setup

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

Supported Clients

Client	Remote MCP	Setup
OpenCode	Native	JSON config file
Claude Desktop	Native (Pro plan)	Settings > Connectors, or JSON config
Claude Code	Native	CLI command
Cursor	Native	JSON config file
Windsurf (Devin Desktop)	Native	JSON config file
Codex (OpenAI)	Native	CLI command or TOML config
Pi Agent	Via pi-mcp-extension	Extension + JSON config

OpenCode

Add to ~/.config/opencode/opencode.json (%USERPROFILE%\.config\opencode\opencode.json on Windows):

{
"mcp": {
  "complaintr": {
    "type": "remote",
    "url": "https://app.complaintr.com/api/mcp",
    "enabled": true
  }
}
}

Claude Desktop

Open Settings > Connectors and paste the URL:

https://app.complaintr.com/api/mcp

Or add to your claude_desktop_config.json:

{
"mcpServers": {
  "complaintr": {
    "type": "url",
    "url": "https://app.complaintr.com/api/mcp"
  }
}
}

OS	Config File Path
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

Claude Code

Run the following in your terminal:

claude mcp add complaintr --transport http https://app.complaintr.com/api/mcp

Cursor

Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):

{
"mcpServers": {
  "complaintr": {
    "url": "https://app.complaintr.com/api/mcp"
  }
}
}

Windsurf (Devin Desktop)

Add to ~/.codeium/windsurf/mcp_config.json:

{
"mcpServers": {
  "complaintr": {
    "serverUrl": "https://app.complaintr.com/api/mcp"
  }
}
}

Codex (OpenAI)

Run the CLI command:

codex mcp add complaintr --url https://app.complaintr.com/api/mcp

Or add to ~/.codex/config.toml:

[mcp_servers.complaintr]
url = "https://app.complaintr.com/api/mcp"

Pi Agent

First install the MCP extension:

pi install npm:pi-mcp-extension

Then add to ~/.pi/agent/mcp.json (or .pi/mcp.json at project level):

{
"mcpServers": {
  "complaintr": {
    "transport": "streamable-http",
    "url": "https://app.complaintr.com/api/mcp"
  }
}
}

Verification

After configuring, verify the connection by asking your agent:

"What MCP tools are available?"

The agent should list report_complaint among the available tools.

Tool: report_complaint

Parameter	Type	Required	Description
`appName`	string	Yes	The application name (max 100 chars)
`title`	string	Yes	Brief summary of the issue (max 200 chars)
`description`	string	Yes	Detailed explanation (max 5000 chars)
`sourceAgent`	string	No	Name of the AI agent (e.g., `"opencode"`, `"codex"`)
`metadata`	object	No	Additional context (URLs, stack traces, env info)

Example

{
  "appName": "my-web-app",
  "title": "Login button returns 500 error",
  "description": "Clicking the login button returns a 500 error instead of redirecting to the dashboard.",
  "sourceAgent": "opencode",
  "metadata": {
    "url": "https://app.example.com/login",
    "browser": "Chrome 125"
  }
}

Troubleshooting

Verify the MCP URL is {MCP_URL}
Ask the agent to list available tools to confirm the connection
Ensure your application is registered in the Complaintr dashboard

See Troubleshooting for more solutions.

MCP Setup

On this page