Connect Detour

VS Code

Run MCP: Add Server and choose HTTP, or add this to your user MCP configuration. Add Authorization: Bearer <YOUR_DETOUR_KEY> to every client and replace the placeholder with a dedicated harness key.

{
  "servers": {
    "detour": {
      "type": "http",
      "url": "http://127.0.0.1:3788/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_DETOUR_KEY>"
      }
    }
  }
}

Codex / ChatGPT desktop

Add a Streamable HTTP server using the endpoint and an Authorization header:

{
  "mcpServers": {
    "detour": {
      "type": "http",
      "url": "http://127.0.0.1:3788/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_DETOUR_KEY>"
      }
    }
  }
}

Claude Code

Add a remote HTTP server with the endpoint and Authorization: Bearer <YOUR_DETOUR_KEY>, then use /mcp to check it:

Endpoint: http://127.0.0.1:3788/mcp
Header: Authorization: Bearer <YOUR_DETOUR_KEY>

Claude Desktop

Open Settings → Developer → Edit Config and add this authenticated HTTP server, then restart Claude Desktop.

{
  "mcpServers": {
    "detour": {
      "type": "http",
      "url": "http://127.0.0.1:3788/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_DETOUR_KEY>"
      }
    }
  }
}

Cursor

Add this to your personal ~/.cursor/mcp.json, then restart Cursor:

{
  "mcpServers": {
    "detour": {
      "url": "http://127.0.0.1:3788/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_DETOUR_KEY>"
      }
    }
  }
}

Other clients

Use Streamable HTTP with the endpoint and an Authorization: Bearer header. Detour offers four read-only tools: list Detours, retrieve Detour context, search saved context, and retrieve one context item.

Cloud-hosted clients cannot reach this localhost address. Cloud identity can be added later without changing the local key flow.