Skip to main content

Connect Claude Desktop

Connect Claude Desktop to your team's MCP servers through Bloque in about five minutes, using the mcp-remote bridge.

:::info claude.ai and mobile Claude's web and mobile apps connect to remote servers via custom connectors, which require OAuth. Bloque authenticates clients with API keys, so claude.ai and the mobile apps can't connect to Bloque at this time. Use Claude Desktop (below), Claude Code, or Codex instead. :::

1. Create a Bloque account​

Sign up at bloque.run with GitHub or email. A Hub is created for you automatically.

2. Add an MCP server​

Go to MCP Servers → Add Server and pick a server from the registry, paste a GitHub URL or npm package name, or enter connection details manually. See Add an MCP Server.

3. Generate an API key​

Open API Keys in the sidebar and create a key. Copy it — you'll paste it in the next step.

4. Connect Claude Desktop​

Claude Desktop's custom connectors use OAuth, but it also supports local MCP servers. Use the mcp-remote bridge locally to connect to Bloque and add your API key as a header.

Claude Desktop reads local MCP servers from claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the bloque entry (requires Node.js for npx):

{
  "mcpServers": {
    "bloque": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.bloque.run/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <your API key>"
      }
    }
  }
}

Replace <your API key> with the key from step 3, save, and restart Claude Desktop.

5. Try it​

Open a new chat. Bloque's tools appear under the Search and tools menu. Ask:

What tools do you have available from bloque?

Claude should list the tools from the servers you added in step 2. If nothing shows up, restart Claude Desktop and check the config file for JSON syntax errors.

What's next​