MCP en Claude Code: conexión de servidores, ámbitos, MCP remoto y ejemplos reales

Añadir un servidor

# local server over stdio (runs the command, talks over its stdin/stdout)
claude mcp add playwright -- npx @playwright/mcp@latest

# remote server over HTTP
claude mcp add --transport http github https://api.githubcopilot.com/mcp/

# with a header (API-key style auth)
claude mcp add --transport http posthog https://mcp.posthog.com/mcp \
  --header "Authorization: Bearer $POSTHOG_API_KEY"

claude mcp list      # what is configured
claude mcp remove playwright

Los servidores stdio son programas que Claude Code inicia por ti; la mayoría de los servidores de la comunidad son paquetes de npm o Python que se ejecutan de esta forma. Los servidores remotos son URL; se autentican con OAuth (ejecuta /mcp en una sesión y sigue el proceso en el navegador) o con una cabecera que proporcionas al añadirlos, como en el ejemplo de PostHog. Consulta la documentación de cada proveedor para obtener la URL actual; los endpoints remotos cambian de ubicación.

Ámbitos y .mcp.json

• local (predeterminado) — se almacena en tu configuración de usuario, solo para este proyecto. Servidores personales y privados.
• project (--scope project) — se escribe en .mcp.json en la raíz del repositorio y se comparte con cualquiera que lo clone. Claude Code pide permiso antes de confiar en los servidores de un proyecto por primera vez.
• user (--scope user) — disponible en todos los proyectos de tu equipo.

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "${DATABASE_URL}"]
    }
  }
}

.mcp.json admite la expansión de variables de entorno, de modo que el repositorio puede incluir la definición del servidor mientras cada desarrollador aporta sus propias credenciales.

Usar un servidor en una sesión

Una vez conectado, las herramientas del servidor están disponibles sin más: pide «los errores de las últimas 24 horas de PostHog» y Claude Code llama a la herramienta. Los recursos que expone el servidor se pueden referenciar mediante menciones con @ (@github:issue://123), que los incorporan al contexto cuando se necesitan. Los prompts que define un servidor aparecen como comandos con barra bajo /mcp__<server>__<prompt>. /mcp muestra el estado de la conexión, permite volver a conectarte o autenticarte y enumera todas las herramientas con sus descripciones.

Ejemplos que merece la pena copiar

• PostHog MCP — analítica de producto desde el agente: «¿qué indicador de funcionalidad controla este código y cuál es su despliegue?» PostHog publica un servidor MCP remoto; añádelo con --transport http y tu clave de API personal como cabecera bearer.
• GitHub — incidencias y solicitudes de incorporación de cambios como contexto; combínalo con la Action de la guía de GitHub para el ciclo de revisión.
• Playwright — un navegador real para pruebas de extremo a extremo y para comprobar la interfaz que acabas de modificar; consulta la guía de automatización de QA.
• Postgres / SQLite — consultas y migraciones que tienen en cuenta el esquema; asígnale un usuario de solo lectura salvo que quieras permitir cambios.
• Sistema de archivos fuera del repositorio — --add-dir es más sencillo para directorios adicionales; MCP es para elementos que no son archivos.

Coste y contexto

Cada resultado de herramienta que devuelve un servidor MCP se incorpora a la conversación y se vuelve a enviar en cada turno posterior. Un servidor que devuelve 5,000 filas es una bomba para el contexto. Prioriza herramientas con límites, pide resúmenes y /compact después de una consulta pesada. Los servidores se ejecutan localmente o se conectan al proveedor; no pasan por el endpoint del modelo, así que ANTHROPIC_BASE_URL=https://aiprimetech.io no se ve afectado: solo se facturan los tokens que consumen los resultados.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Preguntas frecuentes

AI Prime Tech es una pasarela API independiente y no está afiliada a Anthropic, ni cuenta con su respaldo o patrocinio. «Claude» y «Claude Code» son marcas comerciales de Anthropic. Las funciones de Claude Code descritas aquí se basan en la documentación pública de Anthropic en el momento de la redacción y cambian con frecuencia; los precios y las listas de modelos de esta página se obtienen de la configuración actual de esta pasarela.