Agent skill
dex-add-mcp
Add an MCP server using Dex-safe scope (user by default)
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/dex-add-mcp
SKILL.md
Purpose
Add a new MCP server the safe way: user scope by default so your custom MCP survives Dex updates.
When to Use
- You want to add an MCP server without touching
.mcp.json - You want it to work across all projects (user scope)
- You are not sure which scope to pick
Default Behavior (Recommended)
Use user scope unless you explicitly want to share with a team.
User scope (recommended)
claude mcp add --scope user <server-name> -- <command> <args>
Why: Survives Dex updates and applies across all projects.
Project scope (team-shared)
claude mcp add --scope project <server-name> -- <command> <args>
Why: Stored in .mcp.json and shared with everyone on this repo.
Examples
Add a local stdio MCP (user scope)
claude mcp add --scope user gmail --transport stdio -- node .scripts/mcp/gmail-mcp.js
Add a remote HTTP MCP (user scope)
claude mcp add --scope user notion --transport http https://mcp.notion.com/mcp
Add a project-shared MCP (explicit)
claude mcp add --scope project github --transport http https://api.githubcopilot.com/mcp/
Guardrails
- If you are not sure, use user scope.
- Only use project scope if everyone should get the server.
- Do not add personal MCPs to
.mcp.json.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?