Alat coding

TokenLab MCP Server

Berikan akses ke model dan API TokenLab kepada Claude Code, Cursor, VS Code, Codex, dan klien MCP lainnya

Pilih apa yang dibutuhkan agen Anda

  • MCP menambahkan alat API TokenLab ke klien yang kompatibel. Mulailah dengan pengaturan catalog bebas kunci di bawah ini.
  • TokenLab Agent Skills mengajarkan agen metode untuk mendapatkan hasil, seperti model mana yang harus dipilih dan cara memeriksa output. Skill ini tidak menjalankan server MCP, dan mereka dapat menggunakan alat MCP ini jika keduanya terpasang.

Instal skill pemilih model: npx skills add hedging8563/tokenlab-skills --skill tokenlab-model-picker

tokenlab-skills di GitHub.

Keduanya memperluas agen yang sudah ada. Mengubah penyedia model utama agen menggunakan panduan pengaturan klien tersebut.

Biarkan agen saya yang mengatur ini

Salin tugas ini ke agen yang sudah berjalan di komputer Anda:

Read this guide and choose MCP catalog tools or a Skill for my task:
https://tokenlab.sh/docs/id/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 Server memungkinkan klien MCP untuk menelusuri model dan harga terkini, mengirim permintaan model, membuat media, bekerja dengan file, dan memeriksa tugas asinkron.

Gunakan profil catalog untuk menelusuri model dan harga tanpa API key. Tambahkan TOKENLAB_API_KEY saat klien perlu melakukan permintaan model berbayar atau permintaan media.

Simpan API key TokenLab Anda di lingkungan server MCP. Jangan pernah menempelkannya ke dalam prompt atau argumen alat.

Persyaratan

Instal Node.js 18.17 atau yang lebih baru dan pastikan npx tersedia:

node --version
npx --version

Paket npm berjalan secara lokal melalui stdio. Anda tidak memerlukan instalasi global atau checkout sumber.

Pilih apa yang dapat digunakan klien

ProfilAPI keyTermasuk
catalogTidak diperlukanDaftar model, detail model, harga, perbandingan, dan ikhtisar API
coreDiperlukan untuk panggilan berbayarAlat obrolan umum, keputusan, media, audio, file, tugas, embedding, rerank, dan terjemahan
fullDiperlukan untuk panggilan berbayarcore ditambah API pengembang tambahan

Mulailah dengan catalog jika Anda hanya menginginkan pemilihan model yang lebih baik. Gunakan core saat klien perlu membuat konten atau memanggil model. full ditujukan untuk klien yang benar-benar membutuhkan rangkaian alat yang lebih besar.

Tambahkan server

Cadangkan konfigurasi yang aktif. Tambahkan hanya entri TokenLab dan pertahankan penyedia, akun, pemilihan model default, dan izin yang sudah ada. Jika nama tersebut sudah digunakan, pilih nama lain dan perbarui perintahnya. Untuk membatalkan pengaturan, hapus hanya entri yang Anda tambahkan atau pulihkan cadangan sebelumnya.

Tambahkan katalog publik untuk akun pengguna Anda:

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

Untuk menggunakan alat berbayar, ganti variabel lingkungan profil dengan TOKENLAB_API_KEY dan simpan kunci melalui metode manajemen rahasia normal Anda. Gunakan --scope local untuk satu proyek. Jangan pernah melakukan commit kunci asli ke dalam .mcp.json yang dibagikan.

Aktifkan alat berbayar

Buat API key di Console → API keys, lalu atur kedua variabel di lingkungan server MCP:

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

Gunakan input rahasia klien Anda jika tersedia. Jika kunci asli muncul di file bersama, tangkapan layar, log, atau riwayat shell, cabut kunci tersebut dan buat kunci baru.

Periksa koneksi

Mulai ulang atau muat ulang klien MCP, setujui server lokal jika diminta, dan konfirmasikan bahwa tokenlab terhubung.

# Claude Code
claude mcp list

# Codex
codex mcp list

Minta klien untuk memanggil list_models. Daftar yang tidak kosong mengonfirmasi bahwa paket telah dimulai dan mencapai TokenLab. Profil catalog tidak memerlukan API key.

