TokenLab MCP Server

Pilih apa yang dibutuhkan agen AndaCopy Anchor Link

• MCP menambahkan tool API TokenLab ke klien yang kompatibel. Mulai dengan penyiapan catalog tanpa API key di bawah ini.
• TokenLab Skill menginstal instruksi integrasi dengan npx skills add; ini tidak menjalankan server MCP.

Keduanya memperluas agen yang sudah ada. Mengubah penyedia model utamanya menggunakan panduan penyiapan milik klien itu sendiri.

Biarkan agen saya menyiapkan iniCopy Anchor Link

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 menjelajahi model dan harga saat ini, mengirim permintaan model, membuat media, bekerja dengan file, dan memeriksa task asinkron.

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

PersyaratanCopy Anchor Link

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 source checkout.

Pilih apa yang dapat digunakan klienCopy Anchor Link

Mulai dengan catalog jika Anda hanya menginginkan pemilihan model yang lebih baik. Gunakan core ketika klien perlu membuat konten atau memanggil model. full ditujukan untuk klien yang benar-benar membutuhkan kumpulan tool yang lebih lengkap.

Tambahkan serverCopy Anchor Link

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

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

Aktifkan tool berbayarCopy Anchor Link

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

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

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

Periksa koneksiCopy Anchor Link

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

# Claude Code
claude mcp list

# Codex
codex mcp list

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

Tool yang bergunaCopy Anchor Link

Ketersediaan tool bergantung pada profil yang dipilih. Tugas-tugas umum meliputi:

• melihat daftar model dan membaca kapabilitas suatu model
• membaca harga TokenLab saat ini atau membandingkan beberapa model
• mengirim permintaan Chat Completions, Responses, Anthropic Messages, atau Gemini
• mengevaluasi keputusan terstruktur 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 task asinkron yang didukung

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

Model keputusanCopy Anchor Link

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

Untuk Jev 1.13, panggil tool dengan state dan questions native:

{
  "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 berupa angka probabilitas, bukan Boolean. Pertahankan request ID dari _meta jika tersedia. Tool ini mengembalikan hasil yang sinkron; tool ini tidak menggunakan alur polling task asinkron.

Dengan batas waktu permintaan server default sebesar 120.000 ms, berikan waktu setidaknya 150.000 ms untuk pemanggilan tool oleh klien. Jika Anda mengubah TOKENLAB_REQUEST_TIMEOUT_MS, pastikan batas waktu klien tetap lebih lama. Timeout membuat hasilnya tidak pasti; periksa permintaan sebelum mengirim ulang panggilan berbayar. Validasi keputusan terhadap kasus berlabel milik Anda sendiri sebelum menggunakannya untuk menjalankan tindakan.

Media asinkronCopy Anchor Link

Tool video, musik, dan 3D mengembalikan task alih-alih file yang sudah selesai. Tool gambar dapat mengembalikan hasil yang sudah selesai atau sebuah task, tergantung pada modelnya.

Ketika hasil menyertakan delivery asinkron, panggil get_task_status beserta ID task-nya hingga statusnya complete atau failed. Jangan membuat task kedua hanya karena salah satu pemeriksaan status mengalami timeout.

Pengaturan opsionalCopy Anchor Link

Gunakan pengaturan default kecuali jika klien atau penerapan Anda memiliki persyaratan khusus.

Pemecahan MasalahCopy Anchor Link

Model explorer yang di-hostingCopy Anchor Link

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

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

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

TautanCopy Anchor Link

• Halaman TokenLab MCP
• Repositori GitHub
• TokenLab API skill
• Katalog model
• Panduan ringkas API

Konfigurasikan notifikasi task dengan Webhook management API, yang diautentikasi menggunakan Management Token mt-…. MCP full menggunakan TOKENLAB_MANAGEMENT_TOKEN. Hentikan polling pada task terminal serta saat terjadi error 401/403/404 atau error yang tidak dapat dicoba lagi.