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
catalogbebas 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
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 --versionPaket npm berjalan secara lokal melalui stdio. Anda tidak memerlukan instalasi global atau checkout sumber.
Pilih apa yang dapat digunakan klien
| Profil | API key | Termasuk |
|---|---|---|
catalog | Tidak diperlukan | Daftar model, detail model, harga, perbandingan, dan ikhtisar API |
core | Diperlukan untuk panggilan berbayar | Alat obrolan umum, keputusan, media, audio, file, tugas, embedding, rerank, dan terjemahan |
full | Diperlukan untuk panggilan berbayar | core 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.48Untuk 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 listMinta 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
| Variabel | Default | Penggunaan |
|---|---|---|
TOKENLAB_API_BASE | https://api.tokenlab.sh | Host API TokenLab kustom; hilangkan garis miring di akhir |
TOKENLAB_MCP_TOOL_PROFILE | core | catalog, core, atau full |
TOKENLAB_REQUEST_TIMEOUT_MS | 120000 | Batas waktu permintaan dalam milidetik |
TOKENLAB_MCP_MAX_FILE_BYTES | 104857600 | Ukuran unggahan lokal maksimum per file |
TOKENLAB_ARTIFACT_DIR | Direktori sementara OS | Tempat 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/mcpGunakan server npm lokal untuk panggilan API berbayar, unggahan file lokal, atau profil core dan full.
Tautan
- Halaman TokenLab MCP
- Buat gambar dan video dari Claude Code atau OpenClaw
- Repositori GitHub
- TokenLab Agent Skills
- Katalog model
- Memulai API
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.