Source: https://aiprimetech.io/es/claude-code/mcp/ [Inicio](/es/) › [Claude Code](/es/claude-code/) › MCP [Descripción general](/es/claude-code/)[Instalación](/es/claude-code/install/)[referencia de la CLI](/es/claude-code/cli/)[Precios y límites](/es/claude-code/pricing/)[Agent SDK](/es/claude-code/sdk/)[Habilidades y plugins](/es/claude-code/skills/)[GitHub](/es/claude-code/github/)[Web, escritorio e IDE](/es/claude-code/web-and-desktop/)[Modelos](/es/claude-code/models/)[Errores](/es/claude-code/errors/)[¿Código abierto?](/es/claude-code/open-source/)[Tutorial](/es/claude-code/tutorial/)[Para estudiantes](/es/claude-code/for-students/)[Automatización de QA](/es/claude-code/qa-automation/)[Comparación con Cursor](/es/claude-code/vs-cursor/)[Comparación con Codex y OpenCode](/es/claude-code/vs-codex/)[Subagentes](/es/claude-code/subagents/)[Hooks](/es/claude-code/hooks/)[MCP](/es/claude-code/mcp/)[Ecosistema](/es/claude-code/ecosystem/)[VS Code](/es/claude-code/vscode/)[OpenRouter](/es/claude-code/openrouter/)[Límites de solicitudes](/es/claude-code/rate-limits/)[Guía en chino](/claude-code/zh/) Última actualización: 11 de octubre de 2026 # MCP en Claude Code: conexión de servidores, ámbitos, MCP remoto y ejemplos reales MCP —el Protocolo de Contexto del Modelo— es la forma en que Claude Code accede a elementos que no son archivos de tu repositorio: una base de datos, un navegador, GitHub, tus analíticas o tu gestor de incidencias. Un servidor expone herramientas y recursos; Claude Code se conecta a él y el agente puede utilizarlos como cualquier herramienta integrada. La configuración requiere un comando por servidor. ## TLDR - claude mcp add -- para servidores locales (stdio); claude mcp add --transport http para los remotos. - Ámbitos: local (tú, este proyecto), proyecto (.mcp.json, compartido con el repositorio), usuario (tú, todos los proyectos). - /mcp dentro de una sesión muestra el estado, autentica los servidores OAuth y enumera sus herramientas. - Los recursos se pueden mencionar con @; los prompts del servidor aparecen como comandos con barra. ## 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____. /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. ## Pruébalo gratis primero Las cuentas nuevas reciben $5 de crédito gratuito para la API con el código CLAUDECODE — suficiente para una tarde de Claude Code con Sonnet — y después créditos por 7.69231× su valor nominal. ``` export ANTHROPIC_BASE_URL=https://aiprimetech.io export ANTHROPIC_API_KEY=your_key ``` [Crea una cuenta con el código CLAUDECODE](/register?promo=CLAUDECODE) ## Preguntas frecuentes ¿Cómo añado un servidor MCP a Claude Code? `claude mcp add -- ` para un servidor local, o `claude mcp add --transport http ` para uno remoto; añade `--scope project` para compartirlo mediante .mcp.json.¿Cómo conecto PostHog a Claude Code? Añade el servidor MCP remoto de PostHog con `claude mcp add --transport http posthog --header "Authorization: Bearer "`, usando la URL de la documentación de MCP de PostHog, y después pregunta sobre eventos, indicadores de funcionalidad o errores en una sesión.¿MCP funciona a través de una pasarela? Sí. Los servidores MCP se ejecutan localmente o se conectan al proveedor y son independientes del endpoint del modelo; solo los tokens que consumen sus resultados se facturan a través de la pasarela. ## Ejecuta Claude Code con la pasarela Los mismos modelos, dos variables de entorno y créditos por 7.69231× su valor nominal, o un plan ilimitado de tarifa plana. Cuentas nuevas: $5 de crédito gratuito para la API con el código CLAUDECODE.[Obtener una clave de API](/register?promo=CLAUDECODE) [Ver planes ilimitados](/es/plans/) 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. ## Más guías de Claude Code [Claude Code: la guía completa](/es/claude-code/)[Cómo instalar Claude Code](/es/claude-code/install/)[Documentación de la CLI de Claude Code: comandos y opciones](/es/claude-code/cli/)[Precios y límites de Claude Code, explicados](/es/claude-code/pricing/)[El SDK de Claude Code, ahora Claude Agent SDK](/es/claude-code/sdk/)[Habilidades y plugins de Claude Code](/es/claude-code/skills/)[Claude Code en GitHub: la App, la Action y @claude](/es/claude-code/github/)[¿Claude Code tiene una interfaz web? Explicación de las versiones web, de escritorio y para IDE](/es/claude-code/web-and-desktop/)[Qué modelo utiliza Claude Code y cómo cambiarlo](/es/claude-code/models/)[Errores de Claude Code y cómo solucionarlos](/es/claude-code/errors/)[¿Claude Code es de código abierto?](/es/claude-code/open-source/)[Tutorial de Claude Code: tu primera sesión real](/es/claude-code/tutorial/)[Claude para estudiantes: Claude Code, la API y qué ofrece realmente el ámbito educativo](/es/claude-code/for-students/)[Cómo usar Claude Code para automatizar QA](/es/claude-code/qa-automation/)[Claude Code frente a Cursor: cuál usar, cuándo y cómo ejecutar ambos](/es/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: comparativa de los agentes de terminal](/es/claude-code/vs-codex/)[Subagentes de Claude Code: cómo funcionan, cómo definirlos y equipos de agentes](/es/claude-code/subagents/)[Hooks de Claude Code: control determinista sobre lo que hace el agente](/es/claude-code/hooks/)[El ecosistema de Claude Code: enrutadores, frameworks, plugins y las listas que los recopilan](/es/claude-code/ecosystem/)[Claude Code en VS Code: la extensión, el uso desde la terminal y los errores](/es/claude-code/vscode/)[Cómo usar OpenRouter en Claude Code (y cuándo no hacerlo)](/es/claude-code/openrouter/)[Error de límite de solicitudes de Claude: qué significa «Error de API: se ha alcanzado el límite de solicitudes» y cómo solucionarlo](/es/claude-code/rate-limits/)[Cómo usar Claude Code: desde la instalación hasta el uso diario](/claude-code/zh/)