Alat yang berguna

Ketersediaan alat bergantung pada profil yang dipilih. Tugas umum meliputi:

  • mencantumkan model dan membaca kemampuan satu model
  • membaca harga TokenLab saat ini atau membandingkan beberapa model
  • mengirim Chat Completions, Responses, Anthropic Messages, atau permintaan Gemini
  • mengevaluasi keputusan bertipe dengan evaluate_decisions
  • membuat atau mengedit gambar
  • membuat video, musik, 3D, ucapan, transkripsi, atau terjemahan
  • mengunggah dan mengambil file
  • membuat embedding atau melakukan rerank dokumen
  • memeriksa dan membatalkan tugas asinkron yang didukung

Klien harus meminta persetujuan sebelum panggilan berbayar jika harga atau pilihan model belum dikonfirmasi.

Alat file MCP menggunakan API /v1/files yang kompatibel dengan OpenAI. Gemini Files, unggahan yang dapat dilanjutkan, dan cachedContents saat ini memerlukan panggilan HTTP dan tidak disertakan dalam profil MCP. Lihat Gemini Files and cache.

Model keputusan

Gunakan core atau full untuk memanggil System One decision model. Pertama, panggil list_models dengan {"category":"decision"} dan get_model dengan ID model yang dipilih. Tetap konfigurasikan model obrolan utama agen secara terpisah.

Untuk Jev 1.13, panggil alat dengan state dan questions asli:

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

Periksa isError, lalu baca structuredContent.answers dan structuredContent.usage. Jawaban Noul adalah angka probabilitas, bukan Boolean. Pertahankan ID permintaan dari _meta jika tersedia. Alat ini mengembalikan hasil sinkron; alat ini tidak menggunakan alur polling tugas asinkron.

Dengan batas waktu permintaan server default 120.000 ms, berikan setidaknya 150.000 ms untuk panggilan alat klien. Jika Anda mengubah TOKENLAB_REQUEST_TIMEOUT_MS, buat batas waktu klien lebih lama. Batas waktu membuat hasil menjadi tidak pasti; periksa permintaan sebelum mengirim ulang panggilan berbayar. Validasi keputusan terhadap kasus berlabel Anda sendiri sebelum menggunakannya untuk mendorong tindakan.

Media asinkron

Alat video, musik, dan 3D mengembalikan tugas, bukan file yang sudah selesai. Alat gambar dapat mengembalikan hasil yang sudah selesai atau tugas, tergantung pada modelnya.

Jika hasil menyertakan delivery asinkron, panggil get_task_status dengan ID tugasnya hingga statusnya selesai atau gagal. Jangan membuat tugas kedua karena pemeriksaan status kehabisan waktu.

Pengaturan opsional

VariabelDefaultPenggunaan
TOKENLAB_API_BASEhttps://api.tokenlab.shHost API TokenLab kustom; hilangkan garis miring di akhir
TOKENLAB_MCP_TOOL_PROFILEcorecatalog, core, atau full
TOKENLAB_REQUEST_TIMEOUT_MS120000Batas waktu permintaan dalam milidetik
TOKENLAB_MCP_MAX_FILE_BYTES104857600Ukuran unggahan lokal maksimum per file
TOKENLAB_ARTIFACT_DIRDirektori sementara OSTempat file besar yang diunduh disimpan

Gunakan default kecuali klien atau penerapan Anda memiliki persyaratan khusus.

Pemecahan masalah

Penjelajah model yang dihosting

Klien yang mendukung HTTP Streamable dapat menggunakan penjelajah model publik di:

https://mcp.tokenlab.sh/mcp

Gunakan server npm lokal untuk panggilan API berbayar, unggahan file lokal, atau profil core dan full.

Tautan

Konfigurasikan notifikasi tugas dengan API manajemen Webhook, yang diautentikasi dengan Management Token mt-…. MCP full menggunakan TOKENLAB_MANAGEMENT_TOKEN. Hentikan polling tugas terminal pada 401/403/404 atau kesalahan yang tidak dapat dicoba kembali.

Di halaman ini