MCP Integration

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

Updated Aug 7, 2026
One-click install
npx skills add https://github.com/valeratrades/plugin-dev --skill mcp-integration-valeratrades
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: MCP Integration
Source: https://github.com/valeratrades/plugin-dev/tree/main/skills/mcp-integration
Command: npx skills add https://github.com/valeratrades/plugin-dev --skill mcp-integration-valeratrades

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 clear 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. - Authentication Patterns: Handle OAuth flows, bearer tokens, API keys, and environment variable credentials securely. - Tool Integration: Pre-allow MCP tools in commands and agents using the mcp__plugin_<plugin>_<server>__<tool> naming convention. - Use Case: You want your plugin to create Asana tasks. Configure the Asana SSE server in .mcp.json, let OAuth handle authentication, then pre-allow the create_task tool in your slash command. ## Quick Start Ask the AI to add an MCP server to your plugin by creating a .mcp.json file with the appropriate server type and configuration.

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 its type, command or url, and environment variables. Alternatively, add an mcpServers field directly in plugin.json for simpler single-server plugins.

What MCP server type should I use for my plugin?▼

Use stdio for local tools and custom servers, SSE for hosted cloud services with OAuth, HTTP for REST APIs with token authentication, and WebSocket for real-time bidirectional communication. Choose based on where the server runs and its auth model.

How does OAuth authentication work with MCP servers?▼

Claude Code handles the full OAuth 2.0 flow automatically for SSE and HTTP servers. Users are prompted to authorize in a browser on first use, and tokens are stored securely with automatic refresh.

Why is my MCP server not connecting in Claude Code?▼

Check that the URL or command path is correct, verify required environment variables are set, and run claude --debug to inspect connection logs. Use the /mcp command to confirm the server appears and restart Claude Code after configuration changes.

How do I use MCP tools in plugin commands?▼

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