@oxagen/mcp-install

CLI that writes the Oxagen MCP server config to your IDE. Supports Cursor, VS Code, Claude Code, Claude Desktop, Windsurf, Codex, and stdio.

Quickstart (recommended)

npx @oxagen/mcp-install init --agent cursor

This opens app.oxagen.ai/install-mcp in your browser. Authenticate with Google, pick a workspace, and the CLI writes the config file automatically — no token copy-paste required.

Agents: cursor | vscode | windsurf | claude-code | claude-desktop | codex | stdio

Manual install (token from env)

If you already have a token from Workspace → Settings → MCP in the Oxagen dashboard, you can write the config non-interactively:

export OXAGEN_MCP_TOKEN=oxa_live_xxx

# Cursor (.cursor/mcp.json in cwd)
npx @oxagen/mcp-install cursor --workspace ws_abc123

# VS Code (.vscode/mcp.json in cwd)
npx @oxagen/mcp-install vscode --workspace ws_abc123

# Claude Code (~/.claude/settings.json)
npx @oxagen/mcp-install claude-code --workspace ws_abc123

# Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json)
npx @oxagen/mcp-install claude-desktop --workspace ws_abc123

# Windsurf (~/.codeium/windsurf/mcp_config.json)
npx @oxagen/mcp-install windsurf --workspace ws_abc123

# Codex (~/.codex/mcp_config.json)
npx @oxagen/mcp-install codex --workspace ws_abc123

# stdio — prints JSON config to stdout
npx @oxagen/mcp-install stdio --workspace ws_abc123

Passing --token on argv exposes the value in ps aux — prefer the env var.