Connect Your AI Tool

Ready-to-paste Norbix MCP configuration for Claude, Cursor, VS Code, Windsurf, ChatGPT, and Gemini.

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

Before you start, create a service user and API key — see MCP Server → What you need.

Claude Desktop

Add to claude_desktop_config.json → mcpServers:

{
  "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.

Claude Code

One command:

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

Cursor

Add to .cursor/mcp.json (per project) or ~/.cursor/mcp.json (global):

{
  "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"
      }
    }
  }
}

VS Code

For GitHub Copilot agent mode, add to .vscode/mcp.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"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json — same JSON shape as Cursor:

{
  "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"
      }
    }
  }
}

ChatGPT

ChatGPT connects to remote MCP servers (Settings → Connectors, developer mode). Run the Norbix MCP server in remote mode on a host you control:

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.

Gemini CLI

Add to ~/.gemini/settings.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"
      }
    }
  }
}

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.