Añade un servidor MCP a Cursor: dónde vive mcp.json (global o de proyecto), las formas url remota y command local, OAuth y el enlace de instalación con un clic.

En resumen: Cursor lee los servidores MCP de mcp.json, ya sea de forma global en ~/.cursor/mcp.json o por proyecto en .cursor/mcp.json. Un servidor remoto es una entrada url; uno local es un command con args. Guarda el archivo, abre Cursor Settings → Tools & MCP, inicia sesión cuando el servidor muestre Needs login y las herramientas quedan disponibles para el Agent. Los servidores también se pueden compartir como un enlace de instalación con un clic; el de UnifAPI está más abajo.

El soporte de MCP en Cursor se basa en archivos, y eso es una buena noticia: no hay nada por lo que hacer clic salvo el inicio de sesión OAuth, la configuración se puede versionar en el repositorio y la misma forma de JSON sirve para todos los servidores. Esta guía usa el servidor MCP de UnifAPI (https://mcp.unifapi.com, datos públicos en vivo de X, Instagram, TikTok, YouTube, Reddit, LinkedIn, Threads y el stack de SEO) como ejemplo práctico.

Dónde vive mcp.json

Archivo	Ámbito	Úsalo para
`~/.cursor/mcp.json`	Todos los proyectos de esta máquina, este usuario	Servidores que quieres en todas partes (un servidor de datos, un navegador, un servidor de documentación)
`.cursor/mcp.json`	Un proyecto, versionado con el repositorio	Servidores que pertenecen al código; tus compañeros los reciben al clonar

Los dos archivos comparten la misma forma, y Cursor los fusiona. Si un nombre aparece en ambos, gana la entrada del proyecto.

Un servidor remoto: la forma url

Crea o edita el archivo y añade el servidor bajo mcpServers:

{
  "mcpServers": {
    "unifapi": {
      "url": "https://mcp.unifapi.com"
    }
  }
}

Guarda. Abre Cursor Settings → Tools & MCP (en versiones anteriores: MCP & Integrations). El servidor aparece con un punto de estado. Para un servidor protegido por OAuth como UnifAPI indica Needs login: haz clic, inicia sesión o crea una cuenta de UnifAPI en la ventana del navegador y aprueba el permiso de solo lectura. El punto se pone verde y la lista de herramientas se despliega bajo el servidor: list_operations, get_operation y call_api.

Cursor admite el registro dinámico de clientes de OAuth 2.0, que es lo que usa UnifAPI, así que no hace falta ningún client ID. Para proveedores que entregan un client ID fijo o exigen una URL de redirección en lista blanca, Cursor acepta un bloque auth junto a url con CLIENT_ID, un CLIENT_SECRET opcional y scopes. UnifAPI no lo necesita.

Un servidor remoto que usa un token estático en lugar de OAuth toma headers, y el valor puede venir de tu entorno:

{
  "mcpServers": {
    "example": {
      "url": "https://mcp.example.com",
      "headers": {
        "Authorization": "Bearer ${env:EXAMPLE_TOKEN}"
      }
    }
  }
}

UnifAPI acepta una clave de API del espacio de trabajo por esta vía, pero OAuth es el camino recomendado: ningún secreto en un archivo, y el token es de solo lectura.

Un servidor local: la forma command

Un servidor que se ejecuta en tu máquina es un comando que Cursor arranca:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "${workspaceFolder}"],
      "env": {
        "NODE_OPTIONS": "--max-old-space-size=512"
      }
    }
  }
}

${workspaceFolder}, ${userHome} y ${env:NAME} se interpolan, así que un .cursor/mcp.json versionado puede seguir siendo independiente de la máquina. command y url son excluyentes; una entrada con ambos se ignora.

Enlaces de instalación con un clic

Cursor puede instalar un servidor desde un deeplink, que es como los proveedores ponen un botón "Add to Cursor" en su documentación. El enlace lleva el nombre del servidor y el mismo JSON que escribirías a mano, codificado en base64:

cursor://anysphere.cursor-deeplink/mcp/install?name=$NAME&config=$BASE64_CONFIG

Para UnifAPI, config es el base64 de {"url":"https://mcp.unifapi.com"}:

cursor://anysphere.cursor-deeplink/mcp/install?name=unifapi&config=eyJ1cmwiOiJodHRwczovL21jcC51bmlmYXBpLmNvbSJ9

