Connect an MCP Client

OpRelay works with any MCP-compatible client. No SDK — just point, authenticate, and tools auto-discover.

Supported Clients

Client	Config Location	Notes
Claude Code	~/.claude/mcp.json	First-class support, recommended
Cursor	Settings → MCP Servers	Add URL + auth header
Codex CLI	~/.codex/mcp.json	Optimized for agent lane
Windsurf	Settings → MCP	URL-based connection
Custom agents	Your MCP client config	Any spec-compliant client

Configuration

All clients use the same connection format:

{
  "mcpServers": {
    "oprelay": {
      "url": "https://your-host/mcp",
      "headers": {
        "Authorization": "Bearer your-api-token"
      }
    }
  }
}

Generating API tokens

From the OpRelay dashboard:

1. Navigate to Settings → API Keys
2. Click Generate Token
3. Set scope (read-only, read-write, or admin)
4. Copy the token — it's only shown once

Verifying the connection

Once connected, your agent should see 30+ OpRelay tools. Test with:

List all projects in OpRelay

This calls list_projects and returns your project keys.

Multiple agents

Each agent gets its own token and registers independently. OpRelay tracks agent presence and can assign work based on agent capabilities and lane configuration.