MCP Integration

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

432|40|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/tzachbon/smart-ralph --skill mcp-integration-tzachbon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: MCP Integration
Source: https://github.com/tzachbon/smart-ralph/tree/main/.agents/skills/MCP%20Integration
Command: npx skills add https://github.com/tzachbon/smart-ralph --skill mcp-integration-tzachbon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps developers integrate MCP servers into Claude Code plugins, enabling seamless external tool communication and automation.

Core Features & Use Cases

  • Unified MCP integration: guide to configure and deploy MCP servers (stdio, SSE, HTTP, ws) within Claude Code plugins.
  • Authentication & Security: covers OAuth and token-based methods, environment variable handling, and secure token storage.
  • Discovery & Tooling: shows how to discover MCP tools via /mcp, prefix naming, and how to reference tools in commands and agents.
  • Use Case: Example workflow to connect a custom database service and expose its tools to Claude Code.
  • Lifecycle management and best practices for plugin authors.

Quick Start

  1. Review the MCP Integration SKILL.md to understand how MCP servers are configured and exposed in Claude Code plugins.
  2. Choose a configuration method: create a .mcp.json at the plugin root or add an mcpServers entry to plugin.json, and document required environment variables.
  3. Use the /mcp command to discover available MCP tools and begin building commands or agents that invoke MCP tools prefixed as mcp__plugin_<plugin-name>_<server-name>__<tool-name>.

Frequently Asked Questions about MCP Integration

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

FAQPage Schema
How do I integrate MCP servers into Claude Code plugins?

To integrate MCP servers into Claude Code plugins, configure a .mcp.json file at the plugin root or add an mcpServers entry to plugin.json, then use the /mcp command to discover available tools.

What transport protocols are supported for MCP server integration?

MCP server integration supports stdio, SSE, HTTP, and WebSocket transport protocols, allowing flexible communication between Claude Code plugins and external services.

How does authentication work when connecting external tools via MCP?

MCP authentication supports OAuth and token-based methods, requiring you to document environment variables and implement secure token storage within the plugin configuration.

How are MCP tools referenced and invoked in Claude Code commands?

MCP tools are referenced in commands and agents using a prefixed naming convention: mcp__plugin_<plugin-name>_<server-name>__<tool-name>, discovered via the /mcp command.

What metadata is emitted during MCP plugin integration?

MCP plugin integration emits metadata including name, description, version, dependencies, and components, while validating YAML frontmatter in SKILL.md and supporting optional resources.

Can I expose a custom database service to Claude Code using MCP?

Yes, you can connect a custom database service as an MCP server and expose its tools to Claude Code by configuring the server connection and discovering the tools through the /mcp command.