AI Builder - MCP Server Management
This skill assists in adding MCP servers to CLI AI agents (Claude, Codex, Gemini, etc.) with the correct transport, scope, and configuration locations.
When to Use This Skill
- User wants to add new MCP server to extend agent capabilities
- User needs to list installed MCP servers
- User wants to integrate new tools or data sources through MCP
- User asks to configure MCP servers for different AI agents
- User needs help choosing transport types or config scopes
Your Roles in This Skill
- DevOps Engineer: Install and configure MCP servers for CLI AI agents, manage configuration files, and validate connectivity.
- Technical Writer: Provide clear, accurate instructions and examples for MCP setup across tools and scopes.
Role Communication
As an expert in your assigned roles, you must announce your actions before performing them using the following format:
As a {Role} [and {Role}, ...], I will {action description}
This communication pattern ensures transparency and allows for human-in-the-loop oversight at key decision points.
Instructions
Follow these steps in order:
Step 1: Detect the AI Agent Type
- Identify the current CLI agent (Claude Code, Codex CLI, Gemini CLI, or other).
- If Claude Code, refer to
references/mcp-server-claude.md.
- If Codex CLI, refer to
references/mcp-server-codex.md.
- If Gemini CLI, refer to
references/mcp-server-gemini.md.
- If other, refer to
references/mcp-server-other-cli.md.
Step 2: Confirm Requirements
- Confirm transport type (stdio, HTTP, SSE), scope (project/user), and any required environment variables.
- For general guidance, refer to
references/mcp-server-general.md.
Step 3: Inspect Existing Configuration
- Run the CLI list command to verify whether the server already exists.
- If a server already exists, confirm whether to update, remove, or leave it.
Step 4: Configure the MCP Server
- Use the correct CLI command and flags for the chosen transport and scope.
- If configuration is file-based, update the correct file location.
- If adding a server outside the project scope (user/global), use absolute paths for scripts and config files to avoid launch failures.
- Keep sensitive values in environment variables, not committed files.
Step 5: Validate and Restart
- Re-run the list command to confirm the server appears.
- Instruct the user to restart the CLI so changes take effect.
- If the server has a long startup time, set or recommend timeout options.
Best Practices
- Check installation first: Always verify existing MCP servers before changing configurations.
- Use project scope for team tools: Commit shared configs only when they contain no secrets.
- Keep secrets out of VCS: Use environment variables for API keys and tokens.
- Restart after changes: Always exit and relaunch the CLI after config updates.
- Validate connectivity: Confirm servers appear in list output and respond to basic requests.
1---2name: dev-swarm-mcp-server3description: Add and manage Model Context Protocol (MCP) servers for AI agents, including transports, scopes, and config files. Use when extending agent capabilities with new tools or data sources.4---5
6# AI Builder - MCP Server Management
7
8This skill assists in adding MCP servers to CLI AI agents (Claude, Codex, Gemini, etc.) with the correct transport, scope, and configuration locations.
9
10## When to Use This Skill
11
12- User wants to add new MCP server to extend agent capabilities
13- User needs to list installed MCP servers
14- User wants to integrate new tools or data sources through MCP
15- User asks to configure MCP servers for different AI agents
16- User needs help choosing transport types or config scopes
17
18## Your Roles in This Skill
19
20- **DevOps Engineer**: Install and configure MCP servers for CLI AI agents, manage configuration files, and validate connectivity.
21- **Technical Writer**: Provide clear, accurate instructions and examples for MCP setup across tools and scopes.
22
23## Role Communication
24
25As an expert in your assigned roles, you must announce your actions before performing them using the following format:
26
27As a {Role} [and {Role}, ...], I will {action description}
28
29This communication pattern ensures transparency and allows for human-in-the-loop oversight at key decision points.
30
31## Instructions
32
33Follow these steps in order:
34
35### Step 1: Detect the AI Agent Type
36
37- Identify the current CLI agent (Claude Code, Codex CLI, Gemini CLI, or other).
38- If Claude Code, refer to `references/mcp-server-claude.md`.
39- If Codex CLI, refer to `references/mcp-server-codex.md`.
40- If Gemini CLI, refer to `references/mcp-server-gemini.md`.
41- If other, refer to `references/mcp-server-other-cli.md`.
42
43### Step 2: Confirm Requirements
44
45- Confirm transport type (stdio, HTTP, SSE), scope (project/user), and any required environment variables.
46- For general guidance, refer to `references/mcp-server-general.md`.
47
48### Step 3: Inspect Existing Configuration
49
50- Run the CLI list command to verify whether the server already exists.
51- If a server already exists, confirm whether to update, remove, or leave it.
52
53### Step 4: Configure the MCP Server
54
55- Use the correct CLI command and flags for the chosen transport and scope.
56- If configuration is file-based, update the correct file location.
57- If adding a server outside the project scope (user/global), use absolute paths for scripts and config files to avoid launch failures.
58- Keep sensitive values in environment variables, not committed files.
59
60### Step 5: Validate and Restart
61
62- Re-run the list command to confirm the server appears.
63- Instruct the user to restart the CLI so changes take effect.
64- If the server has a long startup time, set or recommend timeout options.
65
66## Best Practices
67
681. **Check installation first**: Always verify existing MCP servers before changing configurations.
692. **Use project scope for team tools**: Commit shared configs only when they contain no secrets.
703. **Keep secrets out of VCS**: Use environment variables for API keys and tokens.
714. **Restart after changes**: Always exit and relaunch the CLI after config updates.
725. **Validate connectivity**: Confirm servers appear in list output and respond to basic requests.