Coding-Tools
TokenLab MCP Server
Ermöglichen Sie Claude Code, Cursor, VS Code, Codex und anderen MCP-Clients den Zugriff auf TokenLab-Modelle und APIs
Wählen Sie aus, was Ihr Agent benötigt
- MCP fügt einem kompatiblen Client TokenLab API-Tools hinzu. Beginnen Sie mit der schlüssellosen
catalog-Einrichtung weiter unten. - TokenLab Agent Skills bringen dem Agenten die Methode für ein Ergebnis bei, z. B. welches Modell ausgewählt werden soll und wie die Ausgabe überprüft wird. Sie starten keinen MCP-Server, können aber diese MCP-Tools verwenden, wenn beide installiert sind.
Installieren Sie den Model-Picker-Skill: npx skills add hedging8563/tokenlab-skills --skill tokenlab-model-picker
Beide erweitern einen bestehenden Agenten. Das Ändern seines Hauptmodell-Anbieters erfolgt über die Einrichtungsanleitung des jeweiligen Clients.
Lassen Sie meinen Agenten dies einrichten
Kopieren Sie diese Aufgabe für einen Agenten, der bereits auf Ihrem Computer läuft:
Read this guide and choose MCP catalog tools or a Skill for my task:
https://tokenlab.sh/docs/de/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.Der TokenLab MCP Server ermöglicht es einem MCP-Client, aktuelle Modelle und Preise zu durchsuchen, Modellanfragen zu senden, Medien zu erstellen, mit Dateien zu arbeiten und asynchrone Aufgaben zu überprüfen.
Verwenden Sie das catalog-Profil, um Modelle und Preise ohne API-Key zu durchsuchen. Fügen Sie TOKENLAB_API_KEY hinzu, wenn der Client kostenpflichtige Modell- oder Medienanfragen stellen soll.
Bewahren Sie Ihren TokenLab API-Key in der Umgebung des MCP-Servers auf. Fügen Sie ihn niemals in einen Prompt oder ein Tool-Argument ein.
Anforderungen
Installieren Sie Node.js 18.17 oder neuer und stellen Sie sicher, dass npx verfügbar ist:
node --version
npx --versionDas npm-Paket läuft lokal über stdio. Sie benötigen keine globale Installation oder einen Source-Checkout.
Wählen Sie aus, was der Client verwenden kann
| Profil | API-Key | Beinhaltet |
|---|---|---|
catalog | Nicht erforderlich | Modellliste, Modelldetails, Preise, Vergleiche und API-Übersicht |
core | Erforderlich für kostenpflichtige Aufrufe | Allgemeine Chat-, Entscheidungs-, Medien-, Audio-, Datei-, Aufgaben-, Embedding-, Rerank- und Übersetzungstools |
full | Erforderlich für kostenpflichtige Aufrufe | core plus zusätzliche Entwickler-APIs |
Beginnen Sie mit catalog, wenn Sie nur eine bessere Modellauswahl wünschen. Verwenden Sie core, wenn der Client Inhalte erstellen oder ein Modell aufrufen soll. full ist für Clients gedacht, die tatsächlich den größeren Tool-Satz benötigen.
Fügen Sie den Server hinzu
Sichern Sie die aktive Konfiguration. Fügen Sie nur den TokenLab-Eintrag hinzu und bewahren Sie bestehende Anbieter, Konten, die Auswahl des Standardmodells und Berechtigungen auf. Wenn der Name bereits verwendet wird, wählen Sie einen anderen Namen und aktualisieren Sie die Befehle. Um die Einrichtung rückgängig zu machen, entfernen Sie nur Ihren hinzugefügten Eintrag oder stellen Sie das vorherige Backup wieder her.
Fügen Sie den öffentlichen Katalog für Ihr Benutzerkonto hinzu:
claude mcp add \
--env TOKENLAB_MCP_TOOL_PROFILE=catalog \
--scope user \
tokenlab -- \
npx -y @tokenlabai/mcp-server@0.6.48Um kostenpflichtige Tools zu verwenden, ersetzen Sie die Umgebungsvariable des Profils durch TOKENLAB_API_KEY und speichern Sie den Key über Ihre normale Methode zur Geheimnisverwaltung. Verwenden Sie --scope local für ein einzelnes Projekt. Committen Sie niemals einen echten Key in eine gemeinsam genutzte .mcp.json.
Kostenpflichtige Tools aktivieren
Erstellen Sie einen API-Key unter Console → API keys und setzen Sie dann beide Variablen in der Umgebung des MCP-Servers:
{
"env": {
"TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>",
"TOKENLAB_MCP_TOOL_PROFILE": "core"
}
}Verwenden Sie die Geheimnis-Eingabe Ihres Clients, falls vorhanden. Wenn ein echter Key in einer gemeinsam genutzten Datei, einem Screenshot, einem Log oder der Shell-Historie erscheint, widerrufen Sie ihn und erstellen Sie einen neuen Key.
Verbindung überprüfen
Starten Sie den MCP-Client neu, genehmigen Sie den lokalen Server, falls dazu aufgefordert, und bestätigen Sie, dass tokenlab verbunden ist.
# Claude Code
claude mcp list
# Codex
codex mcp listBitten Sie den Client, list_models aufzurufen. Eine nicht leere Liste bestätigt, dass das Paket gestartet wurde und TokenLab erreicht hat. Das catalog-Profil benötigt keinen API-Key.
Nützliche Tools
Die Verfügbarkeit der Tools hängt vom ausgewählten Profil ab. Zu den häufigen Aufgaben gehören:
- Modelle auflisten und die Fähigkeiten eines Modells lesen
- Aktuelle TokenLab-Preise lesen oder mehrere Modelle vergleichen
- Chat-Vervollständigungen, Antworten, Anthropic-Nachrichten oder Gemini-Anfragen senden
- Typisierte Entscheidungen mit
evaluate_decisionsbewerten - Bilder erstellen oder bearbeiten
- Video, Musik, 3D, Sprache, Transkription oder Übersetzung erstellen
- Dateien hochladen und abrufen
- Embeddings erstellen oder Dokumente neu bewerten (rerank)
- Unterstützte asynchrone Aufgaben überprüfen und abbrechen
Der Client sollte vor einem kostenpflichtigen Aufruf um Genehmigung bitten, wenn der Preis oder die Modellauswahl noch nicht bestätigt wurde.
Die MCP-Dateitools verwenden die OpenAI-kompatible /v1/files API. Gemini-Dateien, fortsetzbare Uploads und cachedContents erfordern derzeit HTTP-Aufrufe und sind nicht in den MCP-Profilen enthalten. Siehe Gemini Files and cache.
Entscheidungsmodelle
Verwenden Sie core oder full, um ein System One decision model aufzurufen. Rufen Sie zuerst list_models mit {"category":"decision"} und get_model mit der ausgewählten Modell-ID auf. Halten Sie das Haupt-Chat-Modell des Agenten separat konfiguriert.
Für Jev 1.13 rufen Sie das Tool mit nativem state und questions auf:
{
"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?"
}
}
}
}Überprüfen Sie isError und lesen Sie dann structuredContent.answers und structuredContent.usage. Eine Noul-Antwort ist eine Wahrscheinlichkeitszahl, kein Boolean. Bewahren Sie die Anfrage-ID aus _meta auf, falls verfügbar. Das Tool gibt ein synchrones Ergebnis zurück; es verwendet nicht den asynchronen Aufgaben-Polling-Ablauf.
Lassen Sie bei dem standardmäßigen Server-Anfrage-Timeout von 120.000 ms mindestens 150.000 ms für den Client-Tool-Aufruf zu. Wenn Sie TOKENLAB_REQUEST_TIMEOUT_MS ändern, halten Sie das Client-Timeout länger. Ein Timeout lässt das Ergebnis ungewiss; überprüfen Sie die Anfrage, bevor Sie einen kostenpflichtigen Aufruf erneut senden. Validieren Sie Entscheidungen anhand Ihrer eigenen gelabelten Fälle, bevor Sie sie zur Steuerung von Aktionen verwenden.
Asynchrone Medien
Video-, Musik- und 3D-Tools geben eine Aufgabe anstelle einer fertigen Datei zurück. Bild-Tools können je nach Modell entweder ein fertiges Ergebnis oder eine Aufgabe zurückgeben.
Wenn ein Ergebnis eine asynchrone delivery enthält, rufen Sie get_task_status mit der Aufgaben-ID auf, bis der Status abgeschlossen oder fehlgeschlagen ist. Erstellen Sie keine zweite Aufgabe, nur weil eine Statusüberprüfung ein Timeout hatte.
Optionale Einstellungen
| Variable | Standard | Verwendung |
|---|---|---|
TOKENLAB_API_BASE | https://api.tokenlab.sh | Benutzerdefinierter TokenLab API-Host; lassen Sie den abschließenden Schrägstrich weg |
TOKENLAB_MCP_TOOL_PROFILE | core | catalog, core oder full |
TOKENLAB_REQUEST_TIMEOUT_MS | 120000 | Anfrage-Timeout in Millisekunden |
TOKENLAB_MCP_MAX_FILE_BYTES | 104857600 | Maximale lokale Upload-Größe pro Datei |
TOKENLAB_ARTIFACT_DIR | OS temporäres Verzeichnis | Speicherort für große heruntergeladene Dateien |
Verwenden Sie die Standardwerte, es sei denn, Ihr Client oder Ihre Bereitstellung hat eine spezifische Anforderung.
Fehlerbehebung
Gehosteter Modell-Explorer
Clients, die Streamable HTTP unterstützen, können den öffentlichen Modell-Explorer unter folgender Adresse verwenden:
https://mcp.tokenlab.sh/mcpVerwenden Sie den lokalen npm-Server für kostenpflichtige API-Aufrufe, lokale Datei-Uploads oder die Profile core und full.
Links
- TokenLab MCP-Seite
- Bilder und Videos von Claude Code oder OpenClaw generieren
- GitHub-Repository
- TokenLab Agent Skills
- Modellkatalog
- API-Schnellstart
Konfigurieren Sie Aufgabenbenachrichtigungen mit der Webhook-Management-API, authentifiziert mit einem mt-… Management Token. MCP full verwendet TOKENLAB_MANAGEMENT_TOKEN. Stoppen Sie das Polling von Terminal-Aufgaben bei 401/403/404 oder nicht wiederholbaren Fehlern.