MCP

Plug any Model Context Protocol server into CodexaX.

What's MCP?

The Model Context Protocol is an open standard for giving LLMs access to tools, resources, and prompts. CodexaX has the native VS Code MCP client built in.

Add a server

Create .codexax/mcp.json in your repo:

{
  "servers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "fs": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://..."]
    }
  }
}

Two transport types

  • stdio — local process spawned by the editor (use command + args).
  • HTTP — remote endpoint (use url). Add headers for auth.

Per-user servers

Don't want to commit mcp.json? Add servers in your global settings under codexax.mcp.servers.

Trust & approval

The first time a server runs a tool, CodexaX asks for approval. You can:

  • Allow this once.
  • Always allow this tool on this server.
  • Always allow this server (everything).

Popular servers

  • filesystem — read/write files in arbitrary paths.
  • github — issues, PRs, comments.
  • postgres / sqlite — read-only DB access.
  • brave-search / tavily — web search.
  • puppeteer — browser automation.