MCP Integration

Configure Model Context Protocol servers in Claude Code plugins for external service integration.

1|1|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/voxxov222/Claude-code- --skill mcp-integration-voxxov222
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: MCP Integration
Source: https://github.com/voxxov222/Claude-code-/tree/main/temp-repo/plugins/plugin-dev/skills/mcp-integration
Command: npx skills add https://github.com/voxxov222/Claude-code- --skill mcp-integration-voxxov222

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Connecting Claude Code plugins to external services like databases, APIs, and hosted tools requires correct MCP server configuration, authentication setup, and tool registration, which is error-prone without structured guidance. ## Core Features & Use Cases - Server Configuration: Set up MCP servers via .mcp.json or inline plugin.json using stdio, SSE, HTTP, or WebSocket transports with ${CLAUDE_PLUGIN_ROOT} path portability. - Authentication Patterns: Handle OAuth flows automatically for hosted services, or configure token-based and environment-variable authentication for APIs and local servers. - Tool Usage in Commands and Agents: Pre-allow MCP tools with the mcp__plugin_<plugin>_<server>__<tool> naming convention and build multi-step workflows. - Use Case: You want your plugin to create Asana tasks. Add an SSE server entry pointing to https://mcp.asana.com/sse, let OAuth handle login, then pre-allow the task creation tool in your command frontmatter. ## Quick Start Add an MCP server to my Claude Code plugin that connects to the Asana hosted service and pre-allow its task creation tool in a new command.

Frequently Asked Questions about MCP Integration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add an MCP server to a Claude Code plugin?

Create a `.mcp.json` file at the plugin root defining the server with a command (stdio) or url (SSE/HTTP/ws), or add an `mcpServers` field to plugin.json. Use `${CLAUDE_PLUGIN_ROOT}` for portable paths and verify the server appears with the `/mcp` command.

What MCP server types does Claude Code support?

Claude Code supports four MCP server types: stdio for local child processes, SSE for hosted services with OAuth, HTTP for REST APIs with token headers, and WebSocket for real-time bidirectional communication. Choose based on whether the server is local or hosted.

How does OAuth authentication work with MCP servers?

OAuth is handled automatically by Claude Code for SSE and HTTP servers. On first tool use, the user is prompted to authorize in a browser, and tokens are stored securely with automatic refresh. No extra configuration is needed beyond the server URL.

How do I use MCP tools in plugin commands?

Pre-allow tools in the command frontmatter using the full name format `mcp__plugin_<plugin-name>_<server-name>__<tool-name>`. Prefer listing specific tools over wildcards for security, and discover exact tool names with the `/mcp` command.

Why is my MCP server not connecting in Claude Code?

Check that the URL or command path is correct, required environment variables are set, and the JSON configuration is valid. Run `claude --debug` to inspect connection attempts and use `/mcp` to confirm whether the server and its tools registered.

Can I pass API tokens to an MCP server securely?

Yes, reference tokens through environment variables like `${API_TOKEN}` in headers or env fields rather than hardcoding them. Document all required variables in the plugin README and never commit credentials to git.