MCP SetupmacOS

MCP Setup on macOS

Connect Agent-CoreX to your IDE on macOS using the Model Context Protocol. The setup is nearly identical across clients — all you need is your API key and the MCP URL.

Last updated: April 2026

WindowsmacOSLinux

Prerequisites

•An Agent-CoreX API key — see Create an API Key
•For STDIO clients (Windsurf, Cline, Roo Code, Continue): the agent-corex CLI on your PATH (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

Copy the pre-filled URL from Dashboard → Connect → Humans tab. It includes your API key automatically.

VS Code

Option A — 1-click install

In the dashboard, go to Connect → Humans → VS Code and click the 1-click install button. VS Code opens and registers the server.

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

Option A — 1-click install

Go to Connect → Humans → Cursor in the dashboard and click the 1-click install button.

Option B — Manual config

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

Run in your terminal:

bash

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

Confirm the server is registered:

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

Restart Windsurf after saving.

Cline / Roo Code

Open the MCP Servers panel in the Cline or Roo Code extension and paste:

json

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

Other clients

Zed

Add to Zed settings.json under "context_servers":

Zed settings.json → context_servers

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

Continue

Add to Continue config.json under "mcpServers":

~/.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 / API

Use the HTTP SSE config:

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 →