dev-swarm-mcp-server
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.
When & Why to Use This Skill
This Claude skill provides a comprehensive framework for adding and managing Model Context Protocol (MCP) servers, enabling AI agents to seamlessly integrate with external tools and data sources. It streamlines the technical complexity of configuring transports, scopes, and environment variables, ensuring that your AI agents are extensible, secure, and properly connected to their operational environment.
Use Cases
- Extending AI Agent Capabilities: Quickly add new MCP servers to provide CLI agents like Claude Code or Gemini CLI with access to specialized local or remote tools.
- Multi-Agent Configuration Management: Manage and audit installed MCP servers across different scopes (project-specific vs. global user) to maintain a clean development environment.
- Secure Integration Workflows: Implement best practices for handling sensitive credentials by configuring MCP servers to use environment variables instead of hardcoded secrets in configuration files.
- Protocol Optimization: Assist in selecting and configuring the most appropriate transport types (stdio, HTTP, SSE) based on the specific connectivity requirements of the agent and the tool.
| name | dev-swarm-mcp-server |
|---|---|
| description | 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. |
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.