Agent Integration

🟣 Claude Code

Fastest: one command, then sign in when prompted:

claude mcp add --transport http elixium https://connect.elixium.ai/mcp

Or create .mcp.json in your project root (shared with your team; the X-Elixium-Board header pins the board for this repo):

{
  "mcpServers": {
    "elixium": {
      "type": "http",
      "url": "https://connect.elixium.ai/mcp",
      "headers": { "X-Elixium-Board": "<YOUR_BOARD_SLUG>" }
    }
  }
}

Run /mcp inside Claude Code to check the connection and complete the OAuth sign-in. Air-gapped? Use the stdio config shape below with "mcpServers" in .mcp.json.

🐙 GitHub Copilot (VS Code)

MCP support is GA as of VS Code 1.102. Create .vscode/mcp.json in your project — note Copilot uses the servers root key:

{
  "servers": {
    "elixium": {
      "type": "http",
      "url": "https://connect.elixium.ai/mcp",
      "headers": { "X-Elixium-Board": "<YOUR_BOARD_SLUG>" }
    }
  }
}

🎯 Cursor

Create .cursor/mcp.json in your project:

{
  "mcpServers": {
    "elixium": {
      "type": "http",
      "url": "https://connect.elixium.ai/mcp",
      "headers": { "X-Elixium-Board": "<YOUR_BOARD_SLUG>" }
    }
  }
}

Cursor signs in via OAuth on first use. Check Settings → MCP for connection status.

✨ Gemini / Google Antigravity

Configure the stdio server in your global or workspace MCP settings:

{
  "mcpServers": {
    "elixium": {
      "command": "npx",
      "args": ["-y", "@elixium.ai/mcp-server@latest"],
      "env": {
        "ELIXIUM_API_KEY": "<YOUR_API_KEY>",
        "ELIXIUM_API_URL": "https://<YOUR_TENANT>.elixium.ai/api",
        "ELIXIUM_BOARD_SLUG": "main",
        "ELIXIUM_USER_EMAIL": "<YOUR_EMAIL>"
      }
    }
  }
}

⌨️ OpenAI Codex CLI

Create .codex/mcp.json in your project:

{
  "mcpServers": {
    "elixium": {
      "command": "npx",
      "args": ["-y", "@elixium.ai/mcp-server@latest"],
      "env": {
        "ELIXIUM_API_KEY": "<YOUR_API_KEY>",
        "ELIXIUM_API_URL": "https://<YOUR_TENANT>.elixium.ai/api",
        "ELIXIUM_BOARD_SLUG": "main",
        "ELIXIUM_USER_EMAIL": "<YOUR_EMAIL>"
      }
    }
  }
}

Codex does not support per-server request headers — pin the board with ELIXIUM_BOARD_SLUG (stdio) or select_board in-session.

🏄 Windsurf

Create .windsurf/mcp.json in your project:

{
  "mcpServers": {
    "elixium": {
      "command": "npx",
      "args": ["-y", "@elixium.ai/mcp-server@latest"],
      "env": {
        "ELIXIUM_API_KEY": "<YOUR_API_KEY>",
        "ELIXIUM_API_URL": "https://<YOUR_TENANT>.elixium.ai/api",
        "ELIXIUM_BOARD_SLUG": "main",
        "ELIXIUM_USER_EMAIL": "<YOUR_EMAIL>"
      }
    }
  }
}

Windsurf does not support per-server request headers — pin the board with ELIXIUM_BOARD_SLUG (stdio) or select_board in-session.

🟠 Claude Desktop — offline / key-based alternative

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "elixium": {
      "command": "npx",
      "args": ["-y", "@elixium.ai/mcp-server@latest"],
      "env": {
        "ELIXIUM_API_KEY": "<YOUR_API_KEY>",
        "ELIXIUM_API_URL": "https://<YOUR_TENANT>.elixium.ai/api",
        "ELIXIUM_BOARD_SLUG": "main",
        "ELIXIUM_USER_EMAIL": "<YOUR_EMAIL>"
      }
    }
  }
}

• Remote entries (Claude Code, Copilot, Cursor): set the X-Elixium-Board header on the server entry, as shown in the configs above. The pin lives in the repo, so every teammate and every session lands on the same board.
• Stdio configs (all agents): set ELIXIUM_BOARD_SLUG in the env block.
• Agents without header support (Codex, Windsurf) on remote entries: ask the agent to call select_board at the start of the session — the choice also persists as your server-side default for later sessions.

Find your board slug in the board URL — e.g. my-project from elixium.ai/tenant/myteam/board/my-project.

Remote connection: nothing to install. The stdio MCP server runs via npx (included with Node.js) — no separate installation required; it downloads automatically on first use.

Quick Diagnostic Checklist

1. Restart your IDE / agent — MCP servers are loaded at startup. After changing config, you must fully restart (not just reload the window). For Claude Code: exit with Ctrl+C or /exit, then relaunch.
2. Test the command in your terminal first — Run the server manually to check for errors:
   npx -y @elixium.ai/mcp-server@latest
   If this fails or hangs, your IDE won't be able to start it either.
3. Verify Node.js is available — The stdio MCP server requires Node.js 18+:
   node --version # Should be v18+
4. Check the config key name — GitHub Copilot uses "servers", all others use "mcpServers". Using the wrong key silently fails.
5. Verify your API key — Go to your workspace Command Center (Profile tab) and confirm the key is active and not revoked.

IDE-Specific Diagnostics