mcp-integration

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

Updated Oct 7, 2022
One-click install
npx skills add https://github.com/tamagusko/linux-cfg --skill mcp-integration-tamagusko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-integration
Source: https://github.com/tamagusko/linux-cfg/tree/main/dotfiles/claude/skills/mcp-integration
Command: npx skills add https://github.com/tamagusko/linux-cfg --skill mcp-integration-tamagusko

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 platforms requires correctly configuring MCP servers, handling authentication, and wiring tools into commands — a process with many failure points and security pitfalls. ## 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 Guidance: Implement OAuth flows, bearer tokens, API keys, and dynamic header helpers using environment variables instead of hardcoded credentials. - Tool Integration: Pre-allow MCP tools in command frontmatter using the mcp__plugin_<plugin>_<server>__<tool> naming convention, with patterns for agents and multi-server workflows. - Use Case: You are building a plugin that connects to Asana. Use this Skill to configure the SSE server with OAuth, pre-allow the task creation tools in your command, and validate the setup with /mcp and claude --debug. ## 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 authentication 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 command or URL, or add an mcpServers field to plugin.json. Use ${CLAUDE_PLUGIN_ROOT} for portable paths and restart Claude Code to load the configuration.

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. Choose based on whether the server is local or hosted.

How do I authenticate an MCP server with OAuth?

For SSE servers like Asana, just specify the type and URL — Claude Code handles the full OAuth flow automatically, opening a browser for consent and managing token storage and refresh. No extra configuration is needed.

Why is my MCP server not connecting in Claude Code?

Check that the URL or command path is correct, the server is running, and required environment variables are set. Run claude --debug to see connection attempts and use /mcp to verify the server appears with its 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. Wildcards grant access to every tool from a server, which weakens permission scoping and security.