TokenLab MCP Server

Ajanınızın neye ihtiyacı olduğunu seçinCopy Anchor Link

• MCP, uyumlu bir istemciye TokenLab API araçlarını ekler. Aşağıdaki anahtarsız catalog kurulumu ile başlayın.
• TokenLab Yeteneği, npx skills add ile entegrasyon talimatlarını yükler; bir MCP sunucusu başlatmaz.

Her ikisi de mevcut bir ajanı genişletir. Ana model sağlayıcısını değiştirmek için o istemcinin kendi kurulum kılavuzu kullanılır.

Bunu ajanımın kurmasını sağlayınCopy Anchor Link

Bu görevi bilgisayarınızda zaten çalışmakta olan bir ajana kopyalayın:

Read this guide and choose MCP catalog tools or a Skill for my task:
https://tokenlab.sh/docs/tr/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.

TokenLab MCP Sunucusu, bir MCP istemcisinin güncel modellere ve fiyatlara göz atmasına, model istekleri göndermesine, medya oluşturmasına, dosyalarla çalışmasına ve asenkron görevleri kontrol etmesine olanak tanır.

API anahtarı olmadan modellere ve fiyatlara göz atmak için catalog profilini kullanın. İstemcinin ücretli model veya medya istekleri yapması gerektiğinde TOKENLAB_API_KEY ekleyin.

GereksinimlerCopy Anchor Link

Node.js 18.17 veya daha yenisini yükleyin ve npx'in kullanılabilir olduğundan emin olun:

node --version
npx --version

npm paketi stdio üzerinden yerel olarak çalışır. Global bir kuruluma veya kaynak kod indirmeye ihtiyacınız yoktur.

İstemcinin neleri kullanabileceğini seçinCopy Anchor Link

Yalnızca daha iyi model seçimi istiyorsanız catalog ile başlayın. İstemcinin içerik oluşturması veya bir model çağırması gerektiğinde core kullanın. full, gerçekten daha geniş araç setine ihtiyaç duyan istemciler içindir.

Sunucuyu ekleyinCopy Anchor Link

Aktif yapılandırmayı yedekleyin. Yalnızca TokenLab girdisini ekleyin ve mevcut sağlayıcıları, hesapları, varsayılan model seçimini ve izinleri koruyun. İsim zaten kullanılıyorsa başka bir isim seçin ve komutları güncelleyin. Kurulumu geri almak için yalnızca eklediğiniz girdiyi kaldırın veya önceki yedeğini geri yükleyin.

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

Ücretli araçları etkinleştirinCopy Anchor Link

Konsol → API anahtarları bölümünde bir API anahtarı oluşturun, ardından MCP sunucusu ortamında her iki değişkeni de ayarlayın:

{
  "env": {
    "TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>",
    "TOKENLAB_MCP_TOOL_PROFILE": "core"
  }
}

İstemcinizin secret girişi alanı varsa bunu kullanın. Gerçek bir anahtar paylaşılan bir dosyada, ekran görüntüsünde, log kaydında veya kabuk geçmişinde görünürse, anahtarı iptal edin ve yeni bir anahtar oluşturun.

Bağlantıyı kontrol edinCopy Anchor Link

MCP istemcisini yeniden başlatın veya yeniden yükleyin, istenirse yerel sunucuyu onaylayın ve tokenlab bağlantısının kurulduğunu doğrulayın.

# Claude Code
claude mcp list

# Codex
codex mcp list

İstemciden list_models çağrısı yapmasını isteyin. Boş olmayan bir liste, paketin başladığını ve TokenLab'e ulaştığını doğrular. catalog profili bir API anahtarı gerektirmez.

Yararlı araçlarCopy Anchor Link

Araçların kullanılabilirliği seçilen profile bağlıdır. Yaygın görevler şunları içerir:

• modelleri listeleme ve bir modelin yeteneklerini okuma
• güncel TokenLab fiyatlarını okuma veya birden fazla modeli karşılaştırma
• Chat Completions, Responses, Anthropic Messages veya Gemini istekleri gönderme
• evaluate_decisions ile tiplendirilmiş kararları değerlendirme
• görsel oluşturma veya düzenleme
• video, müzik, 3D, seslendirme, transkripsiyon veya çeviri oluşturma
• dosya yükleme ve alma
• embedding'ler oluşturma veya belgeleri yeniden sıralama (rerank)
• desteklenen asenkron görevleri kontrol etme ve iptal etme

Fiyat veya model seçimi önceden onaylanmadığında, istemci ücretli bir çağrı yapmadan önce onay istemelidir.

Karar modelleriCopy Anchor Link

Bir System One karar modelini çağırmak için core veya full profilini kullanın. Önce {"category":"decision"} ile list_models ve seçilen model ID'si ile get_model çağrısı yapın. Ajanın ana sohbet modelini ayrı olarak yapılandırılmış tutun.

Jev 1.13 için aracı yerel state ve questions ile çağırın:

{
  "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?"
      }
    }
  }
}

isError değerini kontrol edin, ardından structuredContent.answers ve structuredContent.usage alanlarını okuyun. Bir Noul yanıtı Boole (Boolean) değeri değil, bir olasılık sayısıdır. Mümkün olduğunda _meta içindeki istek ID'sini koruyun. Araç senkron bir sonuç döndürür; asenkron görev yoklama (polling) akışını kullanmaz.

Varsayılan 120.000 ms sunucu istek zaman aşımı ile, istemci araç çağrısı için en az 150.000 ms süre tanıyın. TOKENLAB_REQUEST_TIMEOUT_MS değerini değiştirirseniz, istemci zaman aşımı süresini daha uzun tutun. Zaman aşımı, sonucun belirsiz kalmasına neden olur; ücretli bir çağrıyı yeniden göndermeden önce isteği inceleyin. Kararları eylemleri yönlendirmek için kullanmadan önce kendi etiketli senaryolarınıza göre doğrulayın.

Asenkron medyaCopy Anchor Link

Video, müzik ve 3D araçları, tamamlanmış bir dosya yerine bir görev döndürür. Görsel araçları ise modele bağlı olarak tamamlanmış bir sonuç ya da bir görev döndürebilir.

Bir sonuç asenkron delivery içerdiğinde, durum complete veya failed olana kadar ilgili görev ID'siyle get_task_status çağrısı yapın. Bir durum kontrolü zaman aşımına uğradı diye ikinci bir görev oluşturmayın.

İsteğe bağlı ayarlarCopy Anchor Link

İstemcinizin veya dağıtımınızın özel bir gereksinimi olmadığı sürece varsayılan değerleri kullanın.

Sorun GidermeCopy Anchor Link

Barındırılan model gezginiCopy Anchor Link

Streamable HTTP destekleyen istemciler, herkese açık model gezginini şu adresten kullanabilir:

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

Ücretli API çağrıları, yerel dosya yüklemeleri veya core ve full profilleri için yerel npm sunucusunu kullanın.

BağlantılarCopy Anchor Link

• TokenLab MCP sayfası
• GitHub deposu
• TokenLab API yeteneği
• Model kataloğu
• API hızlı başlangıç

Görev bildirimlerini, bir mt-… Management Token ile kimlik doğrulaması yapılan Webhook yönetim API'si ile yapılandırın. MCP full, TOKENLAB_MANAGEMENT_TOKEN kullanır. Uç duruma (terminal) ulaşmış görevlerde ve 401/403/404 veya yeniden denenemeyen hatalarda yoklamayı (polling) durdurun.