Servidores MCP en Claude Code: conecta tus herramientas externas
El MCP (Model Context Protocol) es un estándar abierto que define cómo Claude Code se conecta a herramientas externas. Cuando conectas un servidor MCP, Claude Code descubre las herramientas que expone y las usa como si fueran nativas: consultar tu base de datos, abrir un issue en GitHub, leer un dashboard de analítica, todo desde la sesión, sin copiar y pegar. Los servidores se gestionan con /mcp.
En una frase: sin MCP, Claude Code vive en un perímetro acotado (tu proyecto, tu shell, la web). El MCP rompe ese perímetro y lo conecta a tu stack real.
¿Qué es el MCP y cómo funciona?
Un servidor MCP es un proceso que expone un conjunto de tools siguiendo el protocolo MCP, accesibles para cualquier cliente compatible. Claude Code es uno de esos clientes. Al conectarlo, Claude Code aprende qué herramientas expone, qué parámetros aceptan y qué devuelven, y el modelo las invoca como invocaría Read o Bash.
La arquitectura tiene tres capas:
- El servicio externo (tu base de datos, PostHog, GitHub, tu CRM): expone funcionalidad vía API.
- El servidor MCP: traduce esa API al protocolo MCP. Los hay oficiales (mantenidos por la empresa dueña del servicio), open-source de la comunidad, y los que escribes tú.
- Claude Code (cliente MCP): se conecta, descubre las tools y las pone a disposición del modelo.
Piénsalo como una API gateway estandarizada: antes de MCP, conectar un agente a un sistema nuevo requería código adhoc; con MCP, cualquier servicio "agente-friendly" expone un servidor que cualquier cliente consume sin trabajo extra.
Transporte: cómo se conecta
Cada servidor MCP se configura con un transporte:
- HTTP: el servidor corre en una URL pública o privada. El más común para servicios SaaS.
- stdio: Claude Code lanza un proceso local que se comunica por stdin/stdout. Típico para servidores escritos en Node o Python que corren en tu máquina.
- WebSocket (
ws): conexión bidireccional persistente, para servidores que envían eventos al agente. Se declara conclaude mcp add-jsonindicando"type": "ws". - SSE: está deprecado. Usa HTTP en su lugar. Solo lo verás en comandos de instalación viejos.
Scope: dónde está disponible
El scope define en qué proyectos aparece el servidor. Hay tres:
| Scope | Disponible en | Configuración | Se comparte con el equipo |
|---|---|---|---|
| local (default) | solo este proyecto, solo tú | ~/.claude.json |
No |
project (-s project) |
solo este proyecto | .mcp.json en la raíz del repo |
Sí (se commitea) |
user (-s user) |
todas tus sesiones | ~/.claude.json |
No |
La regla operativa: si el servidor sirve a más de un proyecto (un buscador web, un asistente general), ponlo en user. Si es de un proyecto y quieres compartirlo, usa project (queda en .mcp.json versionado). Si es solo tuyo y de este proyecto, déjalo en local.
Consejo de uso: no conectes de más
Los MCP son opcionales. Conéctalos solo cuando un workflow real los necesite, no "por si acaso". Cada servidor añade herramientas al contexto del modelo, y demasiadas herramientas confunden la decisión de cuál usar. Menos superficie, menos ruido.
Preguntas frecuentes
¿Qué es el MCP en Claude Code?
MCP (Model Context Protocol) es un estándar abierto que define cómo Claude Code se conecta a herramientas externas. Al conectar un servidor MCP, el agente descubre las herramientas que expone (consultar una base de datos, abrir un issue, leer un dashboard) y las usa como si fueran nativas. Los servidores se gestionan con /mcp.
¿Cómo conecto un servidor MCP en Claude Code?
Se añade indicando su transporte (HTTP, stdio o WebSocket) y su scope (local, project o user). Para servidores con configuración por JSON se usa claude mcp add-json. Los servidores conectados se ven y gestionan con el comando /mcp.
¿Cuál es la diferencia entre los scopes local, project y user en MCP?
local (default) deja el servidor solo en este proyecto y solo para ti. project lo guarda en .mcp.json en el repo, así que se comparte con el equipo. user lo deja disponible en todas tus sesiones, sin importar el directorio.
¿Qué transportes soporta MCP en Claude Code?
HTTP (el más común para SaaS), stdio (procesos locales por stdin/stdout) y WebSocket (conexión persistente). SSE está deprecado: conviene usar HTTP en su lugar.
Recursos relacionados
- Skills, hooks y MCP: las tres capas para extender Claude Code, en contexto.
- Cómo dominar Claude Code: la guía completa.
Tu siguiente paso
El comando /mcp y decenas más están en la Cheat Sheet de Claude Code: una hoja imprimible, en español.
Descargar la Cheat Sheet gratis
Es el resumen de Ship with Claude Code, la guía de Takren (14 módulos, 190 capítulos, actualizaciones gratuitas).