Conectar Cursor a tu estudio

Qué es

Cursor es un editor con IA integrada. Con el conector de IA, el chat de Cursor consulta los datos de tu estudio (ventas, clientes, agenda y finanzas) cuando haces una pregunta, con los permisos del usuario de la clave. Solo consulta: no modifica nada en el sistema.

Cuándo usarlo

Desarrollas una integración o un sitio web y quieres consultar los datos reales del estudio sin salir del editor.
Usas el chat de Cursor a diario y quieres preguntar sobre la actividad del estudio.

Antes de empezar

Ten a mano la dirección del conector y una clave de API con “Permitir uso como conector de IA”, creadas según las instrucciones del artículo Conector de IA.

Paso a paso

Paso 1 — Agregar el conector

Abre (o crea) el archivo ~/.cursor/mcp.json y agrega el fragmento de abajo. Reemplaza la dirección por la que copiaste en Copiar dirección y hk_... por tu clave:

{
  "mcpServers": {
    "heya": {
      "url": "https://seu-dominio/mcp",
      "headers": { "Authorization": "Bearer hk_..." }
    }
  }
}

Paso 2 — Verificar la conexión

En la configuración de Cursor, abre la sección MCP. El conector heya debe aparecer activo, con las herramientas listar_areas, buscar_ferramentas y executar_consulta.

Paso 3 — Hacer una pregunta

En el chat de Cursor, pregunta, por ejemplo: “¿qué clientes atendieron hoy en el estudio?”.

Qué pasa después

Cursor busca la consulta adecuada para la pregunta, la ejecuta y responde con los datos del sistema.
La clave aparece en la pestaña Clave de API con Último uso actualizado.
Para quitar el acceso, revoca la clave en la pestaña Clave de API: Cursor perderá el acceso en un máximo de 30 segundos.

Errores comunes y dudas

P: El conector aparece con un error en la configuración de Cursor. ¿Qué hago? R: Comprueba que la dirección termine en /mcp y que hayas pegado la clave completa, con Bearer y un espacio después. Después de editar mcp.json, desactiva y vuelve a activar el conector en la configuración de Cursor.

P: ¿Puedo usar una variable de entorno en lugar de la clave? R: Algunas versiones de Cursor no reemplazan la variable por su valor en el encabezado y envían el texto literal. Si el conector no se conecta con la variable, coloca la clave directamente en el archivo de tu usuario.

P: ¿Puedo poner la configuración en el archivo .cursor/mcp.json del proyecto? R: Evítalo: ese archivo suele incluirse en el control de versiones y la clave quedaría expuesta. Usa el archivo de tu usuario (~/.cursor/mcp.json).

P: Cursor dice que la clave debe tener activada la opción “Permitir uso como conector de IA”. ¿Por qué? R: La clave se creó sin esa opción. Edita la clave en la pestaña Clave de API y marca Permitir uso como conector de IA.

P: Cursor abrió una pantalla de inicio de sesión en lugar de usar la clave. ¿Qué hago? R: Comprueba que el bloque headers con la clave esté en mcp.json. Con la clave correcta, el sistema responde directamente y no hace falta iniciar sesión. Si Cursor insiste en el inicio de sesión y falla, usa la clave en Claude Code o Gemini CLI, o contacta con soporte.

P: ¿Cursor puede modificar datos del sistema a través del conector? R: No. El conector solo consulta. Las modificaciones se hacen en el sistema.