Hola, Lena está llegando. No estaba tratando de configurar nada complicado esa tarde.

Solo quería que Cursor accediera a una base de datos y obtuviera contexto sin que yo copiara cosas manualmente. Suficientemente simple, en teoría. Pero la primera vez que miré los servidores MCP en Cursor, me detuve más tiempo de lo esperado. El panel de configuración se sentía ligeramente diferente de lo que había visto documentado dos versiones antes. La ruta de configuración había cambiado. La interfaz tenía una nueva etiqueta. No estaba roto, solo… igual a como lo recordaba.

De hecho, de eso se trata este artículo. No solo "aquí está el JSON". Más bien, —aquí está lo que noté cuando hice el proceso con cuidado, incluyendo las partes que me confundieron al principio.

Qué Hacen los Servidores MCP en Cursor

Cómo funciona la llamada a herramientas dentro del IDE de Cursor

MCP — Model Context Protocol — es un protocolo abierto que estandariza cómo las aplicaciones proporcionan herramientas y contexto a los LLMs. Anthropic lo liberó como código abierto en noviembre de 2024. Para mediados de 2025, OpenAI y Google DeepMind también lo habían adoptado. En diciembre de 2025, pasó a la Agentic AI Foundation — un proyecto de la Linux Foundation. Ese cambio tiene cierta importancia. Pasó de ser algo de Anthropic a algo genuinamente compartido.

Dentro de Cursor, MCP funciona como una capa de complementos para el Agente. Cuando abres una sesión de agente, Cursor escanea tus servidores MCP habilitados, carga las herramientas que exponen y determina cuáles llamar como parte de cualquier tarea que esté ejecutando.

El protocolo define tres elementos: hosts (el propio Cursor), clientes (los conectores dentro de Cursor) y servidores (programas ligeros en el otro extremo, que exponen herramientas vía JSON-RPC 2.0).

Las herramientas son lo principal — funciones ejecutables como create_issue o run_query. Cursor ha soportado herramientas desde sus inicios. Recursos — datos contextuales como contenidos de archivos y esquemas de bases de datos — llegaron en Cursor v1.6 (septiembre de 2025). Los prompts, que permiten a los servidores ofrecer plantillas reutilizables, llegaron un poco después.

Hmm… No me di cuenta de que los recursos fueran tan recientes. Eso podría explicar por qué algunos tutoriales más antiguos se sienten incompletos.

Antes de Empezar: Prerrequisitos

Versión de Cursor que soporta MCP

El soporte MCP ha sido parte de Cursor desde hace un tiempo, pero el formato de configuración ha cambiado entre versiones. Antes de hacer cualquier otra cosa, verifica tu versión. Abre Cursor → Ayuda → Acerca de. La versión estable actual a principios de 2026 soporta los tres tipos de transporte: stdio, SSE y Streamable HTTP.

Una cosa que vale la pena confirmar: el panel de Configuración ahora etiqueta esta sección como Herramientas y MCP, no solo "Extensiones" o algo más genérico. Si la estás buscando y no la encuentras, probablemente sea por eso.

Requisitos de Node.js o Python según el servidor

La mayoría de los servidores MCP que encontrarás funcionan en uno de estos dos entornos:

Servidores basados en Node.js — lanzados mediante npx o node. Requieren Node.js 18+ en tu PATH.
Servidores basados en Python — lanzados mediante uv run o python. Requieren Python 3.10+ y a menudo uv como gestor de paquetes.

Sugeriría ejecutar node --version y python --version en tu terminal antes de cualquier otra cosa. Puede parecer obvio, pero saltarse este paso es la causa silenciosa de un número sorprendente de instalaciones fallidas. El proceso del servidor simplemente… nunca se inicia, y Cursor no te da nada útil en el panel.

Cómo agregar un servidor MCP a Cursor

Paso 1: Encontrar o crear tu servidor MCP

Ya hay una buena cantidad de servidores disponibles —para GitHub, Postgres, Slack, automatización de navegadores y más. El registro oficial de servidores MCP en GitHub es un punto de partida razonable. Algunos tienen botones de "Agregar a Cursor" con un solo clic en su documentación, lo cual maneja la configuración automáticamente.

Si estás creando el tuyo propio: los servidores solo necesitan imprimir en stdout (transporte stdio) o servir un endpoint HTTP. Cualquier lenguaje funciona, lo cual es una de las cosas que hace que esto se sienta ligeramente diferente a otros sistemas de plugins que he usado.

Paso 2: Configurar en los ajustes de Cursor

Aquí es donde quiero ser preciso, porque el formato importa y la documentación no siempre advierte cuando está mal.

Hay dos ubicaciones de configuración:

Scope del proyecto: .cursor/mcp.json en la raíz de tu proyecto
Global: ~/.cursor/mcp.json en tu directorio personal

La estructura se ve así:

JSON

{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "your-mcp-server-package"],
      "env": {
        "API_KEY": "your-value-here"
      }
    }
  }
}

El campo env es donde pasas las claves API y configuración sensible —no van en args. Me tomó un momento entender esto de manera intuitiva.

Una cosa que llama la atención de la gente: si te falta la clave raíz "mcpServers", Cursor ignora silenciosamente todo el archivo. No hay error, ni advertencia. El servidor simplemente no aparece. No estoy seguro de por qué funciona de esa manera, pero así es.

Para servidores Python que usan uv:

JSON

{
  "mcpServers": {
    "my-python-server": {
      "command": "uv",
      "args": ["run", "--with", "my-server-package", "my-server-package", "run"]
    }
  }
}

