mcp-integration

Integrate MCP servers into Claude Code plugins via .mcp.json or inline configuration.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/phpmac/skills --skill mcp-integration-phpmac
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-integration
Source: https://github.com/phpmac/skills/tree/main/plugins/plugin-dev/skills/mcp-integration
Command: npx skills add https://github.com/phpmac/skills --skill mcp-integration-phpmac

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Claude Code plugins often struggle to securely and reliably connect to external services. Provide a unified MCP integration method to expose external tools via the Model Context Protocol, enabling seamless tool discovery and invocation within Claude Code.

Core Features & Use Cases

  • Comprehensive MCP server support (stdio, SSE, HTTP, WebSocket)
  • Local and hosted deployments, with .mcp.json or inline configurations
  • Secure authentication handling (OAuth for SSE/HTTP, token headers) and environment variable usage
  • Unified tool discovery and naming conventions for mcp__plugin_<plugin>_<server>__<tool>
  • Use cases: building plugins that integrate external APIs, databases, file systems

Quick Start

Start with configuring an MCP server for your plugin via .mcp.json or inline configuration, then verify available tools with the /mcp command.

Frequently Asked Questions about mcp-integration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate an MCP server into a Claude Code plugin?

To integrate an MCP server into a Claude Code plugin, configure the server connection via a .mcp.json file or inline configuration, then verify the exposed external tools using the /mcp command.

Can I connect Claude Code to external services using OAuth and SSE?

Yes, Claude Code supports secure MCP integration with hosted SSE, HTTP, and WebSocket services, including OAuth for authentication and token headers for external service access.

What transport protocols does Model Context Protocol support for local and hosted servers?

Model Context Protocol integration supports local stdio-based servers alongside hosted SSE, HTTP, and WebSocket services, enabling unified tool discovery and invocation within Claude Code.

Do I need a YAML frontmatter file to expose external tools via MCP?

Yes, you need a SKILL.md file enforcing YAML frontmatter with name and description, and you can define optional resource directories like scripts, references, and assets for safety checks.

How are MCP tools named when invoked from a Claude Code plugin?

MCP tools integrated into Claude Code plugins use a unified naming convention following the mcp__plugin_<plugin>_<server>__<tool> format to ensure consistent tool discovery and invocation.