Outils de code
Serveur MCP TokenLab
Donnez à Claude Code, Cursor, VS Code, Codex et aux autres clients MCP l'accès aux modèles et API TokenLab
Choisissez ce dont votre agent a besoin
- MCP ajoute les outils de l'API TokenLab à un client compatible. Commencez avec la configuration
catalogsans clé ci-dessous. - Les Agent Skills TokenLab enseignent à l'agent la méthode pour obtenir un résultat, comme le choix du modèle et la vérification de la sortie. Ils ne lancent pas de serveur MCP, mais peuvent utiliser ces outils MCP lorsque les deux sont installés.
Installez le skill de sélection de modèle : npx skills add hedging8563/tokenlab-skills --skill tokenlab-model-picker
Les deux étendent un agent existant. Modifier son fournisseur de modèle principal utilise le guide de configuration propre à ce client.
Laissez mon agent configurer cela
Copiez cette tâche vers un agent déjà en cours d'exécution sur votre ordinateur :
Read this guide and choose MCP catalog tools or a Skill for my task:
https://tokenlab.sh/docs/fr/integrations/tokenlab-mcp-server
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.Le TokenLab MCP Server permet à un client MCP de parcourir les modèles et prix actuels, d'envoyer des requêtes de modèle, de créer des médias, de travailler avec des fichiers et de vérifier des tâches asynchrones.
Utilisez le profil catalog pour parcourir les modèles et les prix sans clé API. Ajoutez TOKENLAB_API_KEY lorsque le client doit effectuer des requêtes de modèle payantes ou des requêtes média.
Gardez votre clé API TokenLab dans l'environnement du serveur MCP. Ne la collez jamais dans un prompt ou un argument d'outil.
Prérequis
Installez Node.js 18.17 ou une version ultérieure et assurez-vous que npx est disponible :
node --version
npx --versionLe package npm s'exécute localement via stdio. Vous n'avez pas besoin d'une installation globale ou d'un checkout des sources.
Choisissez ce que le client peut utiliser
| Profil | Clé API | Inclus |
|---|---|---|
catalog | Non requise | Liste des modèles, détails des modèles, prix, comparaisons et aperçu de l'API |
core | Requise pour les appels payants | Outils courants de chat, décision, média, audio, fichier, tâche, embedding, rerank et traduction |
full | Requise pour les appels payants | core plus des API développeur supplémentaires |
Commencez avec catalog si vous souhaitez uniquement une meilleure sélection de modèles. Utilisez core lorsque le client doit créer du contenu ou appeler un modèle. full est destiné aux clients qui ont réellement besoin de l'ensemble d'outils plus large.
Ajouter le serveur
Sauvegardez la configuration active. Ajoutez uniquement l'entrée TokenLab et préservez les fournisseurs, comptes, sélection de modèle par défaut et permissions existants. Si le nom est déjà utilisé, choisissez un autre nom et mettez à jour les commandes. Pour annuler la configuration, supprimez uniquement l'entrée ajoutée ou restaurez sa sauvegarde précédente.
Ajoutez le catalogue public pour votre compte utilisateur :
claude mcp add \
--env TOKENLAB_MCP_TOOL_PROFILE=catalog \
--scope user \
tokenlab -- \
npx -y @tokenlabai/mcp-server@0.6.48Pour utiliser les outils payants, remplacez la variable d'environnement du profil par TOKENLAB_API_KEY et stockez la clé via votre méthode habituelle de gestion des secrets. Utilisez --scope local pour un projet. Ne committez jamais une vraie clé dans un fichier .mcp.json partagé.
Activer les outils payants
Créez une clé API dans Console → API keys, puis définissez les deux variables dans l'environnement du serveur MCP :
{
"env": {
"TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>",
"TOKENLAB_MCP_TOOL_PROFILE": "core"
}
}Utilisez l'entrée de secret de votre client lorsqu'il en possède une. Si une vraie clé apparaît dans un fichier partagé, une capture d'écran, un journal ou l'historique du shell, révoquez-la et créez une nouvelle clé.
Vérifier la connexion
Redémarrez ou rechargez le client MCP, approuvez le serveur local si vous y êtes invité, et confirmez que tokenlab est connecté.
# Claude Code
claude mcp list
# Codex
codex mcp listDemandez au client d'appeler list_models. Une liste non vide confirme que le package a démarré et a atteint TokenLab. Le profil catalog ne nécessite pas de clé API.
Outils utiles
La disponibilité des outils dépend du profil sélectionné. Les tâches courantes incluent :
- lister les modèles et lire les capacités d'un modèle
- lire les prix actuels de TokenLab ou comparer plusieurs modèles
- envoyer des Chat Completions, Responses, Anthropic Messages ou des requêtes Gemini
- évaluer des décisions typées avec
evaluate_decisions - créer ou modifier des images
- créer de la vidéo, de la musique, de la 3D, de la parole, de la transcription ou de la traduction
- télécharger et récupérer des fichiers
- créer des embeddings ou réordonner (rerank) des documents
- vérifier et annuler des tâches asynchrones prises en charge
Le client doit demander une approbation avant un appel payant lorsque le prix ou le choix du modèle n'a pas déjà été confirmé.
Les outils de fichiers MCP utilisent l'API /v1/files compatible OpenAI. Les fichiers Gemini, les téléchargements reprenables et cachedContents nécessitent actuellement des appels HTTP et ne sont pas inclus dans les profils MCP. Voir Gemini Files and cache.
Modèles de décision
Utilisez core ou full pour appeler un modèle de décision System One. Appelez d'abord list_models avec {"category":"decision"} et get_model avec l'ID du modèle sélectionné. Gardez le modèle de chat principal de l'agent configuré séparément.
Pour Jev 1.13, appelez l'outil avec state et questions natifs :
{
"name": "evaluate_decisions",
"arguments": {
"model": "jev-1.13",
"state": { "ticket": "Please refund the duplicate payment." },
"questions": {
"refund_requested": {
"type": "noul",
"instructions": "Does the customer explicitly request a refund?"
}
}
}
}Vérifiez isError, puis lisez structuredContent.answers et structuredContent.usage. Une réponse Noul est un nombre de probabilité, pas un booléen. Préservez l'ID de requête de _meta lorsqu'il est disponible. L'outil renvoie un résultat synchrone ; il n'utilise pas le flux de polling de tâches asynchrones.
Avec le délai d'expiration par défaut de 120 000 ms pour les requêtes serveur, prévoyez au moins 150 000 ms pour l'appel d'outil client. Si vous modifiez TOKENLAB_REQUEST_TIMEOUT_MS, gardez le délai d'expiration du client plus long. Un délai d'expiration laisse le résultat incertain ; inspectez la requête avant de soumettre à nouveau un appel payant. Validez les décisions par rapport à vos propres cas étiquetés avant de les utiliser pour piloter des actions.
Médias asynchrones
Les outils vidéo, musique et 3D renvoient une tâche au lieu d'un fichier terminé. Les outils d'image peuvent renvoyer soit un résultat terminé, soit une tâche, selon le modèle.
Lorsqu'un résultat inclut une delivery asynchrone, appelez get_task_status avec son ID de tâche jusqu'à ce que le statut soit terminé ou en échec. Ne créez pas une seconde tâche parce qu'une vérification de statut a expiré.
Paramètres optionnels
| Variable | Défaut | Utilisation |
|---|---|---|
TOKENLAB_API_BASE | https://api.tokenlab.sh | Hôte API TokenLab personnalisé ; omettez la barre oblique finale |
TOKENLAB_MCP_TOOL_PROFILE | core | catalog, core ou full |
TOKENLAB_REQUEST_TIMEOUT_MS | 120000 | Délai d'expiration de la requête en millisecondes |
TOKENLAB_MCP_MAX_FILE_BYTES | 104857600 | Taille de téléchargement locale maximale par fichier |
TOKENLAB_ARTIFACT_DIR | Répertoire temporaire OS | Où les gros fichiers téléchargés sont enregistrés |
Utilisez les valeurs par défaut à moins que votre client ou déploiement n'ait une exigence spécifique.
Dépannage
Explorateur de modèles hébergé
Les clients qui prennent en charge le HTTP diffusable (Streamable) peuvent utiliser l'explorateur de modèles public à l'adresse :
https://mcp.tokenlab.sh/mcpUtilisez le serveur npm local pour les appels API payants, les téléchargements de fichiers locaux ou les profils core et full.
Liens
- Page MCP TokenLab
- Générer des images et des vidéos depuis Claude Code ou OpenClaw
- Dépôt GitHub
- Agent Skills TokenLab
- Catalogue de modèles
- Démarrage rapide de l'API
Configurez les notifications de tâches avec l'API de gestion des Webhooks, authentifiée avec un jeton de gestion mt-…. Le profil MCP full utilise TOKENLAB_MANAGEMENT_TOKEN. Arrêtez d'interroger les tâches terminales en cas d'erreurs 401/403/404 ou d'erreurs non récupérables.