Qué es MCP: conectando Claude Code con el mundo exterior

Claude Code tiene un alcance definido por defecto: leer y escribir archivos locales, ejecutar comandos en la terminal, usar herramientas integradas. Pero los proyectos reales exigen más: consultar una base de datos, leer documentos de Notion, buscar mensajes en Slack, llamar APIs internas.

MCP es la solución a ese problema.

Qué es MCP

MCP (Model Context Protocol) es un protocolo abierto de Anthropic que define cómo los modelos de IA se comunican con herramientas externas y fuentes de datos. Puedes verlo como instalar plugins en Claude Code: cada MCP Server es un servicio independiente que expone un conjunto de herramientas que Claude puede invocar directamente durante una sesión.

A diferencia de los Hooks (que ejecutan scripts cuando Claude realiza una acción), MCP amplía activamente lo que Claude puede hacer: todo lo que conectes, Claude puede operarlo.

Cómo funciona

La arquitectura es sencilla:

Claude Code (Client)  ←→  MCP Server  ←→  Sistema externo

Declaras un MCP Server en tu configuración (un proceso local o un servicio remoto)
Al arrancar, Claude Code se conecta al Server y obtiene la lista de herramientas disponibles
Durante la sesión, Claude puede llamar esas herramientas igual que las integradas (Read, Write, Bash)
El MCP Server procesa la solicitud y devuelve el resultado

Todo es transparente para el usuario. Lo que ves es que Claude dice "voy a consultar la base de datos" y devuelve una respuesta; MCP está gestionando el intercambio en segundo plano.

Tres tipos de capacidades MCP

Un MCP Server puede exponer tres cosas:

Tools (herramientas)
Funciones que Claude puede invocar activamente: "consultar la tabla de usuarios", "buscar documentos", "enviar un mensaje de Slack". Cubre el 90% de los casos de uso reales.

Resources (recursos)
Datos estructurados que Claude puede leer como contexto: schemas de bases de datos, documentación de APIs, archivos de configuración.

Prompts (plantillas de prompts)
Fragmentos de prompts predefinidos que los usuarios pueden invocar directamente.

En la práctica, casi siempre trabajarás con Tools.

Inicio rápido: agregar un MCP Server existente

Tomando el Filesystem MCP oficial como ejemplo, este Server da a Claude acceso a partes del sistema de archivos fuera del directorio de trabajo.

Instalar

npm install -g @modelcontextprotocol/server-filesystem

Configurar

Edita ~/.claude/settings.json:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Documents"
      ]
    }
  }
}

Verificar

Reinicia Claude Code y prueba:

Lista todos los archivos PDF en /Users/yourname/Documents

Si Claude devuelve resultados en lugar de decir "no puedo acceder al sistema de archivos", MCP está funcionando.

Estructura de la configuración

{
  "mcpServers": {
    "nombre-del-servidor": {
      "command": "comando de inicio",
      "args": ["lista de argumentos"],
      "env": {
        "API_KEY": "xxx"
      }
    }
  }
}

command + args: cómo Claude Code lanza el proceso del MCP Server
El nombre del servidor es solo una etiqueta local; ponle lo que quieras
Usa env para API keys y configuración sensible; no los pongas en el código

Dónde poner la configuración

La configuración de MCP puede ir en tres lugares, de menor a mayor prioridad:

Ubicación	Archivo	Cuándo usarlo
Global	`~/.claude/settings.json`	Herramientas para todos los proyectos
Proyecto	`.claude/settings.json`	Herramientas específicas de este proyecto
Override local	`.claude/settings.local.json`	Configuración personal, no se sube a git

Para conexiones a bases de datos y APIs internas, usa la configuración de proyecto y haz commit junto con el código. Los miembros del equipo que clonen el repositorio tendrán el mismo entorno MCP automáticamente.

Dónde encontrar MCP Servers existentes

Anthropic mantiene un conjunto de servidores oficiales:

@modelcontextprotocol/server-filesystem — acceso al sistema de archivos
@modelcontextprotocol/server-github — operaciones de GitHub (PRs, issues, búsqueda de código)
@modelcontextprotocol/server-postgres — consultas PostgreSQL
@modelcontextprotocol/server-slack — leer y escribir mensajes de Slack
@modelcontextprotocol/server-google-maps — mapas e información geográfica

La comunidad ha construido muchos más que cubren Notion, Linear, Jira y distintas bases de datos.

MCP vs Hooks: cuál elegir

	Hooks	MCP
Se activa cuando	Claude ejecuta una acción específica	Claude llama activamente a una herramienta
Propósito	Interceptar o mejorar comportamientos existentes	Añadir nuevas capacidades
Casos típicos	Formatear al guardar, verificar antes de hacer commit	Consultar base de datos, llamar API externa
Complejidad de configuración	Baja	Media

Son complementarios. Los Hooks controlan cómo trabaja Claude; MCP controla qué puede hacer Claude.

Qué viene después

Este artículo es una introducción conceptual a MCP. Los próximos cubrirán:

Conectar Claude Code a una base de datos PostgreSQL real con un schema real
Conectar herramientas internas y APIs
Construir tu propio MCP Server desde cero

Si ya tienes un sistema que quieres conectar, revisa primero la lista de MCP Servers; probablemente alguien ya construyó lo que necesitas.