MCP Integration

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

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/ace8991/agentos --skill mcp-integration-ace8991
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: MCP Integration
Source: https://github.com/ace8991/agentos/tree/main/.tmp_claude_code/claude-code-main/plugins/plugin-dev/skills/mcp-integration
Command: npx skills add https://github.com/ace8991/agentos --skill mcp-integration-ace8991

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 managing tool permissions, 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 configuration with environment variable expansion. - Authentication Patterns: Implement OAuth flows, bearer tokens, API keys, and dynamic header helpers for secure service connections. - Tool Usage in Commands and Agents: Pre-allow specific MCP tools in command frontmatter and build autonomous agents that call MCP tools. - 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 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 and shows me how to use its tools in a 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 command or URL, or add an `mcpServers` field to plugin.json. Use `${CLAUDE_PLUGIN_ROOT}` for portable paths and document required environment variables in the README.

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 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. No extra configuration is needed beyond the server URL.

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 inspect connection logs and use the `/mcp` command to verify the server appears and its tools are registered.

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 for commands that only need a few operations.