MCP Integration

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

1|Updated May 10, 2026
One-click install
npx skills add https://github.com/Tgoldi/claude-skills --skill mcp-integration-tgoldi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: MCP Integration
Source: https://github.com/Tgoldi/claude-skills/tree/main/mcp-integration
Command: npx skills add https://github.com/Tgoldi/claude-skills --skill mcp-integration-tgoldi

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 correctly configuring MCP servers, handling authentication, and wiring tools into commands—this Skill provides the complete configuration patterns and troubleshooting guidance to do it right. ## Core Features & Use Cases - Server Configuration: Set up stdio, SSE, HTTP, and WebSocket MCP servers via .mcp.json or inline plugin.json with environment variable expansion using ${CLAUDE_PLUGIN_ROOT}. - Authentication Patterns: Implement OAuth flows, bearer tokens, API keys, and dynamic header helpers without hardcoding credentials. - Tool Integration: Pre-allow MCP tools in command frontmatter, use them in autonomous agents, and handle errors, batching, and debugging with /mcp and claude --debug. - Use Case: You are building a plugin that connects to Asana and a local database. Use this Skill to configure an SSE server with OAuth for Asana and a stdio server for the database, then expose their tools in your plugin commands. ## Quick Start Add an MCP server to my Claude Code plugin that connects to the Asana SSE endpoint and pre-allows 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 with its type, command or url, and environment variables. Alternatively, add an mcpServers field directly in plugin.json for simple single-server plugins.

What is the difference between stdio, SSE, HTTP, and WebSocket MCP servers?

stdio runs local servers as child processes for tools and databases, SSE connects to hosted services with OAuth support, HTTP suits stateless REST APIs with token auth, and WebSocket enables real-time bidirectional streaming.

How does OAuth authentication work with MCP servers?

Claude Code handles OAuth automatically for SSE and HTTP servers. On first tool use, the user is prompted to authorize in a browser, and 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 configuration is valid JSON. Run /mcp to verify the server appears and use claude --debug to inspect connection and authentication logs.

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

No, pre-allow specific tool names like mcp__plugin_asana_asana__asana_create_task rather than wildcards. Wildcards grant access to every tool from a server, which weakens permission scoping and security.