Model Context Protocol (MCP): Guía de Configuración para Claude

Durante la mayor parte de la breve historia de la IA, conectar un modelo de lenguaje a una herramienta externa significaba escribir código de integración personalizado para cada herramienta. ¿Quieres que el modelo lea un archivo? Escribe una función. ¿Consultar una base de datos? Escribe una función diferente, en un formato diferente, para cada modelo que quieras soportar. El resultado fue un ecosistema fragmentado donde cada aplicación de IA reinventaba la misma plomería desde cero.

Model Context Protocol (MCP) es la respuesta de Anthropic a este problema: un estándar abierto que da a los modelos de IA una interfaz única y consistente para herramientas, archivos, bases de datos y servicios. Puedes usar el Generador de Configuración MCP de BrowseryTools —gratis, sin registro, todo se queda en tu navegador— para construir y validar archivos de configuración MCP sin escribir JSON a mano.

¿Qué Es MCP y Por Qué Existe?

MCP son las siglas de Model Context Protocol. Es un protocolo abierto —publicado por Anthropic a finales de 2024 y disponible en modelcontextprotocol.io— que estandariza cómo se comunican los modelos de IA con fuentes de datos y herramientas externas. Piensa en él como un adaptador universal: en lugar de que un modelo necesite un plugin personalizado para GitHub, uno diferente para tu sistema de archivos y otro para tu base de datos, MCP proporciona una única interfaz que cualquier cliente y servidor compatible pueden hablar.

La analogía que usa Anthropic es el USB-C: antes del USB-C, necesitabas un cable diferente para cada dispositivo. MCP aspira a ser ese conector universal para el uso de herramientas de IA. Una herramienta construida una vez como servidor MCP funciona con cualquier cliente compatible con MCP —Claude Desktop, Claude Code y cualquier otro host que implemente el protocolo.

Arquitectura MCP: Clientes, Hosts y Servidores

MCP tiene tres componentes que trabajan juntos:

• Host — La aplicación de IA que se ejecuta en la máquina del usuario (por ejemplo, Claude Desktop, una extensión de IDE). El host gestiona las conexiones con uno o más servidores MCP e inyecta sus capacidades en el contexto de IA.
• Cliente — Un cliente de protocolo integrado en el host que mantiene una conexión 1:1 con un único servidor MCP. El host genera un cliente por servidor.
• Servidor — Un programa ligero que expone capacidades (herramientas, recursos, prompts) a través del protocolo MCP. Los servidores pueden ser procesos locales (que se ejecutan en tu máquina) o servicios remotos accesibles a través de HTTP.

Cuando le pides a Claude que «lea el README de mi proyecto», el cliente MCP del host envía una solicitud al servidor MCP del sistema de archivos, que lee el archivo y devuelve el contenido. Claude nunca toca directamente tu sistema de archivos —lo hace el servidor, que informa a través del protocolo.

Qué Pueden Exponer los Servidores MCP

Los servidores MCP pueden exponer tres tipos de capacidades:

• Herramientas — Funciones que el modelo puede llamar. Ejemplos: buscar en una base de datos, crear un issue en GitHub, ejecutar un comando de terminal, obtener una URL.
• Recursos — Datos que el modelo puede leer. Ejemplos: archivos, filas de base de datos, respuestas de API, páginas de documentación. Los recursos son como fuentes de contexto de solo lectura.
• Prompts — Plantillas de prompts preconstruidas que los usuarios pueden invocar por nombre. Útiles para exponer flujos de trabajo estandarizados.

Servidores MCP Comunes que Vale la Pena Conocer

• filesystem — Lee y escribe archivos en tu máquina local dentro de un directorio especificado. El servidor más comúnmente usado. Necesario para que Claude Code lea tu base de código.
• github — Busca repositorios, lee archivos, crea issues y pull requests, obtiene el historial de commits. Usa la API de GitHub con tu token de acceso personal.
• postgres / sqlite — Ejecuta consultas SQL contra una base de datos. Solo lectura por defecto en la mayoría de las implementaciones por seguridad.
• brave-search / fetch — Obtiene URLs o realiza búsquedas web, dando al modelo acceso a información actual más allá de su fecha de corte de entrenamiento.
• memory — Almacenamiento de clave-valor persistente que sobrevive entre sesiones. Da al modelo una capa de memoria en la que puede escribir y leer.
• puppeteer / playwright — Controla un navegador sin cabeza. Permite al modelo navegar por páginas web, rellenar formularios y extraer contenido de sitios renderizados con JavaScript.

