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

tokenlab-skills auf GitHub.

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 --version

Das 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

ProfilAPI-KeyBeinhaltet
catalogNicht erforderlichModellliste, Modelldetails, Preise, Vergleiche und API-Übersicht
coreErforderlich für kostenpflichtige AufrufeAllgemeine Chat-, Entscheidungs-, Medien-, Audio-, Datei-, Aufgaben-, Embedding-, Rerank- und Übersetzungstools
fullErforderlich für kostenpflichtige Aufrufecore 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.48

Um 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 list

Bitten 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_decisions bewerten
  • 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

VariableStandardVerwendung
TOKENLAB_API_BASEhttps://api.tokenlab.shBenutzerdefinierter TokenLab API-Host; lassen Sie den abschließenden Schrägstrich weg
TOKENLAB_MCP_TOOL_PROFILEcorecatalog, core oder full
TOKENLAB_REQUEST_TIMEOUT_MS120000Anfrage-Timeout in Millisekunden
TOKENLAB_MCP_MAX_FILE_BYTES104857600Maximale lokale Upload-Größe pro Datei
TOKENLAB_ARTIFACT_DIROS temporäres VerzeichnisSpeicherort 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/mcp

Verwenden Sie den lokalen npm-Server für kostenpflichtige API-Aufrufe, lokale Datei-Uploads oder die Profile core und full.

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.

Auf dieser Seite