connect

# Connect agents to MCP servers with mcptoon mcptoon keeps one config (`~/.mcptoon/config.json`) as the single source of truth for every MCP server an agent may use. It syncs that config into Claude Desktop, Claude Code, Cursor, Codex, Cline, Windsurf and VS Code, and can expose all servers through one stdio gateway (`mcptoon serve`). ## First move: look before you change anything ```bash mcptoon list # what servers are configured right now mcptoon doctor # config syntax + connectivity diagnosis ``` If `doctor` reports problems, fix those before adding anything new. ## Add servers ```bash mcptoon discover # scan + probe locally installed MCP servers mcptoon discover --write # and write what was found into config mcptoon add <name> --help # see add options for stdio/http servers mcptoon install <name> --npm @scope/pkg # from npm mcptoon install <name> --pip pkg # from pip mcptoon install <name> --url https://host/mcp # streamable-http / sse ``` After editing `~/.mcptoon/config.json` by hand, validate with `mcptoon doctor`. ## Sync one config to every agent ```bash mcptoon sync # write config into all detected agents mcptoon sync --dry # preview only mcptoon sync --agent claude # one agent only ``` ## Expose everything through one gateway (recommended for agents) Instead of registering N servers in an agent, register ONE: ```json { "mcpServers": { "mcptoon": { "command": "mcptoo...