Cómo conectar Neon a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Neon, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Neon + Cursor

Deja que tu IA gestione Neon, el Postgres serverless: proyectos, branches, compute endpoints, bases de datos, roles, esquemas, operaciones y consumo. Tras tu confirmación crea branches y arranca o suspende computes. Nunca devuelve contraseñas. Con una API key de Neon.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

NEON_API_KEY

Paso 1 — Obtener credenciales

1. En la Neon Console abre Account settings → API keys para una clave personal (actúa como tú, en todas las organizaciones a las que perteneces), o Organization settings → API keys para una clave que solo llega a los proyectos de esa organización. Una clave limitada a un proyecto solo llega a ese proyecto.
2. Crea la clave y cópiala enseguida: Neon solo la muestra una vez. Pégala en NEON_API_KEY e instala el conector. La clave solo se envía a console.neon.tech.
3. Comprueba la configuración con neon_list_organizations: lista las organizaciones a las que pertenece la clave, con su org_id.

Qué cubre: organizaciones, proyectos, branches, compute endpoints, bases de datos, roles, esquemas de base de datos, operaciones y consumo, a través de la Neon API v2. La IA baja desde neon_list_projects a neon_get_project, neon_list_branches, neon_list_endpoints, neon_list_databases, neon_list_roles y neon_get_database_schema, que muestra las tablas, columnas, índices y restricciones de una base de datos, también tal como estaban en un momento pasado. Con una clave personal, los proyectos de una organización necesitan el org_id.

Pregunta antes de cada cambio: neon_create_branch, neon_start_endpoint y neon_suspend_endpoint modifican tu proyecto, así que la IA te dice qué va a pasar y espera tu sí.

• Un compute en marcha consume horas de cómputo, que se descuentan de la cuota de tu plan o se cobran en los planes de pago. neon_start_endpoint pone en marcha ese contador; los computes bajan a cero solos tras el tiempo de suspensión.
• neon_suspend_endpoint cierra al instante todas las conexiones abiertas a ese compute.
• neon_create_branch crea al momento un branch copy-on-write, si quieres desde un punto en el tiempo. Los branches que superan la cuota del plan pueden cobrarse, y un compute añadido al branch arranca enseguida. Pon fecha de caducidad a los branches temporales.
• Cada cambio se ejecuta como una operación en segundo plano; neon_list_operations y neon_get_operation muestran cuándo ha terminado.

Desactivada al instalar: neon_delete_branch, que borra un branch junto con sus computes. Un administrador la activa de forma deliberada. El branch raíz y el predeterminado no se pueden borrar nunca.

Consumo y costes: neon_get_consumption devuelve tiempo de cómputo, almacenamiento, número de branches y transferencia de red por proyecto, por hora, día o mes. Necesita el org_id, solo funciona en planes de pago (Launch, Scale, Business, Enterprise) y no despierta ningún compute. Los detalles de proyecto y branch también muestran el tiempo de cómputo, el tiempo activo, los datos escritos y la transferencia del periodo actual.

Sin contraseñas, sin SQL: las contraseñas de los roles y las cadenas de conexión nunca se devuelven, así que ninguna contraseña de base de datos llega a la IA. Este conector tampoco ejecuta SQL: el SQL por HTTP de Neon necesita una cadena de conexión con la contraseña del rol, no la API key. Para consultar tus datos, añade el conector PostgreSQL con un rol de Postgres propio de solo lectura en tu host de Neon (puerto 5432, SSL obligatorio). neon_get_database_schema sigue mostrando la estructura sin ninguna contraseña.

Errores comunes: 401: la API key es incorrecta o se revocó; crea una nueva. 403: la clave no puede llegar a ese proyecto u organización (una clave de proyecto o de organización usada en otro sitio), o tu plan no incluye la función, por ejemplo el historial de consumo. 404: ID de proyecto, branch o endpoint incorrecto. 423 Locked: hay otra operación en curso en el proyecto; espera a que termine y vuelve a intentarlo. 429: demasiadas solicitudes; espera un momento y vuelve a intentarlo.

El conector no crea ni borra proyectos, bases de datos o roles, no restablece contraseñas y no cubre Neon Auth, la Data API, los snapshots ni la administración de organizaciones.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Neon.

Herramientas disponibles

Ejemplos de prompts

• "Lista todos nuestros proyectos de Neon con región, versión de Postgres y tamaño de almacenamiento, y dime cuáles no tuvieron actividad de cómputo este mes."
• "Muéstrame el esquema de la base de datos app en nuestro branch de producción: tablas, columnas e índices."
• "Crea un branch feature-billing a partir de main que caduque en 7 días. Antes dime cuánto puede costar."
• "¿Qué computes están activos ahora mismo? Suspende el del branch de preview, pero pregúntame antes."
• "¿Cuánto tiempo de cómputo y cuánto almacenamiento usó cada proyecto el mes pasado?"

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT