Outils de code
Cursor
Configurez TokenLab pour les modèles de chat Cursor pris en charge, vérifiez la connexion et ajoutez MCP ou des Skills séparément
Ce que fait cette connexion
Utilisez TokenLab pour les requêtes de chat prises en charge dans l'éditeur de bureau Cursor sur macOS, Windows ou Linux. Cursor documente la prise en charge du BYOK (Bring Your Own Key) OpenAI pour les modèles de chat standard sans raisonnement ; la complétion par tabulation continue d'utiliser les modèles de Cursor. Une substitution de l'URL de base (Base URL) OpenAI ne transforme pas Cursor en client pour chaque modèle ou protocole TokenLab. Consultez les limites de clé API de Cursor.
Si vous avez uniquement besoin des outils API de TokenLab pour les images, la vidéo ou autre, conservez votre fournisseur de chat actuel et ajoutez plutôt MCP. Un Skill apprend à l'agent comment utiliser les API ; il ne modifie pas le fournisseur de chat.
Confiez cette tâche à votre agent
Read https://tokenlab.sh/docs/fr/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.Ouvrez les paramètres appropriés
- Installez ou mettez à jour l'éditeur de bureau depuis Cursor Downloads. Ce guide ne configure pas l'interface en ligne de commande (CLI) de Cursor ni les agents Cloud.
- Ouvrez les Paramètres de Cursor (Cursor Settings) depuis la palette de commandes, ou appuyez sur
Cmd/Ctrl + Shift + J.Cmd/Ctrl + ,ouvre les paramètres généraux de l'éditeur. - Ouvrez Models et notez votre configuration existante de clé OpenAI et d'URL de base afin de pouvoir la restaurer. Laissez intacts les paramètres des autres fournisseurs.
- Dans OpenAI API Key, saisissez votre clé TokenLab localement et enregistrez-la. Ne collez pas la clé dans une conversation avec un agent et ne l'incluez pas dans un projet.
- Activez Override OpenAI Base URL et saisissez :
https://api.tokenlab.sh/v1Cursor envoie les requêtes BYOK via son backend pour l'assemblage des prompts ; il ne s'agit pas d'une connexion directe entre votre éditeur et TokenLab.
Sélectionnez un modèle pris en charge
Copiez l'ID exact du modèle depuis le catalogue TokenLab actuel et vérifiez que Cursor l'accepte via son chemin OpenAI BYOK. Le fait qu'un modèle soit listé comme modèle de chat sur TokenLab n'établit pas sa compatibilité avec Cursor.
Pour un test textuel initial, choisissez un modèle sans raisonnement : ses détails ne listent pas la capacité reasoning et il accepte openai_chat_completions. grok-4.20-non-reasoning en est un exemple ; confirmez qu'il est toujours listé avant de l'utiliser. Activez l'entrée existante dans Models, ou utilisez Add model si elle est absente, puis sélectionnez ce modèle exact dans le sélecteur de chat. Ne dupliquez pas un modèle intégré sous une orthographe différente et ne supposez pas que les entrées Claude ou Gemini utilisent la substitution OpenAI. Le guide sur les modèles personnalisés de Cursor explique ces limites de routage.
Vérifiez avec une petite requête
Démarrez un nouveau chat avec le modèle sélectionné et envoyez :
Reply only with TOKENLAB_CONNECTION_OK. Do not use tools or modify files.Il s'agit d'une requête de modèle facturable. Vérifiez à la fois la réponse et la correspondance du modèle, de l'heure et du statut dans TokenLab Requests. Une clé enregistrée, un modèle visible ou une réponse sans requête TokenLab correspondante ne confirment pas cette route.
En cas d'échec
- Le modèle est manquant ou rejeté : vérifiez l'ID exact et la prise en charge BYOK actuelle de Cursor. Utilisez une entrée intégrée existante si disponible ; un simple redémarrage ne peut pas rendre compatible un modèle non pris en charge.
- L'authentification échoue : saisissez à nouveau la clé TokenLab dans le champ OpenAI et vérifiez l'URL de base. Une erreur de solde ou de quota est différente d'une clé invalide ; suivez l'erreur renvoyée et la requête TokenLab correspondante.
- Aucune requête TokenLab n'apparaît : confirmez le modèle sélectionné et la substitution, puis inspectez l'erreur de Cursor. La complétion par tabulation et les autres fonctionnalités gérées par Cursor ne constituent pas un test de connexion.
- Un autre fournisseur cesse de fonctionner : restaurez les paramètres OpenAI précédents ou désactivez la substitution, puis démarrez un nouveau chat. Évitez de modifier les clés de fournisseurs non liés pour réparer cette route.
Générez des images et des vidéos dans le même agent
Cursor peut également créer des images et de courtes vidéos avec le serveur MCP TokenLab. Chaque génération est payée à partir du même solde TokenLab. MCP ne remplace pas le modèle de chat principal. Enregistrez ceci sous ~/.cursor/mcp.json, ou fusionnez l'entrée tokenlab dans votre fichier existant :
{
"mcpServers": {
"tokenlab": {
"command": "npx",
"args": ["-y", "@tokenlabai/mcp-server@0.6.48"],
"env": {
"TOKENLAB_MCP_TOOL_PROFILE": "core",
"TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>"
}
}
}
}Remplacez <TOKENLAB_API_KEY> par votre clé sur votre propre ordinateur et ne validez pas ce fichier. Vérifiez que tokenlab est activé dans les paramètres MCP de Cursor. Ensuite, essayez :
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 renvoie un ID de tâche. L'agent appelle get_task_status jusqu'à ce que la vidéo soit prête.
Ajoutez des instructions API séparément
Les TokenLab Skills fournissent des instructions API. Pour une installation locale au projet, conservez le répertoire complet du Skill dans .cursor/skills/tokenlab-api-integration/, y compris SKILL.md et les fichiers référencés. Consultez Customize → Skills pour la découverte. Les Skills ne fournissent pas de clé et n'installent pas de serveur MCP. Consultez les guides officiels MCP et Skills pour votre version de Cursor.