MCP Integration for Claude Code
Integrates Model Context Protocol (MCP) servers into Claude Code plugins to enable secure access to external tools, databases, and cloud services.
The source repository doesn't declare a license. Check its terms before reusing the code.
Key features
- Support for multiple transport types: stdio, SSE, HTTP, and WebSockets
- Standardized namespacing for automatic discovery of external tools
- Dynamic environment variable expansion for portable plugin configurations
- Automated OAuth handling and secure token management patterns
- Built-in lifecycle management for server startup and connection pooling
Use cases
- Creating local developer utilities that interface with internal databases or file systems
- Building plugins that connect Claude Code to enterprise SaaS platforms like Jira, Asana, or GitHub
- Developing autonomous agents capable of multi-step workflows across diverse cloud service APIs
FAQ
How do I test my MCP integration locally?
You can install your plugin in the .claude-plugin/ directory, run the /mcp command to verify the server appears, and use 'claude --debug' to inspect connection logs and tool discovery.
What is the naming convention for tools provided by an MCP server?
Tools are automatically prefixed to prevent naming collisions using the format: mcp__plugin_<plugin-name>_<server-name>__<tool-name>.
What is the best way to bundle an MCP server with a plugin?
The recommended method is using a dedicated .mcp.json file at the plugin root. This provides a clear separation of concerns and makes it easier to maintain multiple servers compared to inline configuration.
Can I restrict which tools an MCP server provides to Claude?
Yes, for security, you should pre-allow specific tools in your command frontmatter using the 'allowed-tools' array rather than using wildcards.
How does Claude Code handle authentication for hosted MCP servers?
For SSE-based servers, Claude Code handles OAuth flows automatically, prompting the user for browser-based authentication on first use. For HTTP and stdio servers, you can use environment variable expansion to securely pass tokens.