Traducción automática en fase de mejora, sin revisión nativa todavía. Informa de errores en GitHub (se abre en una pestaña nueva).
Model Context Protocol

Los MCP: dale
superpoderes a Claude Code

Conecta Claude Code a tus herramientas favoritas (GitHub, Slack, Gmail, bases de datos) y conviértelo en un asistente todopoderoso que actúa en tu entorno real.

6 guías

Explora los MCP en profundidad

De la teoría a la práctica, cada guía cubre un aspecto esencial de los MCP. Síguelas en orden o elige directamente la que te interese.

Concepto

¿Qué es un MCP?

El Model Context Protocol es el adaptador universal entre Claude Code y el resto del mundo digital.

La analogía simple

Imagina que Claude Code es un experto polivalente encerrado en una habitación. Es brillante, pero no puede tocar nada fuera de esa habitación. Los MCP son enchufes universales que conectas entre Claude y tus herramientas: tu bandeja de correo, tu código fuente, tus bases de datos, tu navegador...

Cada MCP abre una puerta nueva. Sin MCP, Claude Code solo puede leer y escribir archivos locales. Con los MCP, puede enviar un mensaje de Slack, crear una pull request en GitHub, ejecutar una consulta SQL y mucho más. Todo desde el terminal.

Sin MCP

Claude Code lee y escribe archivos locales. Potente, pero aislado.

+ MCP

Conectas adaptadores que enlazan Claude con tus servicios.

Resultado

Un asistente que actúa en tu entorno real, no solo en un chat.

Arquitectura

¿Cómo funciona?

El MCP actúa como un puente estandarizado entre Claude Code y los servicios externos.

Tú

"Muéstrame las issues abiertas en GitHub"

Claude Code

Entiende tu petición y llama al MCP adecuado

MCP Server

Traduce la petición en llamadas a la API

Servicio externo

GitHub, Slack, Gmail, BD...

Instalación

¿Cómo instalar un MCP?

Tres pasos sencillos para conectar un nuevo servicio a Claude Code.

1

Abrir la configuración de Claude Code

Los MCP se configuran en el archivo settings.json de Claude Code. Puedes modificarlo directamente o usar el comando dedicado.

Terminalbash
# Abrir la configuración desde Claude Code
claude mcp add <nombre-del-mcp> -- <comando> <args>


# O editar manualmente el archivo de configuración
# ~/.claude/settings.json (configuración global)
# .claude/settings.json  (configuración por proyecto)
2

Añadir el MCP en settings.json

Cada MCP se declara en la sección mcpServers. Esta es la estructura típica:

~/.claude/settings.jsonjson
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/ruta/a/tu/carpeta"
      ]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_tu_token_aqui"
      }
    }
  }
}
3

Comprobar que el MCP está activo

Reinicia Claude Code y comprueba que las herramientas del MCP están disponibles. Claude Code detecta automáticamente los MCP configurados al arrancar.

Terminalbash
# Listar los MCP configurados
claude mcp list


# Probar un MCP pidiéndole a Claude que lo use
claude "Lista los archivos de mi carpeta de proyecto"
Recomendaciones

Los MCP imprescindibles

Nuestra selección de los mejores MCP servers para empezar y avanzar con Claude Code.

Principiante

Filesystem

Leer y escribir archivos, explorar directorios, buscar contenido. La herramienta básica para interactuar con tu sistema de archivos.

Organizar, analizar y transformar tus archivos locales

Intermedio

GitHub

Gestionar pull requests e issues, buscar código, consultar workflows de CI/CD. Imprescindible para desarrolladores.

Automatizar la gestión de tus repositorios

Intermedio

PostgreSQL / SQLite

Consultar tus bases de datos directamente desde Claude Code. Ejecutar consultas SQL, analizar esquemas, exportar resultados.

Explorar y analizar tus datos sin salir del terminal

Avanzado

Puppeteer / Playwright

Automatizar un navegador web: hacer capturas de pantalla, rellenar formularios, hacer scraping de páginas, probar interfaces.

Pruebas E2E, web scraping y automatización de navegador

Principiante

Slack

Leer y enviar mensajes, gestionar canales, buscar en el historial. Conecta la comunicación de tu equipo con Claude.

Automatizar notificaciones y la vigilancia del equipo

Principiante

Gmail

Leer, buscar y clasificar tus correos. Crear borradores, analizar conversaciones, extraer información clave.

Ahorrar tiempo en la gestión de tu correo

Tutorial

Tu primer flujo de trabajo MCP

Instala y usa el MCP Filesystem en 5 minutos para descubrir el poder de los MCP.

1

Instalar el MCP Filesystem

El MCP Filesystem es el más sencillo para empezar. Permite que Claude Code lea y manipule los archivos de una carpeta que tú elijas.

Terminalbash
# Añadir el MCP Filesystem en un solo comando
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /home/tu-usuario/proyectos
2

Comprobar la configuración

Asegúrate de que el MCP está bien registrado en tu configuración.

Terminalbash
claude mcp list


# Resultado esperado:
# filesystem: connected
#   Tools: read_file, write_file, list_directory, search_files, ...
3

Usar el MCP en una conversación

Lanza Claude Code y pídele que use los archivos. Detectará automáticamente el MCP Filesystem y lo usará.

Terminalbash
# Lanzar Claude Code
claude


# Luego pide, por ejemplo:
> Lista todos los archivos TypeScript de mi carpeta de proyectos
> y dame un resumen de cada archivo.


# Claude hará automáticamente:
# 1. Usar list_directory para explorar la carpeta
# 2. Usar read_file para leer cada archivo .ts
# 3. Darte un resumen estructurado
4

Ir más allá

Combina varios MCP para crear flujos de trabajo potentes. Por ejemplo, usa Filesystem + GitHub para analizar un proyecto local y crear automáticamente una pull request.

~/.claude/settings.jsonjson
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/home/tu-usuario/proyectos"
      ]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..."
      }
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "xoxb-..."
      }
    }
  }
}
Buenas prácticas

Sacar el máximo partido a los MCP

Principio de mínimo privilegio

Concede a cada MCP solo los permisos necesarios. Limita las carpetas accesibles al MCP Filesystem y usa tokens con permisos restringidos para GitHub.

Configuración por proyecto

Usa el archivo .claude/settings.json en la raíz de cada proyecto para MCP específicos. Reserva la configuración global (~/.claude/settings.json) para los MCP universales.

Combina los MCP

El verdadero potencial surge cuando Claude encadena varios MCP en un mismo flujo de trabajo. Filesystem + GitHub + Slack = automatización completa.

Documenta tus configuraciones

Añade un archivo CLAUDE.md en la raíz de tus proyectos para explicar qué MCP se usan y por qué. Claude Code lo leerá automáticamente.

Continúa tu aprendizaje

Los MCP son solo una pieza del puzle. Descubre los Skills para enseñar comportamientos personalizados a Claude Code, y domina el prompting avanzado para resultados excepcionales.

Descubrir los SkillsDominar el prompting