La respuesta corta
La mayoría de las apps de IA guardan sus servidores MCP en un archivo JSON, bajo la clave mcpServers. VS Code usa servers, Zed usa context_servers y Codex una tabla TOML. Busca tu app más abajo, edita su archivo y ciérrala y ábrela de nuevo. Los límites de herramientas son raros: VS Code permite 128 por solicitud y Windsurf 100.
En esta guía
¿Dónde está el archivo de configuración MCP de cada app?
La mayoría de las apps tienen un archivo para todos tus proyectos y otro para un solo proyecto. La tabla da los dos, cómo abrirlos y la clave bajo la que van tus servidores.
| App | Archivo de configuración | Clave |
|---|---|---|
Claude Codeclaude mcp add, o /mcp en una sesión |
~/.claude.json. El .mcp.json de un proyecto está pensado para compartirse con tu equipo. | mcpServers |
| Claude DesktopSettings, Developer, Edit Config |
| mcpServers |
| Cursor |
| mcpServers |
VS CodeComando: MCP: Open User Configuration |
| serversFormato propio de VS Code. Un .mcp.json portable en la raíz del proyecto usa mcpServers. |
| WindsurfLa documentación de Windsurf ahora está en Devin Desktop |
| mcpServers |
| Gemini CLI |
| mcpServers |
Codexcodex mcp add <name> -- <command> |
| [mcp_servers.<name>]Una tabla TOML por servidor. |
| LM StudioPestaña Program, Install, Edit mcp.json |
| mcpServers |
| ClineIcono MCP Servers, pestaña Configure, Configure MCP Servers |
CLINE_MCP_SETTINGS_PATH para mover el archivo. Dentro de VS Code está en la carpeta de ajustes de usuario. | mcpServers |
| Roo CodeMCP settings, Edit Global MCP o Edit Project MCP |
| mcpServers |
| Amazon QPanel de chat, icono de herramientas |
default.json. Los antiguos ~/.aws/amazonq/mcp.json y .amazonq/mcp.json se siguen leyendo por defecto. | mcpServersEn el mcp.json antiguo. |
ZedComando: zed: open settings file |
| context_servers |
~ es tu carpeta de inicio: C:\Users\you en Windows.
¿Cómo se configura un servidor MCP remoto en cada app?
Un servidor remoto (HTTP) necesita una URL, pero cada app nombra los campos de forma distinta. La misma entrada no se puede pegar de una app a otra.
| App | Campos | Conviene saber |
|---|---|---|
| Claude Code |
| |
| Claude Desktop | — | No se escribe en este archivo. Agrégalo como conector personalizado en Conectores, en los ajustes de la app. |
| Cursor |
| |
| VS Code |
| |
| Windsurf |
| Para la dirección sirve cualquiera de los dos nombres. |
| Gemini CLI |
| httpUrl es streamable HTTP, url es SSE. |
| Codex |
| Se escribe en la tabla TOML del servidor. |
| LM Studio |
| |
| Cline |
| Usa sse para el transporte más antiguo. |
| Roo Code |
| Usa sse para el transporte más antiguo. |
| Amazon Q | — | Se define en el panel MCP: elige http como transporte y después la URL y los encabezados opcionales. |
| Zed |
|
¿Cuál es el límite de herramientas MCP de cada app?
Los límites de herramientas son raros. Dos apps indican uno. Las demás tratan las listas largas de herramientas a su manera.
| App | Límite | Qué hace con las listas largas de herramientas |
|---|---|---|
| VS Code | 128 herramientas por solicitud | Por encima de ese número, VS Code informa Cannot have more than 128 tools per request. Desmarca herramientas o servidores enteros en el selector de herramientas, o define github.copilot.chat.virtualTools.threshold para que VS Code agrupe herramientas similares. |
| Windsurf | 100 herramientas a la vez | Desactiva herramientas una por una con disabledTools en la entrada del servidor. |
| Cursor | Ninguno indicado | Suele citarse un tope de 40 herramientas. La documentación de Cursor no da ningún límite, y su publicación de enero de 2026 describe la carga de las descripciones de herramientas MCP bajo demanda. |
| Claude Code | Ninguno indicado | Tool Search está activado por defecto: solo los nombres de las herramientas entran en tu contexto hasta que se usa una herramienta. |
| Codex | Ninguno indicado | Cada servidor admite listas enabled_tools y disabled_tools. |
| Amazon Q | Ninguno indicado | Cada herramienta se configura como Ask, Always allow o Deny. |
Claude Desktop, Gemini CLI, LM Studio, Cline, Roo Code y Zed no indican ningún límite de herramientas.
Un límite se refiere a cuántas herramientas caben. El costo de esas herramientas en tokens es otra cuestión, y la guía de abajo la responde. Por qué MCP consume tantos tokens
¿Por qué no aparece tu servidor MCP?
Avanza por esta lista. Sigue la guía de solución de problemas del proyecto MCP, escrita para Claude Desktop. Los cuatro primeros pasos valen para cualquier app.
- Cierra la app por completo y vuelve a abrirla
La guía de Claude Desktop dice que, después de editar su archivo, hay que cerrarlo por completo y volver a iniciarlo. Otras apps pueden recargarse solas: vuelve a abrir la tuya si el servidor no aparece.
- Revisa el JSON y la clave
Un error de sintaxis, como unas comillas que faltan o una coma de más, puede impedir que la app lea el archivo. Después revisa la clave:
mcpServersen la mayoría de las apps,serversen VS Code,context_serversen Zed. - Usa rutas absolutas
Las rutas de
argsdeben ser absolutas, no relativas. - Ejecuta el comando por tu cuenta
Pega el comando y los argumentos del servidor en una terminal. Si falla allí, la app tampoco puede iniciarlo.
- Lee los registros
Claude Desktop escribe
mcp.logy unmcp-server-NAME.logpor servidor, en~/Library/Logs/Claudeen macOS y en%APPDATA%\Claude\logsen Windows. - En Windows, revisa APPDATA
Si un registro muestra
${APPDATA}dentro de una ruta, agregaAPPDATAalenvdel servidor con su valor completo, comoC:\Users\you\AppData\Roaming\.
¿Tienes que editar estos archivos a mano?
No para verlos todos en un solo lugar. Delta MCP lee los ajustes MCP de doce apps de IA, las de las tablas de arriba, sin cambiar nada, y lista cada servidor que encuentra.
Para usar esos servidores a través de Delta MCP, cambia una app agregando una entrada llamada mcpdelta. Desactiva la entrada directa de cada servidor que traslada y conserva la original, para dejarla como estaba. Diez apps se cambian por ti; Codex y Zed se configuran a mano por ahora. Antes de cada cambio guarda una copia fechada del archivo.
Preguntas
¿Dónde está claude_desktop_config.json?
En macOS es ~/Library/Application Support/Claude/claude_desktop_config.json, y en Windows %APPDATA%\Claude\claude_desktop_config.json. Lo más rápido es Settings, Developer, Edit Config, que crea el archivo si no existe. Claude Desktop se ofrece en macOS y Windows.
¿Dónde está el mcp.json de Cursor?
~/.cursor/mcp.json guarda los servidores de todos tus proyectos, y .cursor/mcp.json dentro de un proyecto guarda los de ese proyecto. Los dos usan la clave mcpServers.
¿Dónde está el mcp.json de VS Code?
El de un proyecto es .vscode/mcp.json. El tuyo está en la carpeta de tu perfil de usuario: ejecuta MCP: Open User Configuration para abrirlo. VS Code escribe los servidores bajo servers, no bajo mcpServers.
¿Cuál es el límite de herramientas MCP en VS Code?
Una solicitud de chat puede tener como máximo 128 herramientas activadas a la vez, y VS Code informa Cannot have more than 128 tools per request cuando lo superas. Desmarca herramientas o servidores en el selector de herramientas, o define github.copilot.chat.virtualTools.threshold para que VS Code agrupe herramientas similares.
¿Cursor tiene un límite de herramientas MCP?
Su documentación no indica ninguno; la cifra que se cita a menudo es de 40 herramientas. En enero de 2026, Cursor describió la carga de las descripciones de herramientas MCP bajo demanda.
¿Por qué mi configuración MCP no funciona en otra app?
La clave y los campos de servidor remoto cambian. La mayoría de las apps usan mcpServers; VS Code usa servers, Zed context_servers y Codex una tabla TOML. Un servidor remoto es url en Cursor, serverUrl o url en Windsurf, httpUrl o url en Gemini CLI, y type más url en Claude Code y VS Code.
¿Puede Claude Desktop usar servidores MCP remotos desde su archivo de configuración?
No. Los servidores remotos se agregan como conectores personalizados en los ajustes de la app. Los servidores de claude_desktop_config.json son un mecanismo aparte, y no están disponibles en Cowork ni en claude.ai.
¿Dónde guarda Claude Code los servidores MCP?
Tus propios servidores, y los de cada proyecto, están en ~/.claude.json. El .mcp.json de un proyecto, en su raíz, está pensado para compartirse con tu equipo. Agrega un servidor con claude mcp add, o con /mcp en una sesión. Los dos archivos usan la clave mcpServers.
¿Dónde está el mcp_config.json de Windsurf?
La documentación de Windsurf ahora está en Devin Desktop y da ~/.config/devin/mcp_config.json en macOS y Linux, y %APPDATA%\devin\mcp_config.json en Windows. Las versiones anteriores de Windsurf usan ~/.codeium/windsurf/mcp_config.json. Los servidores van bajo mcpServers, y Windsurf admite 100 herramientas a la vez.
Fuentes
- Claude Code, Connect Claude Code to tools via MCP (documentation) Los archivos ~/.claude.json y .mcp.json, la clave mcpServers, el tipo http, Tool Search activado por defecto.
- Model Context Protocol, Connect to local MCP servers Las rutas de archivo de Claude Desktop, Edit Config, el reinicio, los pasos de solución de problemas y las carpetas de registros.
- Claude Help Center, Get started with custom connectors using remote MCP Los servidores remotos son conectores personalizados, aparte de claude_desktop_config.json.
- Cursor, Model Context Protocol (documentation) Los archivos mcp.json global y de proyecto, mcpServers, url y headers; ningún límite de herramientas indicado.
- Cursor, Dynamic context discovery (6 ene 2026) Descripciones de herramientas MCP cargadas bajo demanda.
- Cursor forum, About limitation of the number of MCP tools Un informe de usuario sobre un límite de 40 herramientas.
- VS Code, Add and manage MCP servers in VS Code (documentation) Los archivos mcp.json del espacio de trabajo y del usuario, la clave servers, el .mcp.json portable, el tipo http.
- VS Code, Use tools with agents (documentation) El límite de 128 herramientas y su error, el selector de herramientas, las herramientas virtuales.
- Windsurf, Cascade MCP Configuration (documentation, now on Devin Desktop’s site) La ruta de configuración, mcpServers, serverUrl o url, el límite de 100 herramientas, disabledTools.
- Gemini CLI, MCP servers with Gemini CLI (documentation) Los archivos settings.json, mcpServers, httpUrl y url.
- OpenAI Codex, Model Context Protocol (documentation) config.toml, la tabla mcp_servers, url, enabled_tools y disabled_tools, codex mcp add.
- LM Studio, Use MCP Servers (documentation) Edit mcp.json, mcpServers, url y headers.
- Cline, MCP (documentation) cline_mcp_settings.json y su carpeta, la pestaña Configure, streamableHttp.
- Roo Code, Using MCP in Roo Code (documentation) El mcp_settings.json global y el .roo/mcp.json del proyecto, streamable-http.
- AWS, MCP configuration for Q Developer in the IDE default.json y el mcp.json anterior, el transporte http, los permisos de herramientas.
- Zed, Model Context Protocol (documentation) Las rutas de settings.json, context_servers, url y headers.
- Delta MCP, Supported AI apps (documentation) Las doce apps que reconoce Delta MCP, los archivos que lee y cómo cambia cada una.
Sigue leyendo
- Cómo reducir el consumo de tokens de MCP y por qué es altoCómo reducir el consumo de tokens de MCP: mídelo con /context, entiende sus dos costos y compara cada solución, incluida Tool Search.
- MCP vs CLI para agentes de IA: el origen del costo en tokens¿MCP o CLI para tu agente de IA? Qué cuesta cada uno en tokens, qué muestran las mediciones, cuándo gana la CLI, cuándo MCP y dónde el código supera a ambos.
