---
title: "MCP Integration for Claude Code Plugins: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/anthropic-mcp-integration/
description: "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."
---

# MCP Integration for Claude Code Plugins: review, setup & limitations · Undominated.ai

> 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.

[← Explore all skills](/skills/)

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.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/anthropics/claude-plugins-official/tree/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/skills/mcp-integration)

SOURCE REVIEW

 Reviewed 2026-10-21
 Evidence 6 linked sources
 Publisher Anthropic
 Licence [Apache-2.0 ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/LICENSE)
 Revision 41f32e407b45
 [Read what was—and wasn’t—checked ↓](#review)

“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.”

 [Anthropic · upstream description ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/skills/mcp-integration/SKILL.md) Our analysis follows below.

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.

### A good fit for

 - Add a stdio MCP server to a plugin's .mcp.json using ${CLAUDE_PLUGIN_ROOT} paths and environment variables
- Pre-allow specific named MCP tools in a plugin command's allowed-tools instead of a wildcard
- Send an API token to an HTTP MCP server in an Authorization header built from an environment variable

### Weigh up before choosing

 - Last commit touching plugins/plugin-dev/skills/mcp-integration at revision 41f32e40: 2026-08-06 (088bee40).
- It recommends SSE for hosted services with OAuth, while the build-mcp-server skill in the same repository and revision names remote streamable HTTP as its default recommendation for anything wrapping a cloud API.
- Its Method 1 .mcp.json example puts server names at the top level, while the plugin-structure skill of the same plugin, whose MCP section names .mcp.json or inline plugin.json as the location, gives an example format with servers inside an mcpServers object.
- The stdio example starts npx -y @modelcontextprotocol/server-filesystem with no package version.
- MCP configuration changes need a restart, per the SKILL.md's lifecycle section.
- mcp-integration is part of plugin-dev; that plugin's README gives "MIT License - See repository for details" as its License section, and plugins/plugin-dev/LICENSE is the Apache License, Version 2.0. This record follows the LICENSE file.
- mcp-integration's plugin is installed by a README line naming claude-code-marketplace, but the repository's marketplace file is named claude-plugins-official.

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.

[Upstream setup instructions ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/README.md)
 - 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)

### Compatibility

Claude Code

### Guidance only; the MCP servers it configures connect to external services with the user's tokens

 - The skill declares no allowed-tools and contains only Markdown plus three example JSON configurations
- stdio servers configured from it run as local child processes that Claude Code spawns
- SSE, HTTP and WebSocket servers connect to remote URLs, with OAuth handled by Claude Code or tokens read from environment variables

### Cost model

Apache-2.0 per plugins/plugin-dev/LICENSE; the SKILL.md names no paid service, and its error-handling section tells authors to check rate limits and quotas of the servers they call

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 ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/skills/mcp-integration/SKILL.md) Checked 2026-10-21 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]
- [plugin-structure SKILL.md, MCP Servers section ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/skills/plugin-structure/SKILL.md) Checked 2026-10-21 https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/skills/plugin-structure/SKILL.md Supports: limitations[2]
- [build-mcp-server SKILL.md, Phase 2 ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/skills/build-mcp-server/SKILL.md) Checked 2026-10-21 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 ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/README.md) Checked 2026-10-21 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 ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/LICENSE) Checked 2026-10-21 https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/plugin-dev/LICENSE Supports: license, limitations[5], access.cost
- [Marketplace file, name and plugin-dev entry ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/.claude-plugin/marketplace.json) Checked 2026-10-21 https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/.claude-plugin/marketplace.json Supports: limitations[6], install.steps[0]

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Plugin Settings Pattern for Claude Code Plugins ↗ Documents one pattern for per-project Claude Code plugin settings, a .claude/<plugin-name>.local.md file with YAML frontmatter and a Markdown body, and how hooks, commands and agents read it.](/skills/anthropic-plugin-settings/)[### Agent Development for Claude Code Plugins ↗ Explains how to write a Claude Code plugin agent file (frontmatter, trigger description, system prompt) and ships a Bash script that checks one agent file.](/skills/anthropic-agent-development/)[### Command Development for Claude Code ↗ Explains how to write Claude Code slash-command files: frontmatter fields, $ARGUMENTS and positional arguments, @file references, inline Bash and plugin command patterns.](/skills/anthropic-command-development/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
