MCP Integration
This skill should be used when the user asks to "add MCP server", "integrate MCP", "configure MCP in plugin", "use .mcp.json", "set up Model Context Protocol", "connect external service", mentions "${CLAUDE_PLUGIN_ROOT} with MCP", or discusses MCP server types (SSE, stdio, HTTP, WebSocket). Provides comprehensive guidance for integrating Model Context Protocol servers into Claude Code plugins for external tool and service integration.
Security Assessment
About MCP Integration
The MCP Integration skill is designed to facilitate the incorporation of Model Context Protocol (MCP) servers into Claude Code plugins, allowing users to effectively connect with external services and APIs. This skill addresses the challenge of integrating diverse external tools, providing a structured approach to access these services and exposing their capabilities as tools within the Claude Code environment. Whether users need to add an MCP server, configure it within a plugin, or utilize specific JSON configurations, this skill offers comprehensive guidance tailored to these needs.
With features such as the ability to connect to various external services, provide multiple tools from a single service, and handle complex authentication flows like OAuth, the MCP Integration skill streamlines the integration process. Users can choose between bundling MCP servers through a dedicated `.mcp.json` file for better maintainability or incorporating them directly within the `plugin.json` for simpler configurations. The skill supports multiple types of MCP servers, including stdio, SSE, HTTP, and WebSocket, catering to a wide array of use cases from local process execution to real-time data streaming.
Targeted at developers and teams looking to extend their plugins with external capabilities, this skill is ideal for those working with cloud services, RESTful APIs, or local tools. It is particularly useful for scenarios requiring real-time communication or integration with popular platforms like Asana and GitHub, making it a versatile asset for enhancing plugin functionality and user experience.
FAQ
How do I add an MCP server to my plugin?
You can either create a dedicated .mcp.json file at the plugin root or add the mcpServers field directly to your plugin.json.
What types of MCP servers are supported?
The skill supports stdio, SSE, HTTP, and WebSocket server types for various integration scenarios.
Are there any specific requirements for using OAuth with MCP?
OAuth flows are handled automatically by Claude Code, prompting users for tokens upon first use.
Can I use multiple MCP servers within a single plugin?
Yes, using a dedicated .mcp.json file is recommended for better management of multiple servers.
Is there support for environment variable expansion?
Yes, all MCP configurations support environment variable substitution for flexibility and portability.
Install MCP Integration
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
anthropics/claude-code