MCP con Cursor: cómo conectar un MCP Server paso a paso

Cursor actualizado

Debes utilizar una versión de Cursor que incluya soporte MCP. El mecanismo de configuración puede cambiar con las versiones, por lo que conviene consultar la documentación actual cuando una opción no aparezca en la interfaz.

Un MCP Server

Puedes utilizar un servidor existente del Marketplace, un servidor local que se ejecute mediante un comando o un servicio remoto accesible mediante URL.

Dependencias

Los servidores locales pueden requerir Node.js, Python, Docker u otras dependencias según el proyecto.

Credenciales

Algunos servidores necesitan claves API, tokens, OAuth u otros mecanismos de autenticación.

Permisos

Debes conocer qué herramientas puede utilizar el servidor y qué recursos puede leer, modificar o consultar.

Configuración del proyecto

Para herramientas específicas de un proyecto puedes utilizar .cursor/mcp.json dentro de la carpeta del proyecto.

{
  "mcpServers": {
    "mi-servidor": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mi-mcp-server"
      ]
    }
  }
}

Configuración global

Para disponer de un servidor en todos tus proyectos puedes utilizar ~/.cursor/mcp.json.

{
  "mcpServers": {
    "mi-servidor-global": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mi-mcp-server"
      ]
    }
  }
}

Variables de entorno

Cursor permite utilizar interpolación de variables en campos como command, args y env.

{
  "mcpServers": {
    "mi-api": {
      "type": "stdio",
      "command": "python",
      "args": [
        "${workspaceFolder}/tools/server.py"
      ],
      "env": {
        "API_KEY": "${env:API_KEY}"
      }
    }
  }
}

También puedes utilizar variables como ${userHome}, ${workspaceFolder} y ${workspaceFolderBasename}.

Servidor Node.js

{
  "mcpServers": {
    "node-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ejemplo/mcp-server"
      ]
    }
  }
}

Servidor Python

{
  "mcpServers": {
    "python-server": {
      "type": "stdio",
      "command": "python",
      "args": [
        "${workspaceFolder}/server.py"
      ]
    }
  }
}

Servidor Docker

{
  "mcpServers": {
    "docker-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mi-mcp-server"
      ]
    }
  }
}

El comando y sus argumentos dependen del servidor real. Los ejemplos anteriores muestran la estructura de configuración y deben adaptarse al proyecto que estés utilizando.

Probar el comando antes

Una buena práctica consiste en ejecutar manualmente el mismo comando en la terminal antes de registrarlo en Cursor. Esto permite detectar rápidamente dependencias, rutas o permisos incorrectos.

Streamable HTTP

{
  "mcpServers": {
    "servidor-remoto": {
      "url": "https://mcp.ejemplo.cl/mcp"
    }
  }
}

URL con encabezado

{
  "mcpServers": {
    "servidor-remoto": {
      "url": "https://mcp.ejemplo.cl/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MCP_TOKEN}"
      }
    }
  }
}

OAuth

Cursor admite OAuth para servidores MCP remotos. Algunas implementaciones utilizan registro dinámico, mientras que otras pueden proporcionar credenciales OAuth estáticas.

Cuando el proveedor entrega un Client ID y, si corresponde, un Client Secret, Cursor permite configurarlos mediante el objeto auth del servidor remoto.

{
  "mcpServers": {
    "oauth-server": {
      "url": "https://api.ejemplo.cl/mcp",
      "auth": {
        "CLIENT_ID": "${env:MCP_CLIENT_ID}",
        "CLIENT_SECRET": "${env:MCP_CLIENT_SECRET}",
        "scopes": [
          "read"
        ]
      }
    }
  }
}

Listar servidores

agent mcp list

Este comando permite revisar los servidores configurados y consultar su estado, origen de configuración y transporte.

Añadir un servidor

Puedes registrar un servidor desde la terminal utilizando agent mcp add.

agent mcp add mi-servidor -- npx -y mi-mcp-server

Servidor remoto

agent mcp add mi-servidor --url https://mcp.ejemplo.cl/mcp

Listar herramientas

agent mcp list-tools mi-servidor

La CLI utiliza la misma configuración MCP que el editor, por lo que los servidores configurados pueden estar disponibles en ambos entornos.

Aprobación de herramientas

Cursor solicita aprobación antes de utilizar herramientas MCP por defecto. El comportamiento también puede verse afectado por los modos de ejecución y las reglas de allowlist.

Tool allowlist

Cursor permite definir qué herramientas de un servidor aprobado pueden ejecutarse automáticamente. Una configuración demasiado amplia aumenta las capacidades disponibles para el agente.

Instalación desde Marketplace

Los servidores disponibles en Marketplace pueden mostrar un botón Add to Cursor para iniciar la instalación y autenticación.

Instalación mediante enlace

Cursor también admite enlaces especiales de instalación MCP. Estos enlaces contienen la configuración del servidor codificada y permiten iniciar el proceso directamente desde Cursor.

cursor://anysphere.cursor-deeplink/mcp/install?name=SERVIDOR&config=CONFIGURACION

Los enlaces de instalación son especialmente útiles para documentación, repositorios y equipos que quieren simplificar la incorporación de servidores MCP.

Comprueba el servidor fuera de Cursor

Ejecuta directamente el comando del servidor desde la terminal. Si no funciona ahí, el problema probablemente está en el servidor o sus dependencias.

Comprueba la configuración

Si el servidor funciona en la terminal pero no en Cursor, revisa el archivo mcp.json, la ruta, las variables de entorno y el transporte seleccionado.

Configuración de proyecto

El archivo .cursor/mcp.json permite definir servidores específicos para un proyecto. Este archivo puede compartirse mediante control de versiones cuando la configuración no contiene secretos.

Configuración global

~/.cursor/mcp.json permite mantener servidores personales disponibles en diferentes proyectos.

Allowlist administrativa

Los equipos pueden utilizar listas permitidas para controlar qué servidores pueden registrarse y qué herramientas pueden ejecutarse automáticamente.

Red

Cursor documenta modos de red para servidores locales que permiten autorizar todas las conexiones, aplicar una allowlist o bloquear el tráfico saliente.

Auditoría

En entornos compartidos conviene registrar qué servidores están habilitados, qué permisos necesitan y quién administra las configuraciones.

Cursor permite conectar MCP Servers para ampliar las herramientas y fuentes de información disponibles para su agente.

Puedes instalar servidores desde Marketplace o configurarlos manualmente mediante mcp.json.

Para proyectos puedes utilizar .cursor/mcp.json y para configuraciones globales ~/.cursor/mcp.json.

Cursor admite servidores locales con stdio y servidores remotos mediante SSE o Streamable HTTP.

Desde la CLI puedes utilizar comandos como agent mcp list y agent mcp list-tools para revisar la configuración.

Cursor Docs · Model Context Protocol

Cursor Help · MCP integrations

Cursor CLI · MCP

Cursor Docs · MCP Install Links

Cursor CLI · Permissions