> For the complete documentation index, see [llms.txt](https://docs.codemash.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codemash.io/ai/connect-your-ai-tool.md).

# Connect Your AI Tool

Every setup below uses the same [MCP server](/ai/mcp-server.md) and the same three values: your **API key**, the **Hub URL** (`https://hub.norbix.ai`), and optionally a **project ID**.

{% hint style="info" %}
Before you start, create a service user and API key — see [MCP Server → What you need](/ai/mcp-server.md#what-you-need).
{% endhint %}

{% tabs %}
{% tab title="Claude Desktop" %}
Add to `claude_desktop_config.json` → `mcpServers`:

```json
{
  "mcpServers": {
    "norbix": {
      "command": "npx",
      "args": ["-y", "@norbix.ai/mcp"],
      "env": {
        "NORBIX_API_KEY": "your-api-key",
        "NORBIX_HUB_URL": "https://hub.norbix.ai",
        "NORBIX_PROJECT_ID": "your-project-id"
      }
    }
  }
}
```

Restart Claude Desktop. You should see the `norbix` tools in the tools menu.
{% endtab %}

{% tab title="Claude Code" %}
One command:

```bash
claude mcp add norbix \
  -e NORBIX_API_KEY=your-api-key \
  -e NORBIX_HUB_URL=https://hub.norbix.ai \
  -e NORBIX_PROJECT_ID=your-project-id \
  -- npx -y @norbix.ai/mcp
```

{% endtab %}

{% tab title="Cursor" %}
Add to `.cursor/mcp.json` (per project) or `~/.cursor/mcp.json` (global):

```json
{
  "mcpServers": {
    "norbix": {
      "command": "npx",
      "args": ["-y", "@norbix.ai/mcp"],
      "env": {
        "NORBIX_API_KEY": "your-api-key",
        "NORBIX_HUB_URL": "https://hub.norbix.ai",
        "NORBIX_PROJECT_ID": "your-project-id"
      }
    }
  }
}
```

{% endtab %}

{% tab title="VS Code" %}
For GitHub Copilot agent mode, add to `.vscode/mcp.json`:

```json
{
  "servers": {
    "norbix": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@norbix.ai/mcp"],
      "env": {
        "NORBIX_API_KEY": "your-api-key",
        "NORBIX_HUB_URL": "https://hub.norbix.ai"
      }
    }
  }
}
```

{% endtab %}

{% tab title="Windsurf" %}
Add to `~/.codeium/windsurf/mcp_config.json` — same JSON shape as Cursor:

```json
{
  "mcpServers": {
    "norbix": {
      "command": "npx",
      "args": ["-y", "@norbix.ai/mcp"],
      "env": {
        "NORBIX_API_KEY": "your-api-key",
        "NORBIX_HUB_URL": "https://hub.norbix.ai",
        "NORBIX_PROJECT_ID": "your-project-id"
      }
    }
  }
}
```

{% endtab %}

{% tab title="ChatGPT" %}
ChatGPT connects to **remote** MCP servers (Settings → Connectors, developer mode). Run the Norbix MCP server in [remote mode](/ai/mcp-server.md#remote-mode-streamable-http) on a host you control:

```bash
NORBIX_HUB_URL=https://hub.norbix.ai norbix-mcp --http --port 3010
```

Then add the connector in ChatGPT pointing to `https://your-host/mcp`. Put the server behind TLS, and pass the API key with the `Authorization: Bearer` header.
{% endtab %}

{% tab title="Gemini CLI" %}
Add to `~/.gemini/settings.json`:

```json
{
  "mcpServers": {
    "norbix": {
      "command": "npx",
      "args": ["-y", "@norbix.ai/mcp"],
      "env": {
        "NORBIX_API_KEY": "your-api-key",
        "NORBIX_HUB_URL": "https://hub.norbix.ai",
        "NORBIX_PROJECT_ID": "your-project-id"
      }
    }
  }
}
```

{% endtab %}
{% endtabs %}

### Try it

Ask your AI tool something like:

> "List my Norbix projects" · "Show the database schemas in project X" · "Create a collection called `orders` with fields for amount, currency, and status" · "Show me the last 20 error logs"

### Troubleshooting

* **Tools do not appear** — restart the client after editing the config file. Check that `npx -y @norbix.ai/mcp` runs in your terminal.
* **Auth errors** — the API key is missing or the service user's role does not allow the action. Check the key and role in *Membership → Service users*.
* **Wrong project** — set `NORBIX_PROJECT_ID`, or just ask the agent to switch: it can use the `norbix_set_project` tool.