AGENT DEVELOPMENT / Anthropic
MCP Integration for Claude Code Plugins
Explains how a Claude Code plugin bundles MCP servers, through .mcp.json or plugin.json, for stdio, SSE, HTTP and WebSocket servers, and how plugin commands pre-allow the resulting MCP tools.
“This skill should be used when the user asks to "add MCP server", "integrate MCP", "configure MCP in plugin", "use .mcp.json", "set up Model Context Protocol", "connect external service", mentions "${CLAUDE_PLUGIN_ROOT} with MCP", or discusses MCP server types (SSE, stdio, HTTP, WebSocket). Provides comprehensive guidance for integrating Model Context Protocol servers into Claude Code plugins for external tool and service integration.”
01 / THE REASONING
Why this made the selection.
- It covers both ways a plugin can bundle MCP servers, a dedicated .mcp.json at the plugin root or an mcpServers field in plugin.json, with configuration examples for stdio, SSE, HTTP and WebSocket servers.
- It gives the plugin tool-name format mcp__plugin_<plugin-name>_<server-name>__<tool-name> and shows command frontmatter that pre-allows named MCP tools instead of a wildcard.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- plugins/plugin-dev/skills/mcp-integration/SKILL.md
- plugins/plugin-dev/skills/plugin-structure/SKILL.md (MCP Servers section)
- plugins/mcp-server-dev/skills/build-mcp-server/SKILL.md (Phase 2)
- plugins/plugin-dev/README.md
- plugins/plugin-dev/LICENSE
- .claude-plugin/marketplace.json (name and plugin-dev entry)
Our findings
- The SKILL.md frontmatter declares no allowed-tools and the skill ships no script; examples/ holds three JSON configurations.
- For SSE servers the SKILL.md says OAuth is handled by Claude Code, the user is prompted on first use and tokens are managed by Claude Code.
- Its security section says to use HTTPS and WSS, keep tokens in environment variables rather than in configuration or git, and pre-allow specific tools rather than wildcards.
- Plugin MCP tools are listed with the /mcp command, and claude --debug shows connection and authentication logs.
Not established by this review
- No MCP server was configured or connected.
- references/server-types.md, references/authentication.md, references/tool-usage.md and the three files in examples/ were not opened.
- Not executed: it was not installed or run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
- The plugin-dev README prints `/plugin install plugin-dev@claude-code-marketplace`; the @claude-code-marketplace suffix is not this repository's marketplace name (claude-plugins-official), and the line brings in mcp-integration together with the other six plugin-dev skills, so it is not this record's own command and install.command is null.
- The README's development alternative is `cc --plugin-dir /path/to/plugin-dev`.
- This review did not run either line.
Before you start
- Claude Code (plugin MCP servers start when the plugin is enabled)
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- mcp-integration SKILL.md ↗Checked
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/skills/mcp-integration/SKILL.md
Supports: upstreamDescription, summary, whySelected[0], whySelected[1], bestFor[0], bestFor[1], bestFor[2], limitations[1], limitations[2], limitations[3], limitations[4], compatibility, review.findings[0], review.findings[1], review.findings[2], review.findings[3], access.permissions[0], access.permissions[1], access.permissions[2], install.prerequisites[0]
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/skills/plugin-structure/SKILL.md
Supports: limitations[2]
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/skills/build-mcp-server/SKILL.md
Supports: limitations[1]
- plugin-dev README ↗Checked
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/README.md
Supports: install.sourceUrl, install.steps[0], install.steps[1], limitations[5], limitations[6], compatibility
- plugin-dev LICENSE ↗Checked
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/LICENSE
Supports: license, limitations[5], access.cost
https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/.claude-plugin/marketplace.json
Supports: limitations[6], install.steps[0]