Herramientas de código
Cursor
Configura TokenLab para los modelos de chat compatibles con Cursor, verifica la conexión y añade MCP o Skills por separado
Qué hace esta conexión
Utiliza TokenLab para solicitudes de chat compatibles en el editor de escritorio Cursor en macOS, Windows o Linux. Cursor documenta el soporte de BYOK de OpenAI para modelos de chat estándar sin razonamiento; el autocompletado de pestañas (Tab completion) sigue utilizando los modelos de Cursor. Una anulación de la Base URL de OpenAI no convierte a Cursor en un cliente para todos los modelos o protocolos de TokenLab. Consulta los límites de API-key de Cursor.
Si solo necesitas las herramientas de API de imagen, video u otras de TokenLab, mantén tu proveedor de chat actual y añade MCP en su lugar. Una Skill enseña al agente cómo utilizar las APIs; no cambia el proveedor de chat.
Asigna esta tarea a tu agente
Read https://tokenlab.sh/docs/es/integrations/cursor and check my installed version and operating system.
Confirm whether I need TokenLab as the main model, MCP tools, or API Skills.
Preserve existing accounts, provider configuration, and permissions; explain how to restore changed settings.
Keep API keys local; do not ask me to paste them into chat. I will enter the key locally and perform required UI steps.
Explain the cost of a small verification request. Only after I explicitly choose that test, help run it and match the TokenLab request record.Abre la configuración correcta
- Instala o actualiza el editor de escritorio desde Cursor Downloads. Esta guía no configura la CLI de Cursor ni los Cloud Agents.
- Abre Cursor Settings desde la paleta de comandos, o presiona
Cmd/Ctrl + Shift + J.Cmd/Ctrl + ,abre la configuración general del editor. - Abre Models y anota tu configuración existente de clave de OpenAI y Base URL para que puedas restaurarla. Mantén intacta la configuración de otros proveedores.
- En OpenAI API Key, introduce tu clave de TokenLab localmente y guárdala. No pegues la clave en una conversación con el agente ni la subas a un proyecto.
- Habilita Override OpenAI Base URL e introduce:
https://api.tokenlab.sh/v1Cursor envía las solicitudes BYOK a través de su backend para el ensamblaje de prompts; esta no es una conexión directa desde tu editor a TokenLab.
Selecciona un modelo compatible
Copia el ID de modelo exacto del catálogo de TokenLab actual y verifica que Cursor lo acepte a través de su ruta OpenAI BYOK. Que un modelo aparezca como chat en TokenLab no garantiza la compatibilidad con Cursor.
Para una prueba de texto inicial, elige un modelo sin razonamiento: sus detalles no listan la capacidad reasoning y acepta openai_chat_completions. grok-4.20-non-reasoning es un ejemplo; confirma que todavía aparece listado antes de usarlo. Habilita la entrada existente en Models, o usa Add model si no está presente, luego selecciona ese modelo exacto en el selector de chat. No dupliques un modelo integrado con una ortografía diferente, y no asumas que las entradas de Claude o Gemini utilizan la anulación de OpenAI. La guía de modelos personalizados de Cursor explica estos límites de enrutamiento.
Verifica una solicitud pequeña
Inicia un nuevo chat con el modelo seleccionado y envía:
Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.Esta es una solicitud de modelo facturable. Verifica tanto la respuesta como el modelo, la hora y el estado correspondientes en TokenLab Requests. Una clave guardada, un modelo visible o una respuesta sin una solicitud de TokenLab coincidente no confirman esta ruta.
Si falla
- El modelo falta o es rechazado: verifica el ID exacto y el soporte BYOK actual de Cursor. Usa una entrada integrada existente cuando esté disponible; reiniciar por sí solo no puede hacer que un modelo no compatible funcione.
- La autenticación falla: vuelve a introducir la clave de TokenLab en el campo de OpenAI y verifica la Base URL. Un error de saldo o cuota es distinto a una clave no válida; sigue el error devuelto y la solicitud de TokenLab correspondiente.
- No aparece ninguna solicitud de TokenLab: confirma el modelo seleccionado y la anulación, luego inspecciona el error de Cursor. El autocompletado de pestañas y otras funciones gestionadas por Cursor no son una prueba de conexión.
- Otro proveedor deja de funcionar: restaura la configuración anterior de OpenAI o deshabilita la anulación, luego inicia un nuevo chat. Evita cambiar las claves de otros proveedores no relacionados para reparar esta ruta.
Genera imágenes y video en el mismo agente
Cursor también puede crear imágenes y videos cortos con el servidor MCP de TokenLab. Cada generación se paga con el mismo saldo de TokenLab. MCP no reemplaza al modelo de chat principal. Guarda esto como ~/.cursor/mcp.json, o fusiona la entrada tokenlab en tu archivo existente:
{
"mcpServers": {
"tokenlab": {
"command": "npx",
"args": ["-y", "@tokenlabai/mcp-server@0.6.48"],
"env": {
"TOKENLAB_MCP_TOOL_PROFILE": "core",
"TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>"
}
}
}
}Reemplaza <TOKENLAB_API_KEY> con tu clave en tu propia computadora y no subas este archivo. Verifica que tokenlab esté habilitado en la configuración de MCP de Cursor. Luego intenta:
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.create_video devuelve un ID de tarea. El agente llama a get_task_status hasta que el video esté listo.
Añade instrucciones de API por separado
Las TokenLab Skills proporcionan instrucciones de API. Para una instalación local en el proyecto, mantén el directorio completo de la skill en .cursor/skills/tokenlab-api-integration/, incluyendo SKILL.md y sus archivos referenciados. Revisa Customize → Skills para descubrirlas. Las Skills no proporcionan una clave ni instalan un servidor MCP. Consulta las guías oficiales de MCP y Skills para tu versión de Cursor.