¿Qué es MCP?

El Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA usar herramientas y datos a través de servidores. Un servidor puede ser un programa local que el asistente inicia en tu ordenador y con el que se comunica mediante la entrada y la salida estándar (stdio), o un servidor remoto al que el asistente accede por HTTP. Cada asistente guarda sus servidores en su propio archivo de configuración, y cada archivo es un poco distinto.

Cómo usarlo

  1. Elige tu cliente: el asistente o el editor que usas.
  2. Ponle al servidor un nombre formado por letras, números, guiones y guiones bajos.
  3. Para un servidor local, introduce el comando que lo inicia (como npx, uvx o docker), sus argumentos, uno por línea, y las variables de entorno que necesite, como claves de API, en formato KEY=value. Si has pegado una línea de comandos completa en el campo del comando, el botón de separar que hay dentro del campo pasa a los argumentos todo lo que va después de la primera palabra.
  4. Para un servidor remoto, elige URL remota e introduce la URL del servidor y los encabezados que necesite, como Authorization: Bearer <token>.
  5. Copia la configuración en el archivo que aparece en Dónde se guarda o descárgala. Si el archivo ya tiene servidores, añade la nueva entrada junto a ellos dentro de mcpServers ([mcp_servers] en Codex) en lugar de sustituir todo el archivo.
  6. Reinicia la aplicación o vuelve a cargar sus servidores MCP.

Para Claude Code, Codex CLI, Gemini CLI y VS Code, el cuadro Comando también muestra el comando de terminal que añade el servidor por ti.

Clientes

Cliente Archivo de configuración Información útil
Claude Desktop claude_desktop_config.json Solo admite servidores locales. Los servidores remotos se añaden en la aplicación, en Configuración > Conectores > Añadir conector personalizado.
Claude Code .mcp.json en la raíz del proyecto En cambio, claude mcp add guarda los servidores en ~/.claude.json, solo para ti.
Cursor .cursor/mcp.json en el proyecto, o ~/.cursor/mcp.json
VS Code con GitHub Copilot .mcp.json en la raíz del espacio de trabajo, o ~/.copilot/mcp-config.json El formato antiguo servers de .vscode/mcp.json solo sirve para el entorno local obsoleto de VS Code.
Codex CLI ~/.codex/config.toml Un archivo TOML. Los encabezados de un servidor remoto solo se pueden definir en el archivo, no con codex mcp add.
Gemini CLI .gemini/settings.json en el proyecto, o ~/.gemini/settings.json Los servidores remotos usan httpUrl.
Devin Desktop (Windsurf) ~/.config/devin/mcp_config.json, o .devin/mcp_config.json Windsurf pasó a llamarse Devin Desktop. Las claves personales van en .devin/mcp_config.local.json, que queda fuera del control de versiones.

Chrome guarda una descarga llamada .mcp.json como mcp.json, así que vuelve a añadir el punto inicial cuando muevas el archivo a su sitio.

Mantener las claves seguras

Los archivos de configuración guardan las claves de API en texto plano. No subas un archivo de proyecto con claves reales a un repositorio compartido. La mayoría de los clientes pueden leer una clave de tu entorno en lugar del archivo, cada uno con su propia sintaxis, que se describe en su documentación.

Todo se genera en tu navegador, así que los comandos, las URL y las claves que introduces no se envían a ningún sitio.