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
catalogkurulumuyla 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 --versionnpm paketi yerel olarak stdio üzerinden çalışır. Genel bir kuruluma veya kaynak kodun indirilmesine gerek yoktur.
İstemcinin neleri kullanabileceğini seçin
| Profil | API anahtarı | İçerik |
|---|---|---|
catalog | Gerekli değil | Model listesi, model detayları, fiyatlar, karşılaştırmalar ve API'ye genel bakış |
core | Ücretli çağrılar için gerekli | Genel sohbet, karar, medya, ses, dosya, görev, embedding, rerank ve çeviri araçları |
full | Ücretli çağrılar için gerekli | core 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_decisionsile 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şken | Varsayılan | Kullanım |
|---|---|---|
TOKENLAB_API_BASE | https://api.tokenlab.sh | Özel TokenLab API ana bilgisayarı; sondaki eğik çizgiyi atlayın |
TOKENLAB_MCP_TOOL_PROFILE | core | catalog, core veya full |
TOKENLAB_REQUEST_TIMEOUT_MS | 120000 | Milisaniye cinsinden istek zaman aşımı |
TOKENLAB_MCP_MAX_FILE_BYTES | 104857600 | Dosya başına maksimum yerel yükleme boyutu |
TOKENLAB_ARTIFACT_DIR | İşletim sistemi geçici dizini | Bü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
- TokenLab MCP sayfası
- Claude Code veya OpenClaw'dan görsel ve video oluşturma
- GitHub deposu
- TokenLab Agent Skills
- Model kataloğu
- API hızlı başlangıç
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.