Connect Zero to Claude or Cursor

The MCP server lives at /api/v1/mcp on your ZeroReach host. In the examples below, replace https://your-zeroreach-host with the URL of your ZeroReach instance.

You can connect in three ways:

Option 1: OAuth connector (Claude.ai and others)

1. In your client, add a custom connector with the URL https://your-zeroreach-host/api/v1/mcp.
2. The client discovers ZeroReach's OAuth server and registers itself.
3. A browser window opens. Sign in to ZeroReach, choose the workspace the connector may use, and approve.
4. The client receives a token. It is short-lived (1 hour by default) and refreshed automatically (refresh tokens last 30 days by default).

The connection gets every scope except admin unless the client asks for fewer, and it is capped by your role. Signing out everywhere or changing your password disconnects it. You can revoke it in the app at any time.

Option 2: Remote with an API key

Create a key under Settings → API keys with the scopes the assistant needs: read scopes for a read-only assistant, write scopes for one that may draft and update. Then point your client at the endpoint with the key as a bearer token.

claude mcp add --transport http zeroreach https://your-zeroreach-host/api/v1/mcp \
  --header "Authorization: Bearer $ZEROREACH_API_KEY"

{
  "mcpServers": {
    "zeroreach": {
      "url": "https://your-zeroreach-host/api/v1/mcp",
      "headers": { "Authorization": "Bearer ro_pat_your_key_here" }
    }
  }
}

{
  "mcpServers": {
    "zeroreach": {
      "type": "http",
      "url": "https://your-zeroreach-host/api/v1/mcp",
      "headers": { "Authorization": "Bearer ro_pat_your_key_here" }
    }
  }
}

Option 3: Local process (stdio)

core-mcp is a small bridge for clients that launch a local command. It forwards each JSON-RPC message to the server's /api/v1/mcp with your key and prints the answers, so the tools, scopes, compliance gates and audit log are exactly the server's. Nothing runs locally and no database is needed.

{
  "mcpServers": {
    "zeroreach": {
      "command": "core-mcp",
      "env": {
        "REACHOUT_URL": "https://your-zeroreach-host",
        "REACHOUT_API_KEY": "ro_pat_your_key_here"
      }
    }
  }
}

The core-mcp binary is built from apps/core/crates/core-mcp (cargo build --release -p core-mcp).

Try it

Ask your assistant:

• "Who am I in ZeroReach?" It runs whoami: your workspace, local time and scopes.
• "What needs me today?" It runs get_daily_briefing.
• "Draft a follow-up to Ana about pricing." It runs draft_email. The draft waits in Approvals for you to send.

Troubleshooting