mcp-integration
Add MCP servers to Claude Code plugins
Also available from: Joseph OBrien,Joseph OBrien,anthropics,davila7
External services and APIs cannot be directly accessed by Claude Code plugins. Model Context Protocol enables structured integration with databases, cloud services, and custom tools. Connect MCP servers to expose external capabilities as Claude Code tools.
Download the skill ZIP
Upload in Claude
Go to Settings → Capabilities → Skills → Upload skill
Toggle on and start using
Test it
Using "mcp-integration". Add MCP server for database access
Expected outcome:
- Database MCP server configured in .mcp.json
- Connection uses environment variables for credentials
- Tools available: query, execute, list_tables, describe
- Server connects on first tool use (lazy loading)
Using "mcp-integration". Connect to GitHub via MCP
Expected outcome:
- SSE server configured for GitHub MCP endpoint
- OAuth authentication flow handled automatically
- Tools available: create_repo, list_issues, create_pull_request
- Token stored securely by Claude Code
Using "mcp-integration". Build custom local MCP server
Expected outcome:
- Python script registered as stdio MCP server
- Environment variables passed for configuration
- Custom tools appear with mcp__plugin prefix
- Server managed by Claude Code process lifecycle
Security Audit
SafeOfficial Anthropic documentation skill containing only markdown guides and JSON configuration examples. No executable code or scripts. All content promotes security best practices including HTTPS, environment variable usage, and proper credential handling.
Risk Factors
🌐 Network access (43)
🔑 Env variables (29)
⚙️ External commands (280)
Quality Score
What You Can Build
Build plugins with external service access
Create plugins that connect to databases, APIs, and cloud services using MCP configuration
Integrate infrastructure tools
Connect to cloud providers, CI/CD systems, and monitoring tools through MCP servers
Query databases from Claude Code
Run SQL queries and manage database operations using MCP database servers
Try These Prompts
Add an MCP stdio server to my plugin that provides file system access using npx @modelcontextprotocol/server-filesystem for paths in ${CLAUDE_PROJECT_DIR}Configure an MCP SSE server for Asana integration with OAuth authentication. Show the .mcp.json configuration and explain the OAuth flow
Create a custom MCP stdio server that exposes my Python script functions as Claude Code tools. Include environment variable configuration
Set up secure HTTP MCP server connection to a production API with Bearer token authentication. Include environment variable best practices and error handling
Best Practices
- Always use environment variables for tokens and API keys, never hardcode credentials in configuration files
- Use HTTPS or WSS for all network connections to protect data in transit
- Pre-allow only necessary MCP tools in commands using specific names instead of wildcards
Avoid
- Hardcoding API tokens or credentials in .mcp.json or plugin.json files
- Using HTTP instead of HTTPS for MCP server connections
- Using wildcard tool permissions like mcp__plugin_*__* which grants excessive access
Frequently Asked Questions
What MCP server types are supported?
How many MCP servers can a plugin have?
How do I authenticate to MCP servers?
Are MCP credentials stored securely?
Why are my MCP tools not showing up?
How does MCP differ from direct API calls?
Developer Details
Author
anthropicsLicense
MIT
Repository
https://github.com/anthropics/claude-code/tree/main/plugins/plugin-dev/skills/mcp-integrationRef
main
File structure