mcp-integration

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

16|1|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/SocialGouv/iterion --skill mcp-integration-socialgouv
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mcp-integration
Source: https://github.com/SocialGouv/iterion/tree/main/vendor/github.com/SocialGouv/claw-code-go/internal/tools/bundled_skills/plugin-dev/skills/mcp-integration
Command: npx skills add https://github.com/SocialGouv/iterion --skill mcp-integration-socialgouv

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 - MCP 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 with secure credential handling. - Tool Usage Guidance: Pre-allow MCP tools in commands with the mcp__plugin_<plugin>_<server>__<tool> naming convention and build autonomous agents using MCP tools. - Use Case: You want your plugin to create Asana tasks. Configure the hosted Asana SSE server in .mcp.json, let OAuth handle authentication, and pre-allow mcp__plugin_asana_asana__asana_create_task in your command. ## Quick Start Add an MCP server to my Claude Code plugin by creating a .mcp.json file that connects to the Asana SSE endpoint.

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 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 authentication, and WebSocket for real-time bidirectional communication.

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.

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 server is running. Run claude --debug and use the /mcp command to inspect connection attempts and discovered tools.

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 and weaken security scoping.