Serveur MCP TokenLab

Choisissez ce dont votre agent a besoinCopy Anchor Link

• MCP ajoute les outils de l'API TokenLab à un client compatible. Commencez par la configuration sans clé catalog ci-dessous.
• Le Skill TokenLab installe les instructions d'intégration avec npx skills add ; il ne démarre pas de serveur MCP.

Les deux étendent un agent existant. Pour modifier son fournisseur de modèle principal, utilisez le guide de configuration propre à ce client.

Laisser mon agent s'en chargerCopy Anchor Link

Copiez cette tâche dans 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 Serveur MCP TokenLab permet à un client MCP de parcourir les modèles et les tarifs actuels, d'envoyer des requêtes aux modèles, de créer des médias, de manipuler des fichiers et de vérifier des tâches asynchrones.

Utilisez le profil catalog pour parcourir les modèles et les tarifs sans clé API. Ajoutez TOKENLAB_API_KEY lorsque le client doit effectuer des requêtes payantes de modèles ou de médias.

PrérequisCopy Anchor Link

Installez Node.js 18.17 ou une version plus récente et assurez-vous que npx est disponible :

node --version
npx --version

Le package npm s'exécute localement via stdio. Vous n'avez pas besoin d'une installation globale ni de cloner les sources.

Choisissez ce que le client peut utiliserCopy Anchor Link

Commencez par 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 véritablement besoin de l'ensemble d'outils étendu.

Ajouter le serveurCopy Anchor Link

Sauvegardez la configuration active. Ajoutez uniquement l'entrée TokenLab et conservez les fournisseurs, comptes, sélection de modèle par défaut et autorisations 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.

claude mcp add \
  --env TOKENLAB_MCP_TOOL_PROFILE=catalog \
  --scope user \
  tokenlab -- \
  npx -y @tokenlabai/mcp-server@0.6.24

Activer les outils payantsCopy Anchor Link

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 le champ de saisie de secret de votre client lorsqu'il en dispose d'un. Si une vraie clé apparaît dans un fichier partagé, une capture d'écran, un log ou l'historique du shell, révoquez-la et créez une nouvelle clé.

Vérifier la connexionCopy Anchor Link

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 list

Demandez au client d'appeler list_models. Une liste non vide confirme que le package a démarré et a contacté TokenLab. Le profil catalog ne nécessite pas de clé API.

Outils utilesCopy Anchor Link

La disponibilité des outils dépend du profil sélectionné. Les tâches courantes incluent :

• lister les modèles et consulter les capacités d'un modèle
• consulter les tarifs actuels de TokenLab ou comparer plusieurs modèles
• envoyer des requêtes Chat Completions, Responses, Anthropic Messages ou 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éverser et récupérer des fichiers
• créer des embeddings ou réordonner des documents
• vérifier et annuler les tâches asynchrones prises en charge

Le client doit demander une approbation avant un appel payant lorsque le tarif ou le choix du modèle n'a pas encore été confirmé.

Modèles de décisionCopy Anchor Link

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'identifiant du modèle sélectionné. Conservez 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 une valeur de probabilité numérique, pas un booléen. Conservez l'identifiant de requête issu de _meta lorsqu'il est disponible. L'outil renvoie un résultat synchrone ; il n'utilise pas le flux d'interrogation de tâches asynchrones.

Avec le délai d'expiration des requêtes serveur par défaut de 120 000 ms, prévoyez au moins 150 000 ms pour l'appel d'outil du client. Si vous modifiez TOKENLAB_REQUEST_TIMEOUT_MS, conservez un délai d'expiration du client plus long. Un dépassement de délai laisse le résultat incertain ; inspectez la requête avant de renvoyer un appel payant. Validez les décisions par rapport à vos propres cas étiquetés avant de les utiliser pour déclencher des actions.

Médias asynchronesCopy Anchor Link

Les outils de vidéo, de musique et de 3D renvoient une tâche au lieu d'un fichier finalisé. 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 identifiant de tâche jusqu'à ce que l'état soit terminé ou en échec. Ne créez pas de deuxième tâche simplement parce qu'une vérification d'état a expiré.

Paramètres facultatifsCopy Anchor Link

Utilisez les valeurs par défaut, sauf si votre client ou votre déploiement a une exigence spécifique.

DépannageCopy Anchor Link

Explorateur de modèles hébergéCopy Anchor Link

Les clients prenant en charge Streamable HTTP peuvent utiliser l'explorateur de modèles public à l'adresse :

https://tokenlab-model-explorer.vercel.app/mcp

Utilisez le serveur npm local pour les appels d'API payants, les téléversements de fichiers locaux ou les profils core et full.

LiensCopy Anchor Link

• Page TokenLab MCP
• Dépôt GitHub
• Skill API 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 Management Token mt-…. MCP full utilise TOKENLAB_MANAGEMENT_TOKEN. Arrêtez d'interroger les tâches terminales ainsi qu'en cas d'erreurs 401/403/404 ou d'erreurs non renouvelables.