Skip to content

codex-multi-profile

Multi-workspace profile router, MCP server isolation auditor, and CLAUDE.md <-> AGENTS.md instruction bridge for Claude Code and OpenAI Codex.

build.protocol_tooling.mcp#claude-code#mcp#model-context-protocol#codex#multi-profile#workspace-isolation#agents-md#claude-md#cli#developer-tools

Install codex-multi-profile in your MCP client

codex-multi-profile is a Model Context Protocol server. Add it to your MCP client config once, restart, and the server's tools become available to your AI assistant. The same JSON snippet below works across all four major clients — only the config file path differs.

  1. Locate your client's MCP config file.
    • Cursor: ~/.cursor/mcp.json
    • Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
    • Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json
    • VS Code: Settings → Extensions → MCP
    • Windsurf: Settings → MCP Servers
  2. Add codex-multi-profile to the mcpServers map — paste the snippet below into your config file. If you already have other MCP servers, merge the entry into the existing mcpServers object.
  3. Restart your client so it picks up the new server.
  4. Verify — ask the assistant to list available tools; codex-multi-profile's tools should appear.
{
  "mcpServers": {
    "codex-multi-profile": {
      "command": "npx",
      "args": [
        "-y",
        "codex-multi-profile"
      ]
    }
  }
}

Install codex-multi-profile in Cursor

Open ~/.cursor/mcp.json in your editor, paste the snippet above into mcpServers, save, and restart Cursor. codex-multi-profile will show up in the assistant's tool list on next launch.

Install codex-multi-profile in Claude Desktop (macOS)

Open ~/Library/Application Support/Claude/claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (macOS). codex-multi-profile will show up in the assistant's tool list on next launch.

Install codex-multi-profile in Claude Desktop (Windows)

Open %APPDATA%\Claude\claude_desktop_config.json in your editor, paste the snippet above into mcpServers, save, and restart Claude Desktop (Windows). codex-multi-profile will show up in the assistant's tool list on next launch.

Install codex-multi-profile in VS Code

Open Settings → Extensions → MCP in your editor, paste the snippet above into mcpServers, save, and restart VS Code. codex-multi-profile will show up in the assistant's tool list on next launch.

npm package: codex-multi-profile

Transport

codex-multi-profile supports the following MCP transports. Most AI clients use stdio by default for locally-installed servers.

stdio

From the codex-multi-profile README

# Codex Multi-Profile <p align="center"> <strong>Đổi tài khoản ChatGPT ngay trong menu avatar của Codex (bản Microsoft Store) trên Windows.</strong><br> Một app, một không gian làm việc: lịch sử chat, dự án, skill và cài đặt dùng chung. </p> <p align="center"> <a href="README.md">English</a> &middot; <a href="docs/architecture.md">Cách hoạt động</a> &middot; <a href="docs/troubleshooting.md">Khắc phục sự cố</a> </p> <p align="center"> <img src="docs/images/accounts-menu-vi.png" alt="Mục Tài khoản trong menu avatar của Codex: các tài khoản đã lưu kèm thanh mức sử dụng, Thêm tài khoản" width="366"> </p> > Công cụ không chính thức, không liên quan OpenAI. Dành cho người có nhiều tài khoản ChatGPT **hợp lệ** của chính mình. > Không dùng để chia sẻ tài khoản ha…

Other Model Context Protocol servers in the same space as codex-multi-profile. Each one adds different capabilities to your AI assistant — pick based on the data sources or workflows you need.

Browse the full MCP server directory or use Stork's one-line install to let your agent pick the right server automatically.