MCP SetupLinux

MCP Setup on Linux

Connect Agent-CoreX to your IDE on Linux. Config file paths follow XDG conventions — identical to macOS for most clients.

Last updated: April 2026

Windows macOSLinux

Prerequisites

•An Agent-CoreX API key — see Create an API Key
•For STDIO clients: Python 3.8+ and pip install agent-corex

Your MCP URL

Your MCP SSE URL

https://api.agent-corex.com/mcp/sse?api_key=acx_your_api_key_here

Your pre-filled URL (with API key) is available under Dashboard → Connect → Humans tab.

VS Code

Option A — 1-click install

In the dashboard, go to Connect → Humans → VS Code and use the 1-click install button to trigger the vscode:mcp/install deep link.

Option B — Manual (.vscode/mcp.json)

.vscode/mcp.json

{
  "mcpServers": {
    "agent-corex": {
      "url": "https://api.agent-corex.com/mcp/sse?api_key=acx_your_api_key_here"
    }
  }
}

Cursor

Edit ~/.cursor/mcp.json:

~/.cursor/mcp.json

{
  "mcpServers": {
    "agent-corex": {
      "url": "https://api.agent-corex.com/mcp/sse?api_key=acx_your_api_key_here"
    }
  }
}

Claude Code

bash

claude mcp add --transport sse agent-corex "https://api.agent-corex.com/mcp/sse?api_key=acx_your_api_key_here"

bash

claude mcp list

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "agent-corex": {
      "command": "agent-corex",
      "args": [
        "serve"
      ],
      "env": {
        "AGENT_COREX_API_KEY": "acx_your_api_key_here"
      }
    }
  }
}

Cline / Roo Code

json

{
  "mcpServers": {
    "agent-corex": {
      "command": "agent-corex",
      "args": [
        "serve"
      ],
      "env": {
        "AGENT_COREX_API_KEY": "acx_your_api_key_here"
      }
    }
  }
}

Other clients

Zed

Zed settings.json → context_servers

{
  "agent-corex": {
    "command": {
      "path": "agent-corex",
      "args": [
        "serve"
      ]
    },
    "settings": {}
  }
}

Continue

~/.continue/config.json

{
  "name": "agent-corex",
  "command": "agent-corex",
  "args": [
    "serve"
  ],
  "env": {
    "AGENT_COREX_API_KEY": "acx_your_api_key_here"
  }
}

Gemini CLI / Amazon Q / Direct API

HTTP SSE config

{
  "mcpServers": {
    "agent-corex": {
      "url": "https://api.agent-corex.com/mcp/sse?api_key=acx_your_api_key_here"
    }
  }
}

Verify your setup

Once your IDE is connected, make a query and confirm it appears in your usage dashboard. Check Queries Used →