Servidores MCP para Claude Code

Una configuración de Model Context Protocol que merece la pena, junto con las trampas que hacen perder tiempo de verdad.

MCP transforma Claude Code de un generador de código en una herramienta capaz de leer tu repositorio, consultar una base de datos, controlar un navegador y abrir una PR. La configuración de MCP es independiente de la pasarela: cambia las herramientas disponibles, no el destino de las llamadas al modelo.

Un .mcp.json que merece la pena usar

Copy{
  "mcpServers": {
    "filesystem": {"command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]},
    "git":        {"command": "uvx", "args": ["mcp-server-git", "--repository", "."]},
    "github":     {"command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"],
                   "env": {"GITHUB_TOKEN": "..."}},
    "fetch":      {"command": "uvx", "args": ["mcp-server-fetch"]},
    "playwright": {"command": "npx", "args": ["-y", "@playwright/mcp@latest"]}
  }
}

Colócalo en la raíz del repositorio; Claude Code lo detecta y te pide que confirmes que confías en él una sola vez.

Los errores habituales

• La solicitud de confianza es una funcionalidad. Claude Code se niega a cargar los servidores MCP del proyecto hasta que los apruebes, proyecto por proyecto. Ese es el límite de seguridad, no un fallo.
• Asigna un rol de solo lectura al servidor de base de datos. Un servidor MCP ejecuta cualquier SQL que genere el modelo; un rol de solo lectura hace que una operación inventada de DROP sea físicamente imposible.
• Limita estrictamente los permisos de los tokens. Para GitHub, repo junto con read:org es suficiente. No le proporciones un PAT clásico con todos los permisos.
• La salida de MCP forma parte del contexto. Un resultado de 200 filas o el contenido completo de una página se vuelve a enviar en cada turno posterior. Las salidas extensas de las herramientas son la principal razón por la que las sesiones con agentes resultan caras.