skills.rest
ghoshsam
ghoshsamCOMMUNITY
Explore all skills by this author →
GitHub

mcp-integration

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

2|Updated Mar 21, 2026
Search Tags:#oauth#claude code#mcp#plugin#api integration#model context protocol#server configuration
One-click install
npx skills add https://github.com/ghoshsam/claude-code-skills --skill mcp-integration-ghoshsam
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mcp-integration
Source: https://github.com/ghoshsam/claude-code-skills/tree/main/skills/plugin-dev/mcp-integration
Command: npx skills add https://github.com/ghoshsam/claude-code-skills --skill mcp-integration-ghoshsam

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—tasks that are error-prone without structured 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 ${CLAUDE_PLUGIN_ROOT} path portability. - Authentication Patterns: Implement OAuth flows for hosted services, token-based headers for REST APIs, and environment variable injection for local servers. - Tool Permission Management: Pre-allow specific MCP tools in command frontmatter using the mcp__plugin_<name>_<server>__<tool> naming convention. - Use Case: You are building a Claude Code plugin that needs to create tasks in Asana. Use this Skill to configure the hosted Asana SSE server, let OAuth handle authentication, and pre-allow the task creation tool in your command. ## Quick Start Add an MCP server to my Claude Code plugin by creating a .mcp.json file that connects to the GitHub hosted MCP endpoint.

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 command, args, and environment variables, or add an mcpServers field to plugin.json. Use ${CLAUDE_PLUGIN_ROOT} for portable paths and verify the server appears with the /mcp command.

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 authentication, and WebSocket for real-time bidirectional connections.

Should I use .mcp.json or plugin.json for MCP configuration?▼

Use a dedicated .mcp.json file for better separation of concerns and easier maintenance with multiple servers. Use the inline mcpServers field in plugin.json for simple single-server plugins that benefit from one configuration file.

How does OAuth authentication work with MCP servers?▼

OAuth is handled automatically by Claude Code for SSE and HTTP server types. The user authenticates in a browser on first tool use, and Claude Code manages the tokens without additional configuration.

Why is my MCP server not connecting in Claude Code?▼

Connection failures usually stem from incorrect URLs, stopped local server processes, network issues, or misconfigured authentication. Run claude --debug to inspect connection logs and use /mcp to verify server status.

Can I allow all MCP tools from a server at once?▼

Yes, wildcards like mcp__plugin_asana_asana__* allow all tools from a server, but this is discouraged. Pre-allowing specific tools in command frontmatter is the recommended security practice.

Related Skills

Explore More Software Engineering Skills→
richfremrichfrem
5

create-plugin

Scaffold a Claude Code plugin directory with plugin.json and manifest.

Community
Advanced
Naw3Naw3

claude-code-plugins

Build Claude Code plugins with commands, agents, hooks, and MCP servers.

Community
Intermediate
organvm-i-theoriaorganvm-i-theoria

mcp-server-orchestrator

Configure, deploy, and troubleshoot Model Context Protocol servers for AI agent workflows.

Official
Intermediate
dthuy62dthuy62

ck:use-mcp

Execute MCP server tools via Gemini CLI with JSON output.

Community
Intermediate