{"id":"659053ae-7bb5-42b5-9b49-38e47486f50f","shortId":"j74wdK","kind":"skill","title":"mcp-management","tagline":"Search, install, configure, update, and remove MCP servers across coding agents (Claude Code, Cursor, VS Code, Claude Desktop, Gemini CLI, Codex, Goose, Zed, and more). Supports multi-agent installation via npx add-mcp, the official MCP registry, and direct config editing.","description":"# MCP Server Management\n\n**IMPORTANT**: After adding, removing, or updating MCP servers, inform the user to **restart the affected agent** for changes to take effect.\n\n**CRITICAL**: Before removing any server, use `AskUserQuestion` to confirm with the user.\n\n## Quick Reference (Claude Code)\n\n```bash\n# Install\nclaude mcp add --transport http <name> <url>\nclaude mcp add --transport stdio <name> -- <command> [args...]\nclaude mcp add-json <name> '<json>'              # Full JSON config in one shot\n\n# List/inspect\nclaude mcp list\nclaude mcp get <name>\n\n# Remove (confirm with user first!)\nclaude mcp remove <name>\n\n# OAuth login/logout (for OAuth-protected HTTP servers)\nclaude mcp login <name>\nclaude mcp logout <name>\n```\n\nOptions must come BEFORE the server name. As of 2026-04, `--transport http` (Streamable HTTP) is recommended; `sse` is end-of-life.\n\nPlugin MCP servers connect automatically at session start. Use `/reload-plugins` to re-init after enabling/disabling a plugin mid-session.\n\n## Multi-Agent Installation (npx add-mcp)\n\nInstall MCP servers to multiple coding agents at once using [add-mcp](https://github.com/neondatabase/add-mcp):\n\n```bash\n# Remote server (HTTP)\nnpx add-mcp https://mcp.example.com/mcp\n\n# npm package (stdio)\nnpx add-mcp @modelcontextprotocol/server-postgres\n\n# Local command\nnpx add-mcp \"npx -y @org/mcp-server --flag value\"\n\n# SSE transport\nnpx add-mcp https://mcp.example.com/sse --transport sse\n```\n\n### Options\n\n| Flag | Description |\n|------|-------------|\n| `-g, --global` | Install globally instead of project-level |\n| `-a, --agent <agent>` | Target specific agent(s), repeatable |\n| `-n, --name <name>` | Custom server name |\n| `-t, --transport <type>` | HTTP (default) or SSE |\n| `--header <header>` | Custom HTTP headers, repeatable |\n| `-y, --yes` | Skip confirmation prompts |\n| `--all` | Install to all detected agents |\n\n### Supported Agents\n\n| Agent | CLI Argument | Supports Project-Level |\n|-------|-------------|----------------------|\n| Claude Code | `claude-code` | Yes (`.mcp.json`) |\n| Claude Desktop | `claude-desktop` | No (global only) |\n| Cursor | `cursor` | Yes (`.cursor/mcp.json`) |\n| VS Code | `vscode` | Yes (`.vscode/mcp.json`) |\n| Gemini CLI | `gemini-cli` | Yes (`.gemini/settings.json`) |\n| Codex | `codex` | Yes (`.codex/config.toml`, trusted projects only) |\n| Goose | `goose` | No (global only) |\n| GitHub Copilot CLI | `github-copilot-cli` | Yes (`.vscode/mcp.json`) |\n| OpenCode | `opencode` | Yes (`opencode.json`) |\n| Zed | `zed` | Yes (`.zed/settings.json`) |\n\n### Examples\n\n```bash\n# Install to Claude Code and Cursor only\nnpx add-mcp -a claude-code -a cursor https://mcp.stripe.com\n\n# Install npm package to all agents, globally\nnpx add-mcp -g --all @modelcontextprotocol/server-postgres\n\n# Install with custom name and headers\nnpx add-mcp -n my-api --header \"Authorization: Bearer TOKEN\" https://api.example.com/mcp\n\n# List available agents\nnpx add-mcp list-agents\n```\n\nSee [references/multi-agent.md](references/multi-agent.md) for agent-specific config paths, formats, and transformations.\n\n## Searching for MCP Servers\n\nWhen users ask to find or install an MCP server, see [references/search.md](references/search.md) for:\n- Official vendor server lookup (always try first)\n- MCP Registry API queries (fallback)\n- Known official servers table\n- User choice template format\n\n**Trust hierarchy**: Official vendor > MCP reference servers > Verified partners > Community\n\n## Adding Servers (Claude Code)\n\n### With Environment Variables\n\nThe `--env` CLI flag is unreliable with special characters. Instead:\n\n1. Add server without env vars:\n   ```bash\n   claude mcp add --transport stdio <name> -- npx -y @package/mcp-server\n   ```\n\n2. Edit config file to add env vars. See [references/scopes.md](references/scopes.md) for file locations.\n\n### Collect Configuration First\n\nBefore installing, check if the server needs API keys or tokens. Use `AskUserQuestion` to collect required values before running install commands.\n\n## Updating Servers\n\nNo direct update command exists. Options:\n\n1. **Edit config directly** (preferred for credential changes)\n2. **Remove and re-add** (confirm removal with user first)\n3. **Use environment variables** for credentials that change often\n\nFor OAuth servers (GitHub, Sentry): Run `/mcp` in Claude Code to re-authenticate.\n\n## Removing Servers\n\nAlways confirm with user via `AskUserQuestion` before removing.\n\n```bash\nclaude mcp remove <server-name>\n```\n\nFor project-scoped servers in `.mcp.json`, delete the entry from the file after user confirmation.\n\n## OpenCode-specific notes\n\nFor OpenCode (anomalyco/opencode v1.14.x):\n- Top-level key is `mcp` (not `mcpServers`); each server **must** declare `type: \"local\"` or `type: \"remote\"`\n- For local servers, `command` is a single array `[\"bin\", \"arg1\", \"arg2\"]` — there's no separate `args` field\n- Env vars go under `environment` (not `env`)\n- Per-server `enabled: false` disables without removing\n- Use `opencode mcp auth <name>` / `opencode mcp logout <name>` for OAuth servers (e.g., GitHub)\n- Plugin `tool.execute.*` hooks **do not** fire for MCP tool calls in v1.14.x — use `permission` rules instead\n\nSee [references/opencode-mcp.md](references/opencode-mcp.md) for the full OpenCode MCP reference.\n\n## Reference\n\n- **Search and known servers**: [references/search.md](references/search.md)\n- **Multi-agent installation**: [references/multi-agent.md](references/multi-agent.md)\n- **OpenCode MCP**: [references/opencode-mcp.md](references/opencode-mcp.md)\n- **Transport types**: [references/transports.md](references/transports.md)\n- **Scopes and config files**: [references/scopes.md](references/scopes.md)\n- **Troubleshooting**: [references/troubleshooting.md](references/troubleshooting.md)\n\n## Scopes Summary (Claude Code)\n\n| Scope | Flag | Config Location | Use Case |\n|-------|------|-----------------|----------|\n| Local | `--scope local` (default) | `~/.claude.json` | Personal dev servers |\n| Project | `--scope project` | `.mcp.json` | Team-shared servers |\n| User | `--scope user` | `~/.claude.json` | Cross-project tools |\n\n## Environment Variable Syntax\n\nIn config files: `${VAR}` or `${VAR:-default}`\n\n## Windows Note\n\nUse `cmd /c` wrapper for npx:\n```bash\nclaude mcp add --transport stdio my-server -- cmd /c npx -y @some/package\n```","tags":["mcp","management","driven","development","codealive-ai","agent-safety","agent-skills","ai-coding","ai-driven-development","ai-safety","antigravity","bash"],"capabilities":["skill","source-codealive-ai","skill-mcp-management","topic-agent-safety","topic-agent-skills","topic-ai-coding","topic-ai-driven-development","topic-ai-safety","topic-antigravity","topic-bash","topic-claude-code","topic-codex-cli","topic-cursor","topic-developer-tools","topic-gemini-cli"],"categories":["ai-driven-development"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/CodeAlive-AI/ai-driven-development/mcp-management","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add CodeAlive-AI/ai-driven-development","source_repo":"https://github.com/CodeAlive-AI/ai-driven-development","install_from":"skills.sh"}},"qualityScore":"0.483","qualityRationale":"deterministic score 0.48 from registry signals: · indexed on github topic:agent-skills · 67 github stars · SKILL.md body (6,322 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T18:57:06.968Z","embedding":null,"createdAt":"2026-05-04T06:56:23.361Z","updatedAt":"2026-05-18T18:57:06.968Z","lastSeenAt":"2026-05-18T18:57:06.968Z","tsv":"'-04':150 '/.claude.json':777,792 '/c':811,825 '/mcp':218,418,601 '/neondatabase/add-mcp):':207 '/reload-plugins':172 '/sse':246 '1':506,567 '2':521,575 '2026':149 '3':586 'across':12 'ad':52,489 'add':37,91,96,103,190,203,214,224,231,242,375,393,406,424,507,515,526,580,818 'add-json':102 'add-mcp':36,189,202,213,223,230,241,374,392,405,423 'affect':64 'agent':14,32,65,186,198,262,265,294,296,297,389,421,428,434,742 'agent-specif':433 'alway':463,611 'anomalyco/opencode':645 'api':411,468,545 'api.example.com':417 'api.example.com/mcp':416 'arg':99,679 'arg1':673 'arg2':674 'argument':299 'array':671 'ask':447 'askuserquest':77,550,616 'auth':699 'authent':608 'author':413 'automat':167 'avail':420 'bash':87,208,365,512,619,815 'bearer':414 'bin':672 'call':717 'case':772 'chang':67,574,593 'charact':504 'check':540 'choic':476 'claud':15,20,85,89,94,100,112,115,123,134,137,304,307,311,314,368,379,491,513,603,620,765,816 'claude-cod':306,378 'claude-desktop':313 'cli':23,298,329,332,349,353,498 'cmd':810,824 'code':13,16,19,86,197,305,308,324,369,380,492,604,766 'codex':24,335,336 'codex/config.toml':338 'collect':535,552 'come':142 'command':228,558,564,667 'communiti':488 'config':45,107,436,523,569,756,769,801 'configur':6,536 'confirm':79,119,287,581,612,638 'connect':166 'copilot':348,352 'credenti':573,591 'critic':71 'cross':794 'cross-project':793 'cursor':17,319,320,371,382 'cursor/mcp.json':322 'custom':270,280,400 'declar':658 'default':276,776,806 'delet':630 'descript':251 'desktop':21,312,315 'detect':293 'dev':779 'direct':44,562,570 'disabl':693 'e.g':706 'edit':46,522,568 'effect':70 'enabl':691 'enabling/disabling':178 'end':160 'end-of-lif':159 'entri':632 'env':497,510,527,681,687 'environ':494,588,685,797 'exampl':364 'exist':565 'fallback':470 'fals':692 'field':680 'file':524,533,635,757,802 'find':449 'fire':713 'first':122,465,537,585 'flag':236,250,499,768 'format':438,478 'full':105,729 'g':252,395 'gemini':22,328,331 'gemini-c':330 'gemini/settings.json':334 'get':117 'github':347,351,598,707 'github-copilot-c':350 'github.com':206 'github.com/neondatabase/add-mcp):':205 'global':253,255,317,345,390 'go':683 'goos':25,342,343 'header':279,282,403,412 'hierarchi':480 'hook':710 'http':93,132,152,154,211,275,281 'import':50 'inform':58 'init':176 'instal':5,33,88,187,192,254,290,366,384,398,451,539,557,743 'instead':256,505,723 'json':104,106 'key':546,650 'known':471,736 'level':260,303,649 'life':162 'list':114,419,427 'list-ag':426 'list/inspect':111 'local':227,660,665,773,775 'locat':534,770 'login':136 'login/logout':127 'logout':139,702 'lookup':462 'manag':3,49 'mcp':2,10,38,41,47,56,90,95,101,113,116,124,135,138,164,191,193,204,215,225,232,243,376,394,407,425,443,453,466,483,514,621,652,698,701,715,731,747,817 'mcp-manag':1 'mcp.example.com':217,245 'mcp.example.com/mcp':216 'mcp.example.com/sse':244 'mcp.json':310,629,784 'mcp.stripe.com':383 'mcpserver':654 'mid':182 'mid-sess':181 'modelcontextprotocol/server-postgres':226,397 'multi':31,185,741 'multi-ag':30,184,740 'multipl':196 'must':141,657 'my-api':409 'my-serv':821 'n':268,408 'name':146,269,272,401 'need':544 'note':642,808 'npm':219,385 'npx':35,188,212,222,229,233,240,373,391,404,422,518,814,826 'oauth':126,130,596,704 'oauth-protect':129 'offici':40,459,472,481 'often':594 'one':109 'opencod':356,357,640,644,697,700,730,746 'opencode-specif':639 'opencode.json':359 'option':140,249,566 'org/mcp-server':235 'packag':220,386 'package/mcp-server':520 'partner':487 'path':437 'per':689 'per-serv':688 'permiss':721 'person':778 'plugin':163,180,708 'prefer':571 'project':259,302,340,625,781,783,795 'project-level':258,301 'project-scop':624 'prompt':288 'protect':131 'queri':469 'quick':83 're':175,579,607 're-add':578 're-authent':606 're-init':174 'recommend':156 'refer':84,484,732,733 'references/multi-agent.md':430,431,744,745 'references/opencode-mcp.md':725,726,748,749 'references/scopes.md':530,531,758,759 'references/search.md':456,457,738,739 'references/transports.md':752,753 'references/troubleshooting.md':761,762 'registri':42,467 'remot':209,663 'remov':9,53,73,118,125,576,582,609,618,622,695 'repeat':267,283 'requir':553 'restart':62 'rule':722 'run':556,600 'scope':626,754,763,767,774,782,790 'search':4,441,734 'see':429,455,529,724 'sentri':599 'separ':678 'server':11,48,57,75,133,145,165,194,210,271,444,454,461,473,485,490,508,543,560,597,610,627,656,666,690,705,737,780,788,823 'session':169,183 'share':787 'shot':110 'singl':670 'skill' 'skill-mcp-management' 'skip':286 'some/package':828 'source-codealive-ai' 'special':503 'specif':264,435,641 'sse':157,238,248,278 'start':170 'stdio':98,221,517,820 'streamabl':153 'summari':764 'support':29,295,300 'syntax':799 'tabl':474 'take':69 'target':263 'team':786 'team-shar':785 'templat':477 'token':415,548 'tool':716,796 'tool.execute':709 'top':648 'top-level':647 'topic-agent-safety' 'topic-agent-skills' 'topic-ai-coding' 'topic-ai-driven-development' 'topic-ai-safety' 'topic-antigravity' 'topic-bash' 'topic-claude-code' 'topic-codex-cli' 'topic-cursor' 'topic-developer-tools' 'topic-gemini-cli' 'transform':440 'transport':92,97,151,239,247,274,516,750,819 'tri':464 'troubleshoot':760 'trust':339,479 'type':659,662,751 'unreli':501 'updat':7,55,559,563 'use':76,171,201,549,587,696,720,771,809 'user':60,82,121,446,475,584,614,637,789,791 'v1.14.x':646,719 'valu':237,554 'var':511,528,682,803,805 'variabl':495,589,798 'vendor':460,482 'verifi':486 'via':34,615 'vs':18,323 'vscode':325 'vscode/mcp.json':327,355 'window':807 'without':509,694 'wrapper':812 'y':234,284,519,827 'yes':285,309,321,326,333,337,354,358,362 'zed':26,360,361 'zed/settings.json':363","prices":[{"id":"c778b881-3a2e-4517-a271-bf8400229685","listingId":"659053ae-7bb5-42b5-9b49-38e47486f50f","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"CodeAlive-AI","category":"ai-driven-development","install_from":"skills.sh"},"createdAt":"2026-05-04T06:56:23.361Z"}],"sources":[{"listingId":"659053ae-7bb5-42b5-9b49-38e47486f50f","source":"github","sourceId":"CodeAlive-AI/ai-driven-development/mcp-management","sourceUrl":"https://github.com/CodeAlive-AI/ai-driven-development/tree/main/skills/mcp-management","isPrimary":false,"firstSeenAt":"2026-05-04T06:56:23.361Z","lastSeenAt":"2026-05-18T18:57:06.968Z"}],"details":{"listingId":"659053ae-7bb5-42b5-9b49-38e47486f50f","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"CodeAlive-AI","slug":"mcp-management","github":{"repo":"CodeAlive-AI/ai-driven-development","stars":67,"topics":["agent-safety","agent-skills","ai-coding","ai-driven-development","ai-safety","antigravity","bash","claude-code","codex-cli","cursor","developer-tools","gemini-cli","hooks","mcp","multi-agent","opencode","plugins","prompt-engineering","skills","subagents"],"license":"mit","html_url":"https://github.com/CodeAlive-AI/ai-driven-development","pushed_at":"2026-05-12T20:04:46Z","description":"Practices, protocols, and skills for AI-driven software development. 18 skills + 1 Bash safety hook for Claude Code, Codex CLI, OpenCode, Cursor, Gemini CLI, Antigravity, and any agent supporting the Agent Skills standard.","skill_md_sha":"1f1ce4e435a92990ee3092becfcf6b0b3f8c6f31","skill_md_path":"skills/mcp-management/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/CodeAlive-AI/ai-driven-development/tree/main/skills/mcp-management"},"layout":"multi","source":"github","category":"ai-driven-development","frontmatter":{"name":"mcp-management","description":"Search, install, configure, update, and remove MCP servers across coding agents (Claude Code, Cursor, VS Code, Claude Desktop, Gemini CLI, Codex, Goose, Zed, and more). Supports multi-agent installation via npx add-mcp, the official MCP registry, and direct config editing."},"skills_sh_url":"https://skills.sh/CodeAlive-AI/ai-driven-development/mcp-management"},"updatedAt":"2026-05-18T18:57:06.968Z"}}