MCP Integration

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

1|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/Clay-HHK/claude-skills --skill mcp-integration-clay-hhk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: MCP Integration
Source: https://github.com/Clay-HHK/claude-skills/tree/main/mcp-integration
Command: npx skills add https://github.com/Clay-HHK/claude-skills --skill mcp-integration-clay-hhk

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 cloud tools requires correctly configuring MCP servers, handling authentication, and managing tool permissions, which is error-prone without clear guidance. ## Core Features & Use Cases - Server Configuration: Set up MCP servers via .mcp.json or inline plugin.json across four transport types: stdio, SSE, HTTP, and WebSocket. - 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: Bundle an Asana MCP server with your plugin so users can create and search tasks directly from Claude Code commands after a one-time OAuth sign-in. ## Quick Start Add an MCP server to my Claude Code plugin that connects to the Asana SSE endpoint and pre-allow its task creation tool in my 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 command or URL, 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 processes, SSE for hosted services with OAuth, HTTP for REST APIs with token auth, and WebSocket for real-time bidirectional communication.

How does OAuth authentication work with MCP servers?▼

For SSE and HTTP servers, Claude Code handles the OAuth flow automatically by opening a browser for user consent on first use. Tokens are stored securely and refreshed automatically without extra configuration.

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 verify server status.

Should I pre-allow MCP tools with wildcards in commands?▼

No, pre-allow specific MCP tools by their full names like mcp__plugin_asana_asana__asana_create_task rather than wildcards. Wildcard permissions grant access to all server tools, which weakens security scoping.