Kodlama araçları

TokenLab MCP Sunucusu

Claude Code, Cursor, VS Code, Codex ve diğer MCP istemcilerine TokenLab modellerine ve API'lerine erişim sağlayın

Ajanınızın neye ihtiyacı olduğunu seçin

  • MCP, uyumlu bir istemciye TokenLab API araçlarını ekler. Aşağıdaki anahtar gerektirmeyen catalog kurulumuyla başlayın.
  • TokenLab Agent Skills, ajana bir sonuç için hangi yöntemi kullanacağını (örneğin hangi modelin seçileceği ve çıktının nasıl kontrol edileceği gibi) öğretir. Bunlar bir MCP sunucusu başlatmazlar, ancak her ikisi de yüklendiğinde bu MCP araçlarını kullanabilirler.

Model seçici skill'ini yükleyin: npx skills add hedging8563/tokenlab-skills --skill tokenlab-model-picker

GitHub üzerinde tokenlab-skills.

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

Ajanımın bunu kurmasına izin ver

Bu görevi bilgisayarınızda zaten çalışan 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 modelleri ve fiyatları incelemesine, model istekleri göndermesine, medya oluşturmasına, dosyalarla çalışmasına ve asenkron görevleri kontrol etmesine olanak tanır.

Modelleri ve fiyatları API anahtarı olmadan incelemek için catalog profilini kullanın. İstemcinin ücretli model veya medya istekleri yapması gerektiğinde TOKENLAB_API_KEY ekleyin.

TokenLab API anahtarınızı MCP sunucu ortamında tutun. Asla bir isteme (prompt) veya araç argümanına yapıştırmayın.

Gereksinimler

Node.js 18.17 veya daha yeni bir sürümünü yükleyin ve npx'in kullanılabilir olduğundan emin olun:

node --version
npx --version

npm paketi yerel olarak stdio üzerinden çalışır. Genel bir kuruluma veya kaynak kodun indirilmesine gerek yoktur.

İstemcinin neleri kullanabileceğini seçin

ProfilAPI anahtarıİçerik
catalogGerekli değilModel listesi, model detayları, fiyatlar, karşılaştırmalar ve API'ye genel bakış
coreÜcretli çağrılar için gerekliGenel sohbet, karar, medya, ses, dosya, görev, embedding, rerank ve çeviri araçları
fullÜcretli çağrılar için gereklicore artı ek geliştirici API'leri

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, daha geniş bir araç setine gerçekten ihtiyaç duyan istemciler içindir.

Sunucuyu ekleyin

Aktif yapılandırmayı yedekleyin. Yalnızca TokenLab girişini 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 girişi kaldırın veya önceki yedeğini geri yükleyin.

Kullanıcı hesabınız için genel kataloğu ekleyin:

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

Ücretli araçları kullanmak için profil ortam değişkenini TOKENLAB_API_KEY ile değiştirin ve anahtarı normal gizli yönetim yönteminizle saklayın. Bir proje için --scope local kullanın. Paylaşılan bir .mcp.json dosyasına asla gerçek bir anahtar işlemeyin.

Ücretli araçları etkinleştirin

Console → API keys bölümünden bir API anahtarı oluşturun, ardından her iki değişkeni de MCP sunucu ortamında ayarlayın:

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

İstemcinizin gizli giriş yöntemi varsa onu kullanın. Paylaşılan bir dosyada, ekran görüntüsünde, günlükte veya kabuk geçmişinde gerçek bir anahtar görünürse, onu iptal edin ve yeni bir anahtar oluşturun.

Bağlantıyı kontrol edin

MCP istemcisini yeniden başlatın veya yenileyin, 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 komutunu çağırmasını isteyin. Boş olmayan bir liste, paketin başladığını ve TokenLab'e ulaştığını doğrular. catalog profili API anahtarına ihtiyaç duymaz.

Faydalı araçlar

Araç 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 birkaç modeli karşılaştırma
  • Sohbet Tamamlama (Chat Completions), Yanıtlar, Anthropic Mesajları veya Gemini istekleri gönderme
  • evaluate_decisions ile yazılmış kararları değerlendirme
  • görsel oluşturma veya düzenleme
  • video, müzik, 3D, konuşma, transkripsiyon veya çeviri oluşturma
  • dosya yükleme ve alma
  • embedding oluşturma veya belgeleri yeniden sıralama (rerank)
  • desteklenen asenkron görevleri kontrol etme ve iptal etme

İstemci, fiyat veya model seçimi daha önce onaylanmamışsa, ücretli bir çağrıdan önce onay istemelidir.

MCP dosya araçları, OpenAI uyumlu /v1/files API'sini kullanır. Gemini Dosyaları, devam ettirilebilir yüklemeler ve cachedContents şu anda HTTP çağrıları gerektirir ve MCP profillerine dahil değildir. Bkz: Gemini Files and cache.

Karar modelleri

Bir System One karar modelini çağırmak için core veya full kullanın. Önce {"category":"decision"} ile list_models komutunu ve seçilen model kimliğiyle get_model komutunu çağırın. Ajanın ana sohbet modelini ayrı olarak yapılandırılmış halde 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 kısımlarını okuyun. Noul cevabı bir Boolean değil, bir olasılık sayısıdır. Mümkün olduğunda _meta içindeki istek kimliğini koruyun. Araç senkron bir sonuç döndürür; asenkron görev yoklama 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ını daha uzun tutun. Bir zaman aşımı, sonucu belirsiz bırakır; ücretli bir çağrıyı yeniden göndermeden önce isteği inceleyin. Kararları, eylemleri yönlendirmek için kullanmadan önce kendi etiketli vakalarınızla doğrulayın.

Asenkron medya

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

Bir sonuç asenkron bir delivery içerdiğinde, durum tamamlanana veya başarısız olana kadar görev kimliğiyle get_task_status komutunu çağırın. Bir durum kontrolü zaman aşımına uğradığı için ikinci bir görev oluşturmayın.

İsteğe bağlı ayarlar

DeğişkenVarsayılanKullanım
TOKENLAB_API_BASEhttps://api.tokenlab.shÖzel TokenLab API ana bilgisayarı; sondaki eğik çizgiyi atlayın
TOKENLAB_MCP_TOOL_PROFILEcorecatalog, core veya full
TOKENLAB_REQUEST_TIMEOUT_MS120000Milisaniye cinsinden istek zaman aşımı
TOKENLAB_MCP_MAX_FILE_BYTES104857600Dosya başına maksimum yerel yükleme boyutu
TOKENLAB_ARTIFACT_DIRİşletim sistemi geçici diziniBüyük indirilen dosyaların kaydedildiği yer

İstemcinizin veya dağıtımınızın özel bir gereksinimi yoksa varsayılanları kullanın.

Sorun giderme

Barındırılan model gezgini

Streamable HTTP'yi destekleyen istemciler, şu adresteki genel model gezginini kullanabilir:

https://mcp.tokenlab.sh/mcp

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

Bağlantılar

Görev bildirimlerini, bir mt-… Yönetim Belirteci (Management Token) ile kimliği doğrulanmış Webhook yönetim API'si ile yapılandırın. MCP full profili TOKENLAB_MANAGEMENT_TOKEN kullanır. Terminal görevlerini yoklamayı durdurun ve 401/403/404 veya yeniden denenemez hatalarda işlemi sonlandırın.

Bu sayfada