Al abrirlo en un navegador, el servidor se le entrega a Cursor, que te pide confirmación antes de escribirlo en tu mcp.json global. Genera el tuyo con echo -n '{"url":"https://…"}' | base64 y sustituye los dos parámetros. Los enlaces son cómodos para la incorporación; para un equipo, un .cursor/mcp.json versionado sigue siendo la opción correcta.

Usar las herramientas

Las herramientas MCP las usa el Agent (el modo de chat por defecto), no las ediciones en línea ni Tab. Pide algo que el servidor pueda responder y fíjate en la llamada a la herramienta:

Con el servidor MCP unifapi, lista las operaciones disponibles para TikTok y dime cuál devuelve los videos recientes de un creador.

Cursor pregunta antes de ejecutar una herramienta salvo que actives la ejecución automática para ese servidor en los ajustes de MCP. Para un servidor de solo lectura como UnifAPI, la ejecución automática es razonable: lo único que una llamada puede gastar son créditos del espacio de trabajo, y get_operation muestra el precio por registro antes de que call_api se ejecute.

Cursor envía al modelo un número limitado de herramientas a la vez (unas cuarenta entre todos los servidores activados) y desactiva el resto, así que conviene preferir servidores con pocas herramientas. El catálogo de UnifAPI está detrás de tres herramientas a propósito; un catálogo grande expuesto como una herramienta por endpoint quedaría casi todo desactivado.

Una primera tarea en UnifAPI

Un prompt acotado que ejercita todo el bucle:

Con las herramientas MCP de unifapi: busca los hilos de Reddit de los últimos 7 días que mencionen "Cursor MCP", extrae los 20 con mayor puntuación y resume los problemas de configuración recurrentes con un hilo de ejemplo para cada uno. Llama a list_operations y get_operation antes de call_api.

La facturación es por registro de datos públicos en créditos del espacio de trabajo ($0,001 cada uno; un crédito para la mayoría de los registros, mínimos mayores publicados en el catálogo). Los tokens del modelo se quedan en tu plan de Cursor. Un espacio de trabajo nuevo de UnifAPI no tiene créditos hasta su primera recarga, que incluye un bono único, así que recarga una vez antes del primer call_api.

Si quieres partir de una tarea en lugar de un endpoint, los agentes por plataforma (Reddit, X, LinkedIn, TikTok, YouTube, Instagram, Threads) y el agente de SEO traen cada uno un prompt listo y las operaciones que necesita.

Solución de problemas

Síntoma	Qué hacer
El servidor no aparece tras guardar `mcp.json`	Valida el JSON (sin comas finales); desactiva y vuelve a activar el servidor en Tools & MCP, o recarga la ventana
Needs login no desaparece	Ventanas emergentes bloqueadas, o la ventana de OAuth inició sesión con otra cuenta; haz clic de nuevo en el estado, o elimina el servidor y vuelve a añadirlo
Herramientas listadas pero en gris	Has superado el límite de herramientas activas de Cursor; desactiva un servidor que no estés usando
El Agent responde sin llamar a la herramienta	Nombra el servidor en el prompt una vez ("con el servidor MCP unifapi"); tras una llamada con éxito recurre a él por su cuenta
`call_api` devuelve `insufficient_credits`	El espacio de trabajo aún no tiene créditos; recarga una vez en la consola de UnifAPI y vuelve a ejecutar
Un compañero no ve el servidor del proyecto	`.cursor/mcp.json` no está en el repositorio, o su Cursor todavía no ha marcado la carpeta del proyecto como de confianza

Fuentes consultadas

Escrito el 14 de octubre de 2026 frente a la documentación de MCP de Cursor (formas de configuración, OAuth, interpolación) y la referencia de enlaces de instalación. Las etiquetas de los ajustes cambian entre versiones de Cursor; el formato del archivo se ha mantenido estable.

Qué leer a continuación

Configuración de MCP - las instrucciones del conector alojado para todos los clientes.

Cómo añadir un servidor MCP a Claude - conectores, claude_desktop_config.json y claude mcp add.

Configuración de MCP en Codex - codex mcp add y config.toml.

Contexto para agentes: rules, Skills y MCP - dónde encaja MCP junto a los archivos de reglas y las Skills.