Connect an AI Tool

You need a Supercheck account with access to the project you want to share, and a server where MCP is turned on. Self-hosting? Follow Self-Hosted first.

Replace https://your-supercheck-host with your Supercheck URL (use http://localhost:3000 for a local install).

Claude CodeCopy Anchor Link

claude mcp add --transport http supercheck https://your-supercheck-host/api/mcp

Then run /mcp inside Claude Code, choose supercheck, and sign in.

CursorCopy Anchor Link

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (all projects):

{
  "mcpServers": {
    "supercheck": { "url": "https://your-supercheck-host/api/mcp" }
  }
}

VS CodeCopy Anchor Link

Add to .vscode/mcp.json:

{
  "servers": {
    "supercheck": { "type": "http", "url": "https://your-supercheck-host/api/mcp" }
  }
}

Claude Desktop, ChatGPT and other clientsCopy Anchor Link

Add a custom connector (or remote MCP server) and paste the URL https://your-supercheck-host/api/mcp. Any client that supports remote MCP servers with OAuth works. Clients that only speak stdio can bridge with npx mcp-remote https://your-supercheck-host/api/mcp.

The approval screenCopy Anchor Link

The first time a tool connects, your browser opens Supercheck:

1. Sign in if you are not already.
2. Check the app name. An app that proves its identity with a Client ID Metadata Document shows the host that controls it.
3. Choose one project. The list shows only projects you can access.
4. Select Approve. The tool returns to your editor and is connected.

Each connection is tied to one project. Connect again to share another project.

Try itCopy Anchor Link

Ask your AI tool:

• "Use Supercheck to list the failed runs from today."
• "Which monitors are down right now?"
• "Summarize the most recent incident and its root cause."

Manage or remove a connectionCopy Anchor Link

Open Connected apps from the user menu. Each row shows the app, the project and when it last refreshed its sign-in. Disconnect removes access immediately: the next call from that app is refused, even if it still holds a recent token.

Tool calls are recorded in the audit log with the user, app, project and duration (never arguments or results).

Request requirementsCopy Anchor Link

MCP clients must use Streamable HTTP and send Accept: application/json, text/event-stream on POST requests. The configured public host must match BETTER_AUTH_URL, including when Supercheck is behind a proxy. When a request carries an Origin header (browsers always send one), it must match the canonical resource origin or an origin allowed by the server's existing CORS policy, otherwise the server answers 403 invalid_request_origin. Command-line and desktop clients usually send no Origin and are not affected.

Supercheck checks that the OAuth client still exists and is enabled on every POST, and continues to verify consent and project access. Authentication errors use JSON-RPC responses while preserving the WWW-Authenticate and DPoP challenges. Responses are marked no-store.