Alternativamente, puedes agregar servidores a través de la interfaz: Configuración → Herramientas & MCP → Nuevo Servidor MCP. Esa ruta es un poco más flexible si no te sientes cómodo editando JSON directamente.

Paso 3: Verificar la conexión

Después de guardar la configuración, abre Configuración → Herramientas & MCP. Cada servidor debería aparecer con un indicador de estado: verde significa conectado, otro color significa que no lo está.

Si un servidor no aparece: primero revisa la clave raíz ("mcpServers", no "servers" ni ninguna otra). Luego verifica que el comando realmente esté disponible en tu PATH. Cursor no siempre muestra errores útiles en este punto; esa es una de las partes que todavía me resulta un tanto incierta.

Paso 4: Probar llamadas a herramientas en una sesión de agente

Abre una nueva sesión de Agente en Cursor (no un chat normal). Escribe algo que normalmente invocaría una de las herramientas del servidor. Cursor debería pedir tu confirmación antes de ejecutar: eso es comportamiento esperado, no un problema.

Si la llamada a la herramienta se ejecuta pero no devuelve nada útil, verifica que el servidor realmente esté exportando la herramienta que crees. El panel de Herramientas & MCP muestra qué herramientas expone cada servidor. Vale la pena revisar esa lista antes de asumir que algo está roto.

Solución de problemas comunes de configuración MCP

El servidor no aparece

Normalmente se debe a tres cosas: falta de la clave raíz "mcpServers", un comando que no se encuentra en PATH, o un error de sintaxis en JSON. Cursor no muestra nada al respecto. Validar tu JSON manualmente, incluso pegándolo en un verificador, ahorra tiempo.

Llamadas a herramientas que fallan silenciosamente

Cursor tiene un límite de alrededor de 40 herramientas activas entre todos los servidores. Más allá de ese límite, el agente empieza a tener dificultades para elegir la herramienta correcta porque se llena el contexto. Si tienes muchos servidores habilitados, intenta desactivar los que no estés usando y presionar el botón de actualizar en el panel de Herramientas & MCP. Eso me ayudó más de una vez.

Errores de autenticación

Si tu servidor requiere una clave API y la llamada a la herramienta falla con un error de permisos, revisa que la clave esté en el campo env de tu configuración, no codificada directamente en args. Algunos paquetes de servidor también esperan nombres específicos de variables de entorno: vale la pena revisar la documentación del servidor para conocer el nombre exacto de la variable esperada.

Haciendo que tu Configuración de Cursor MCP sea Reutilizable

Por qué se reinicia tu configuración y cómo hacer que se mantenga

Si solo estás usando .cursor/mcp.json dentro de un solo proyecto, la configuración desaparece cuando trabajas en una carpeta diferente. Eso me sorprendió la primera vez. La solución es también mantener un ~/.cursor/mcp.json a nivel global para los servidores que quieras en todas partes, como un servidor de sistema de archivos o una herramienta de búsqueda de documentación.

Para configuraciones de equipo, comprometer .cursor/mcp.json en el control de versiones significa que todos en el proyecto obtienen la misma configuración de servidor. Los valores env obviamente no deberían ser comprometidos; esos pertenecen a la configuración del entorno local o a un gestor de secretos.

Una cosa más que vale la pena tener en cuenta: los servidores MCP ejecutan código con tus credenciales. Cualquier permiso que le des a un servidor —acceso a bases de datos, tokens de GitHub, claves API— será utilizado por el servidor. Antes de agregar cualquier servidor de terceros, vale la pena revisar la guía de seguridad MCP de la documentación oficial. Las divulgaciones CVE de 2025 relacionadas con Cursor MCP fueron parcheadas, pero el principio subyacente sigue siendo: trata cada servidor como una integración totalmente confiable.

Preguntas Frecuentes

¿Cómo agrego un servidor MCP a Cursor?

Crea o edita .cursor/mcp.json en tu directorio de proyecto (o ~/.cursor/mcp.json para acceso global), usando la clave raíz "mcpServers". Añade el comando de tu servidor, argumentos y cualquier variable de entorno. Luego verifica en Configuración → Herramientas & MCP para confirmar que se conectó.

¿Qué versión de Cursor soporta MCP?

El soporte para la herramienta MCP ha estado disponible en Cursor desde hace algún tiempo. El soporte de recursos (datos contextuales como esquemas y contenidos de archivos) llegó en la v1.6 (septiembre de 2025). Revisa Ayuda → Acerca de para confirmar tu versión, y mantén Cursor actualizado; la integración MCP ha cambiado de manera significativa a través de las versiones.

¿Por qué no aparece mi servidor MCP en Cursor?

La causa más común es una clave raíz "mcpServers" faltante o mal escrita en tu archivo de configuración. Cursor ignora silenciosamente el archivo si esta clave está ausente. Otras causas incluyen que el comando no se encuentre en PATH, o un error de sintaxis JSON. Valida tu archivo de configuración y verifica que tu entorno de ejecución (Node.js o Python) sea accesible desde tu terminal.

Probablemente seguiré observando cómo evoluciona esto. El ecosistema MCP aún se está formando —se están agregando servidores, el protocolo está ganando adopción entre más herramientas— y cómo se verá la configuración en una o dos versiones más, la verdad aún no lo sé.

…pero no parece aleatorio.

Lectura relacionada: Documentación oficial de MCP · Documentos de Cursor MCP · Registro del servidor MCP en GitHub