Add MCP Server
Add a new MCP server to .mcp.json (the single source of truth) and sync to all AI tool configs.
Steps
Parse the arguments:
$ARGUMENTS- Format:
<name> <url>for HTTP servers (e.g.loki http://loki-mcp.ablz.au:8081/stream) - Format:
<name> <command> [args...]for stdio servers (e.g.mcp-nixos uvx mcp-nixos) - If arguments are missing or ambiguous, ask the user.
- Format:
Read the current
.mcp.jsonfrom the repo root.Add the new server entry:
- For URLs (starts with
http://orhttps://):{"type": "http", "url": "<url>"} - For commands (anything else):
{"command": "<command>", "args": ["<remaining args>"]}
- For URLs (starts with
Write the updated
.mcp.json.Run the sync script to push to Codex:
python3 .claude/skills/sync-mcp/sync.pyReport what was added and remind the user to restart Claude Code for the new MCP server to take effect.