Connect your AI tool

There are two ways to sign in. Apps with a connector screen, such as Claude and ChatGPT, use Sign in with Distru. Developer tools that take a config file use an MCP API key.

The server's URL is the same for both:

https://mcp.distru.com/mcp

Sign in with DistruCopy Anchor Link

Sign in with Distru asks for two scopes: mcp:read to use read tools and mcp:write to use write tools.

ClaudeCopy Anchor Link

1. In Claude (web or desktop), open Settings → Connectors and click Add custom connector. Organization owners can add it once for everyone under Organization settings → Connectors.
2. Paste the server URL.
3. Click Connect, sign in to Distru and approve access. Claude can now use Distru in any chat where the connector is turned on.

ChatGPTCopy Anchor Link

ChatGPT connects through a developer mode connector. It works on the web only, on the Plus, Pro, Business, Enterprise and Education plans. On Business, Enterprise and Education, an admin must turn on developer mode for the workspace first.

1. On the web, open Settings → Apps → Advanced settings and turn on Developer mode.
2. Go to Apps & Connectors → Create and paste the server URL.
3. Choose OAuth for authentication, run Scan tools and save.
4. The first time you use the connector, ChatGPT opens the Distru sign-in. Sign in and approve access.

MCP API keyCopy Anchor Link

In Distru, go to Settings → Distru MCP and create a key. It starts with distru_mcp_. Treat it like a password: it acts as you, with your permissions. Revoking it takes effect immediately.

Creating a key needs the Manage MCP API Keys permission on your role, and the settings page doesn't show without it. Admin roles have it. For any other role, an admin can turn it on when editing the role. If it's missing, ask your Customer Support Representative.

Send the key as a Bearer token on every request. In the examples below, replace distru_mcp_your_key with your key.

Claude CodeCopy Anchor Link

claude mcp add --transport http distru https://mcp.distru.com/mcp --header "Authorization: Bearer distru_mcp_your_key"

CursorCopy Anchor Link

Add this to ~/.cursor/mcp.json on macOS and Linux, %USERPROFILE%\.cursor\mcp.json on Windows, or .cursor/mcp.json in the repository root for a single project. Don't commit the repository file: it holds your key. If the file already has an mcpServers block, add just the distru entry inside it.

{
  "mcpServers": {
    "distru": {
      "headers": {
        "Authorization": "Bearer distru_mcp_your_key"
      },
      "url": "https://mcp.distru.com/mcp"
    }
  }
}

VS CodeCopy Anchor Link

Add this to .vscode/mcp.json in your workspace. Don't commit this file: it holds your key. VS Code uses a top-level servers field, unlike most other tools.

{
  "servers": {
    "distru": {
      "headers": {
        "Authorization": "Bearer distru_mcp_your_key"
      },
      "type": "http",
      "url": "https://mcp.distru.com/mcp"
    }
  }
}

WindsurfCopy Anchor Link

Add this to ~/.codeium/windsurf/mcp_config.json on macOS and Linux, or %USERPROFILE%\.codeium\windsurf\mcp_config.json on Windows. Windsurf uses serverUrl, not url.

{
  "mcpServers": {
    "distru": {
      "headers": {
        "Authorization": "Bearer distru_mcp_your_key"
      },
      "serverUrl": "https://mcp.distru.com/mcp"
    }
  }
}

Composio and similar platformsCopy Anchor Link

Choose the API key auth type and paste the key.

Read-only accessCopy Anchor Link

To give an assistant read access only, add this header to its config. Write tools then disappear from its tool list, and calling one fails.

x-distru-filter-tool-tags: read