Generador de configuración MCP: Claude, Cursor, VS Code, Windsurf y Codex
Define un servidor MCP una sola vez y obtén el archivo de configuración o el comando exacto para Claude Desktop, Claude Code, Cursor, VS Code, Windsurf y Codex.
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/you/projects"
]
},
"github": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.githubcopilot.com/mcp/",
"--header",
"Authorization:${MCP_HEADER_1}"
],
"env": {
"MCP_HEADER_1": "Bearer ${GITHUB_PAT}"
}
}
}
}
- Archivo: en macOS ~/Library/Application Support/Claude/claude_desktop_config.json, en Windows %APPDATA%\Claude\claude_desktop_config.json (ábrelo desde Settings > Developer > Edit Config). Cierra Claude por completo y vuelve a abrirlo después de guardar.
- Los servidores remotos se conectan mediante mcp-remote (requiere Node.js). En los planes de pago puedes añadir la URL en Settings > Connectors, que gestiona OAuth por ti.
- Claude Desktop no expande ${VAR} en este archivo; sustituye esos marcadores por valores reales.
Funciona por completo en tu navegador. Las configuraciones suelen contener tokens de API, así que nada de lo que escribes o pegas se sube ni se guarda. Ver todas las herramientas gratis.
¿Encontraste un problema o algo que podría mejorar? Leemos todos los mensajes y lo arreglamos rápido.
Este generador de configuración MCP escribe los ajustes de servidor de Model Context Protocol para los principales clientes de IA a partir de un solo formulario. Cada cliente quiere un archivo ligeramente distinto: Claude Desktop y Cursor usan un objeto "mcpServers", VS Code usa "servers" con un "type" obligatorio, Windsurf llama a la URL remota "serverUrl", Claude Code necesita "type" en las entradas remotas y Codex usa tablas TOML. Introduce el comando o la URL una vez y copia la versión adecuada para la herramienta que uses.
El validador hace lo contrario: pega una configuración que no se carga y te señalará el error de JSON, el campo que falta o la clave que el cliente no lee, y después cargará los servidores en el formulario para que puedas convertirlos. Comprueba la estructura, no si el paquete del servidor existe o el token es válido; si un servidor sigue fallando, revisa el registro MCP del cliente.
Cómo usarla
- Haz clic en un ajuste predefinido como Filesystem o GitHub, o añade un servidor en blanco.
- Para un servidor local, indica el comando (npx, uvx, docker) y pon cada argumento en su propia línea. Para un servidor remoto, indica la URL y las cabeceras que necesite.
- Si quieres, marca la opción que mantiene los secretos fuera del archivo y sustituye los valores por referencias ${VAR}.
- Elige tu cliente y copia o descarga la salida, y guárdala en la ruta que aparece debajo.
- Reinicia el cliente (cierra Claude Desktop por completo) para que vuelva a cargar la configuración. Para corregir un archivo existente, pégalo en Validar y convertir.
Preguntas frecuentes
¿Dónde está claude_desktop_config.json?
En macOS está en ~/Library/Application Support/Claude/claude_desktop_config.json y en Windows en %APPDATA%\Claude\claude_desktop_config.json. La forma más fácil de abrirlo es Configuración > Desarrollador > Editar configuración en Claude Desktop. Cierra Claude por completo y vuelve a abrirlo después de guardar, porque el archivo solo se lee al iniciar.
¿Qué diferencia hay entre el .mcp.json de Claude Code y claude mcp add?
claude mcp add registra un servidor desde el terminal. Con el ámbito local por defecto se guarda en ~/.claude.json solo para ti y para el proyecto actual; --scope user lo pone a tu disposición en todos tus proyectos; --scope project lo escribe en .mcp.json en la raíz del proyecto para que el equipo lo comparta a través del control de versiones. Cada entrada de .mcp.json debería llevar un "type" (stdio, http o sse); una entrada con url pero sin type se interpreta como stdio y falla.
¿Por qué VS Code ignora mi configuración mcpServers?
VS Code lee .vscode/mcp.json con una clave de nivel superior "servers", no "mcpServers", y cada servidor necesita "type": "stdio", "http" o "sse". Por eso un archivo copiado del README de Claude o de Cursor no carga nada. Pégalo en el validador y conviértelo al formato de VS Code.
¿Cómo mantengo las claves de API fuera de mi configuración MCP?
Haz referencia a variables de entorno en lugar de pegar los valores. Claude Code expande ${VAR} y ${VAR:-default}; Cursor y Windsurf usan ${env:VAR}; VS Code admite ${env:VAR} y solicitudes ${input:id} que guardan el secreto de forma segura; Codex pasa las variables con env_vars, env_http_headers y bearer_token_env_var. Claude Desktop no expande variables en su configuración, así que ahí los valores tienen que ser literales.
¿Cómo añado un servidor MCP remoto a Claude Desktop?
El archivo de configuración de Claude Desktop solo lanza comandos locales. En los planes de pago puedes añadir la URL de un servidor remoto en Configuración > Conectores, que además gestiona el inicio de sesión con OAuth. Si no, haz de puente con mcp-remote: el comando es npx con los argumentos -y, mcp-remote y la URL del servidor, más opciones --header para la autenticación. El generador escribe ese puente por ti cuando eliges Claude Desktop.
¿Qué diferencia hay entre los transportes stdio, HTTP y SSE?
Los servidores stdio se ejecutan como un proceso local que el cliente inicia y con el que se comunica por la entrada y la salida estándar, lo que va bien para herramientas que leen archivos o se ejecutan en tu equipo. Los servidores Streamable HTTP se ejecutan de forma remota en una URL y son el estándar actual para servidores alojados. SSE es el transporte remoto antiguo; Claude Code lo marca como obsoleto y Codex solo admite Streamable HTTP, así que elige HTTP cuando un servidor ofrezca ambos.
Ubicaciones y formatos de los archivos de configuración MCP
• Claude Desktop: claude_desktop_config.json en ~/Library/Application Support/Claude (macOS) o %APPDATA%\Claude (Windows). "mcpServers" en el nivel superior; las entradas tienen command, args y env.
• Claude Code: .mcp.json en la raíz del proyecto (ámbito de proyecto) o ~/.claude.json (ámbitos local y de usuario, gestionados por claude mcp add). "mcpServers" en el nivel superior, con "type" en cada entrada.
• Cursor: .cursor/mcp.json en el proyecto o ~/.cursor/mcp.json de forma global. "mcpServers"; las entradas remotas usan "url" y "headers".
• VS Code: .vscode/mcp.json en el espacio de trabajo, o el archivo de usuario que se abre con "MCP: Open User Configuration". "servers" en el nivel superior y, opcionalmente, "inputs".
• Windsurf: ~/.codeium/windsurf/mcp_config.json. La documentación de Windsurf está ahora en Devin Desktop, que usa ~/.config/devin/mcp_config.json (macOS/Linux) o %APPDATA%\devin\mcp_config.json. Las entradas remotas usan "serverUrl".
• Codex: ~/.codex/config.toml, o .codex/config.toml en un proyecto de confianza. Una tabla [mcp_servers.<name>] por servidor, con command/args/env o url más bearer_token_env_var y http_headers.
Motivos habituales por los que un servidor MCP no se carga
• Todo el comando está en "command" ("npx -y @scope/server"). El cliente busca un ejecutable con ese nombre completo. Pon npx en command y el resto en args, un elemento cada uno.
• Una coma final o un comentario // en el JSON. Solo el mcp.json de VS Code acepta comentarios; los demás clientes necesitan JSON estricto.
• No se encuentra npx o uvx. En macOS, las aplicaciones con interfaz gráfica no siempre heredan el PATH de tu shell; usa como comando la ruta completa que devuelve `which npx`.
• La clave de nivel superior incorrecta: "servers" en un archivo de Claude o Cursor, o "mcpServers" en VS Code.
• Una entrada remota sin "type" en el .mcp.json de Claude Code, que entonces se trata como un comando local.
• No se reinició el cliente. Claude Desktop solo lee el archivo al iniciar; Cursor y VS Code muestran el estado de los servidores en sus paneles de ajustes MCP.
Notas de seguridad antes de añadir un servidor
Un servidor MCP se ejecuta con tus permisos: un servidor de sistema de archivos puede leer y modificar todas las carpetas que indiques, y un servidor de base de datos puede ejecutar consultas con las credenciales que le des. Concede el ámbito más reducido que funcione, como una sola carpeta del proyecto, un usuario de base de datos de solo lectura o un token de GitHub de permisos detallados limitado a los repositorios que necesitas.
Instala los servidores desde su editor oficial, fija las versiones de todo lo que toque producción y prefiere servidores remotos con OAuth antes que tokens de larga duración pegados en un archivo. Trata la salida de las herramientas como entrada no fiable: una página web o un issue que descargue un servidor puede contener instrucciones dirigidas al modelo.
Herramientas gratis relacionadas
- Formateador JSON — Formatea, minifica y valida JSON, con los errores de análisis localizados por línea y columna. En tu navegador, sin subir nada.
- Creador de plantillas de prompts — Escribe un prompt con {{variables}}, rellénalo desde un formulario o un CSV y exporta un prompt por fila como texto, CSV o archivos de lotes de OpenAI y Anthropic.
- Calculadora de costes de API de LLM — Compara el coste de tu carga de trabajo en más de 40 modelos, con caché, descuentos por lotes, tramos de contexto largo y tokens de razonamiento. Precios con fuente y fecha.
- Generador de llms.txt — Crea un llms.txt conforme a la especificación a partir de un formulario, una lista de URL o tu sitemap, valida uno existente y genera reglas de robots.txt para los rastreadores de IA.