MCP: conectar Claude Code a tus herramientas

Claude Code sabe leer tus archivos, escribir código y lanzar comandos. Pero hay un límite: por defecto, no ve nada fuera de tu sistema de archivos local. MCP cambia eso. Es el mecanismo que permite a Claude Code hablar con una base de datos, con GitHub, con Notion o con cualquier otra herramienta externa, todo sin salir de tu terminal.

¿Qué es MCP?

MCP (Model Context Protocol) es un protocolo open-source estandarizado, creado por Anthropic y adoptado por la comunidad. Su función: definir un lenguaje común entre un agente IA (el cliente) y herramientas externas (los servidores).

Piénsalo como un conector universal. Antes de MCP, cada integración IA-herramienta era un cable propietario hecho a medida. Con MCP, es un puerto único que cualquier herramienta puede implementar.

En la práctica, un servidor MCP expone tres tipos de primitivas:

• Tools: funciones que Claude puede llamar (consulta SQL, lectura de archivo, llamada a API).
• Resources: datos contextuales que Claude puede leer (esquema de una base, contenido de un archivo remoto).
• Prompts: plantillas reutilizables para estructurar las interacciones.

Claude Code actúa como cliente MCP. Descubre las herramientas disponibles, las expone al modelo y reenvía las llamadas a los servidores correspondientes.

Añadir un servidor MCP con claude mcp add

Claude Code ofrece un comando dedicado para conectar un servidor MCP. Hay dos modos principales: servidores remotos (HTTP) y servidores locales (stdio).

Servidor remoto (HTTP)

La mayoría de los servicios de uso general ofrecen hoy un endpoint MCP alojado. Por ejemplo, para Notion:

$claude mcp add --transport http notion https://mcp.notion.com/mcp

O para GitHub (con un token de autenticación):

$claude mcp add --transport http github https://api.githubcopilot.com/mcp/ --header "Authorization: Bearer TU_TOKEN"

Servidor local (stdio)

Algunos servidores se ejecutan en local en tu máquina, mediante un proceso lanzado por el propio Claude Code. Es el caso habitual para servidores de bases de datos o herramientas de línea de comandos:

$claude mcp add --transport stdio --env MI_CLAVE_API=tu_valor mi-herramienta -- npx -y nombre-del-paquete-mcp

La parte después de -- es el comando exacto que Claude Code ejecutará para arrancar el servidor.

Verificar los servidores conectados con /mcp

Una vez añadido un servidor, puedes comprobar su estado directamente en la sesión de Claude Code con el slash command /mcp.

$/mcp

Este comando abre un panel que lista todos tus servidores MCP configurados, su estado (conectado, error, esperando autenticación) y te permite gestionar los permisos por proyecto.

También puedes listar tus servidores desde la terminal, fuera de una sesión:

$claude mcp list

Guardar la configuración en .mcp.json

El comando claude mcp add registra el servidor solo para ti, en local. Para compartir la configuración con tu equipo o versionarla en el proyecto, crea un archivo .mcp.json en la raíz del repositorio.

{
  "mcpServers": {
    "notion": {
      "type": "http",
      "url": "https://mcp.notion.com/mcp"
    },
    "mi-base": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "nombre-del-paquete-mcp"],
      "env": {
        "MI_CLAVE_API": "${MI_CLAVE_API}"
      }
    }
  }
}

Las variables de entorno entre ${} se resuelven desde tu shell en el momento del lanzamiento. Los secretos nunca se escriben en claro en el archivo versionado.

Algunos servidores MCP que conviene conocer

La especificación MCP la mantiene Anthropic, pero el ecosistema es abierto. Aquí hay tres servidores que ilustran bien la diversidad de casos de uso:

Filesystem - Acceso seguro al sistema de archivos, con control preciso de las carpetas accesibles. Útil para darle a Claude Code un perímetro explícito sobre tu árbol de directorios.

GitHub - Leer las PR, crear issues, publicar reviews sin salir de la terminal. Claude puede recorrer el historial y comentar directamente.

Supabase - Conectar Claude Code a tu base PostgreSQL y a tus funciones Edge. Es el ejemplo desarrollado en el siguiente paso de este puente, en el lado Supabase.