Escribir un JSON de Configuración MCP Básico

La configuración MCP vive en un archivo JSON que la aplicación host lee al arrancar. Para Claude Desktop en macOS, este archivo está en ~/Library/Application Support/Claude/claude_desktop_config.json. La estructura es consistente independientemente de los servidores que añadas:

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

Cada clave dentro de mcpServers es el nombre que le das al servidor —esta es la etiqueta que aparece en la interfaz de Claude. Los campos command y args definen cómo iniciar el proceso del servidor. La mayoría de los servidores oficiales son paquetes npm, por lo que npx -y los descarga y ejecuta en el primer uso sin un paso de instalación separado.

Añadir Múltiples Servidores

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Projects"
      ]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
      }
    },
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost/mydb"
      ]
    }
  }
}

El campo env pasa variables de entorno al proceso del servidor. Los valores sensibles como las claves de API y las credenciales de base de datos deben ir aquí, no codificados en args, para que puedas gestionarlos por separado y evitar confirmarlos accidentalmente en el control de versiones.

Configurar MCP en Claude Code

Claude Code (la herramienta CLI) usa un mecanismo de configuración ligeramente diferente. Añades servidores MCP con el comando claude mcp add:

# Add a local stdio server
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/dir

# Add a remote HTTP server
claude mcp add my-server --transport http http://localhost:8080/mcp

# Add with environment variables
claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=ghp_... -- npx -y @modelcontextprotocol/server-github

# List all configured servers
claude mcp list

Claude Code almacena las configuraciones de servidores en ~/.claude/ por defecto (ámbito de usuario) o en .mcp.json en la raíz del proyecto (ámbito de proyecto). Las configuraciones de ámbito de proyecto son útiles para los repositorios de equipos —confirma el .mcp.json y todos en el equipo obtendrán automáticamente la misma configuración de servidores.

Errores de Configuración Comunes

• Separador de ruta incorrecto — Windows usa barras invertidas pero las cadenas JSON requieren barras hacia adelante o barras invertidas escapadas. Usa siempre barras hacia adelante en las configuraciones MCP, incluso en Windows.
• Permisos de directorio faltantes — El servidor de sistema de archivos solo puede acceder a los directorios que enumeras explícitamente en sus argumentos. Si Claude dice que no puede encontrar un archivo, verifica que el directorio padre del archivo esté en la lista permitida.
• Proceso de servidor obsoleto — Si un servidor se cuelga, el host puede no reiniciarlo automáticamente. Reinicia Claude Desktop o ejecuta claude mcp restart <name> en Claude Code para obtener una conexión nueva.
• Incompatibilidades de versiones — MCP se desarrolla activamente. Si un servidor se está comportando de forma inesperada, verifica si estás ejecutando la última versión con npx -y @modelcontextprotocol/server-name@latest.

Genera Tu Configuración con BrowseryTools

Escribir JSON de MCP a mano es tedioso y fácil de equivocar —una coma que falta o una ruta entre comillas incorrectas hace que toda la configuración falle silenciosamente. El Generador de Configuración MCP de BrowseryTools te permite seleccionar tus servidores, rellenar los parámetros necesarios y obtener un JSON válido y formateado listo para pegar en tu archivo de configuración de Claude Desktop o .mcp.json. Todo se ejecuta en tu navegador y no se almacenan credenciales.

Resumen

MCP es la capa de infraestructura que transforma un modelo de chat independiente en un agente conectado con acceso a tus archivos, código, bases de datos y servicios reales. El protocolo es abierto, los servidores son modulares y el formato de configuración es JSON sencillo. Una vez que tu configuración MCP está en su lugar, obtienes un asistente de IA dramáticamente más capaz sin cambiar la forma en que interactúas con él —las herramientas simplemente están ahí, listas para usar.