Server MCP
kenari menjalankan server Model Context Protocol yang memberi agen dokumentasi kenari, daftar model terbaru, saldo, pemakaian, dan kuota akunmu, pencarian web, pengambilan halaman, pencarian X, serta semua model chat kenari. Hubungkan ke claude.ai, ChatGPT, Claude Code, Cursor, atau klien MCP lain, dan agen bisa mencari informasi, mengecek saldomu, dan meminta pendapat kedua dari model lain tanpa keluar dari sesinya.
Server ada di https://kenari.id/mcp. Server memakai transport Streamable HTTP: klien mengirim pesan JSON-RPC 2.0 dengan POST. Tool yang memanggil model atau web menjawab dengan stream server-sent event kalau klien menerima text/event-stream, seperti yang dilakukan klien MCP secara default. Stream mengirim heartbeat setiap 15 detik, atau notifikasi progres kalau klien mengirim progress token, lalu hasilnya, jadi panggilan yang lama tidak terputus. Jawaban lain berupa satu response JSON. Tidak ada stream yang dimulai dari server, jadi GET /mcp mengembalikan 405.
Hubungkan klien
Section titled “Hubungkan klien”Tool dokumentasi dan daftar model tidak butuh akun. Untuk tool lainnya, hubungkan akun kenari-mu dengan salah satu dari dua cara: masuk dari klien, atau pasang API key di konfigurasinya.
Masuk dari klien
Section titled “Masuk dari klien”Klien yang mendukung masuk lewat MCP (OAuth) cukup memakai URL https://kenari.id/mcp, tanpa key. Saat agen pertama kali memanggil tool yang butuh akun, klien membuka halaman kenari di browser-mu:
- Masuk ke kenari, kalau kamu belum masuk.
- Periksa aplikasi yang meminta akses. claude.ai dan chatgpt.com menampilkan Terverifikasi di samping alamatnya. Aplikasi yang mendaftarkan dirinya sendiri, seperti kebanyakan tool coding, atau yang berjalan di komputermu, menampilkan Tidak terverifikasi. Itu wajar untuk aplikasi seperti itu: lanjutkan hanya kalau kamu sendiri yang memulai koneksi ini.
- Periksa akun di Masuk sebagai. Untuk menghubungkan akun kenari lain, pilih Ganti akun.
- Di Ditagih ke, pilih workspace yang membayar.
- Pilih Izinkan.
Klien lalu memanggil tool itu lagi dalam keadaan sudah masuk. Klien memperbarui sesinya sendiri selama kamu memakainya. Setelah 90 hari tidak dipakai, klien memintamu masuk lagi.
Koneksi ini mendapat API key sendiri, yang tampil di API Keys dengan label Koneksi MCP. Pemakaian ditagih ke workspace yang kamu pilih, sama seperti key lain. Cabut key itu untuk memutus klien. Kalau kamu mengatur Masa berlaku key itu, koneksi berakhir pada tanggal tersebut.
claude.ai dan ChatGPT
Section titled “claude.ai dan ChatGPT”Tambahkan kenari sebagai custom connector dengan URL https://kenari.id/mcp tanpa key, lalu masuk saat connector memintanya.
Claude Code
Section titled “Claude Code”Tambahkan server dengan URL saja:
claude mcp add --transport http kenari https://kenari.id/mcpLalu masuk: jalankan /mcp di Claude Code, pilih kenari, lalu pilih Authenticate, atau jalankan claude mcp login kenari dari shell-mu. Sebelum kamu masuk, tool publik tetap bisa dipakai, dan tool yang butuh akun menandai kenari sebagai perlu masuk di /mcp.
Untuk memakai API key, tambahkan key sebagai header:
claude mcp add --transport http kenari https://kenari.id/mcp \ --header "Authorization: Bearer $KENARI_API_KEY"Shell-mu mengganti $KENARI_API_KEY saat kamu menjalankan perintah, jadi key tersimpan di konfigurasi MCP Claude Code.
Cursor
Section titled “Cursor”Tambahkan server ke ~/.cursor/mcp.json, atau ke .cursor/mcp.json di sebuah proyek:
{ "mcpServers": { "kenari": { "url": "https://kenari.id/mcp", "headers": { "Authorization": "Bearer kn-..." } } }}Klien lain
Section titled “Klien lain”Klien yang mendokumentasikan skema mcpServers, seperti Cursor, menerima entri di atas. Untuk klien lain yang mendukung server MCP jarak jauh lewat HTTP, atur URL https://kenari.id/mcp, lalu masuk kalau kliennya mendukung, atau tambahkan header Authorization: Bearer $KENARI_API_KEY di pengaturan klien itu sendiri.
Kirim key
Section titled “Kirim key”Kalau memakai API key, atur key sekali, di header entri server. Key tidak pernah menjadi argumen tool. kenari membaca key dari header Authorization, dengan atau tanpa awalan Bearer , atau dari x-api-key kalau kliennya memakai gaya itu. Kalau keduanya ada, Authorization yang dipakai.
Request tanpa key dan tanpa sesi masuk tetap bisa memanggil tool publik. Tool yang butuh akun menjawabnya dengan HTTP 401, yang memberi tahu klien yang mendukung masuk untuk memulainya. Key yang salah atau sudah dicabut mendapat hasil error yang memintamu memeriksa header.
| Tool | Butuh akun | Ditagih | Fungsi |
|---|---|---|---|
kenari_search_docs | Tidak | Tidak | Mencari di dokumentasi ini dan mengembalikan bagian yang paling relevan. |
kenari_list_models | Tidak | Tidak | Menampilkan model dengan harga terbaru dalam Rupiah per 1.000.000 token. |
kenari_model_get | Tidak | Tidak | Mengembalikan data katalog lengkap satu model, seperti yang ditampilkan GET /v1/models: harga, panjang konteks, modalitas, dan endpoint. |
kenari_model_changes | Tidak | Tidak | Menampilkan perubahan terbaru pada model: model baru dan yang dihapus, perubahan harga, dan jadwal pensiun, dari yang terbaru. Padanan HTTP-nya adalah Perubahan model. |
kenari_ask | Ya | Per token | Mengirim satu prompt ke model chat kenari dan mengembalikan jawabannya. |
kenari_balance | Ya | Tidak | Mengembalikan saldomu dalam Rupiah. Ditolak untuk key yang dibatasi. Padanan HTTP-nya adalah Saldo akun. |
kenari_usage | Ya | Tidak | Mengembalikan pemakaianmu selama 30 hari terakhir: request, token, dan biaya per model. Untuk key yang dibatasi, hanya mencakup key itu. Padanan HTTP-nya adalah Pemakaian. |
kenari_quota | Ya | Tidak | Mengembalikan kuota paket dan kuponmu. Ditolak untuk key yang dibatasi. Padanan HTTP-nya adalah Kuota akun. |
kenari_usage_daily | Ya | Tidak | Mengembalikan jumlah request dan biayamu per hari dalam satu rentang waktu, secara default 30 hari terakhir. Untuk key yang dibatasi, hanya mencakup key itu. Padanan HTTP-nya adalah GET /v1/usage/daily di Pemakaian. |
kenari_usage_log | Ya | Tidak | Menampilkan panggilanmu satu per satu, dari yang terbaru, per halaman: model, pembuatnya, cara panggilan itu dibayar, token, dan biayanya. Untuk key yang dibatasi, hanya mencakup key itu. Padanan HTTP-nya adalah GET /v1/usage/log di Pemakaian. |
kenari_workspace_members | Ya | Tidak | Menampilkan anggota workspace timmu beserta peran, kursi, dan batas PAYG mereka. Butuh key dengan akses workspace. Padanan HTTP-nya adalah GET /v1/workspace/members di API workspace. |
kenari_workspace_seats | Ya | Tidak | Menampilkan kursi workspace timmu dan siapa yang memegang tiap kursi. Butuh key dengan akses workspace. Padanan HTTP-nya adalah GET /v1/workspace/seats. |
kenari_workspace_invites | Ya | Tidak | Menampilkan undangan yang tertunda di workspace timmu. Butuh key dengan akses workspace yang dipegang Pemilik atau Admin. Padanan HTTP-nya adalah GET /v1/workspace/invites. |
kenari_web_search | Ya | Per panggilan | Mencari di web dan mengembalikan judul, URL, dan cuplikan. |
kenari_web_fetch | Ya | Per panggilan | Mengambil satu URL dan mengembalikan teksnya. |
kenari_x_search | Ya | Per panggilan | Mencari postingan terbaru di X dan mengembalikan jawaban singkat beserta sumbernya. |
kenari_ocr | Ya | Per halaman | Membaca PDF atau gambar dan mengembalikan teksnya. Padanan HTTP-nya adalah OCR. |
kenari_transcribe | Ya | Per detik | Mengubah audio atau suara dari video menjadi teks, biasa atau sebagai subtitle. Padanan HTTP-nya adalah Transkripsi. |
kenari_translate_audio | Ya | Per detik | Mengubah ucapan dalam bahasa apa pun menjadi teks bahasa Inggris, biasa atau sebagai subtitle. |
kenari_image_generate | Ya | Per gambar | Membuat 1 sampai 4 gambar dari prompt dan mengembalikan pratinjau serta link unduhan untuk tiap gambar. Padanan HTTP-nya adalah Gambar. |
kenari_image_edit | Ya | Per gambar | Mengedit atau menggabungkan 1 sampai 4 gambar dengan prompt. Padanan HTTP-nya adalah Gambar. |
kenari_speech | Ya | Per 1.000 karakter | Mengubah teks menjadi suara dan mengembalikan link unduhan. Padanan HTTP-nya adalah Text to speech. |
kenari_music | Ya | Per lagu | Membuat lagu dari prompt, lirik, atau keduanya, lalu mengembalikan link unduhan. Padanan HTTP-nya adalah Musik. |
kenari_video_generate | Ya | Per detik | Memulai video dan menunggunya hingga 2 menit. Padanan HTTP-nya adalah Video. |
kenari_video_extend | Ya | Per detik | Melanjutkan video yang sudah jadi dari frame terakhirnya. |
kenari_video_status | Ya | Tidak | Mengecek video dari id-nya, dan mengembalikan link unduhan baru saat video sudah jadi. |
kenari_embed | Ya | Per token | Mengubah hingga 64 teks menjadi vektor embedding. Padanan HTTP-nya adalah Embeddings. |
kenari_rerank | Ya | Per token | Mengurutkan hingga 100 dokumen berdasarkan seberapa baik tiap dokumen menjawab query, dengan skor untuk masing-masing. Padanan HTTP-nya adalah Rerank. |
kenari_systemone | Ya | Per token | Menjawab pertanyaan bertipe tentang sebuah state, atau mengambil field bertipe darinya, dengan model System One. Padanan HTTP-nya adalah System One. |
Tool pencarian melaporkan biaya yang dikenakan di akhir hasilnya. kenari_ask ditagih sesuai token yang dipakai, lihat Penagihan.
Setiap hasil dari tool yang menjalankan request API kenari, seperti kenari_ask, kenari_model_get, tool pencarian, dan setiap tool yang ditagih, membawa id request di _meta, di bawah kenari.id/request_id. Sertakan id itu saat menghubungi support.
Tiga tool kenari_workspace_* hanya membaca. Key-nya membutuhkan akses workspace Baca atau lebih tinggi, dan jawabannya JSON yang sama dengan route GET yang sesuai di API workspace. Key tanpa akses yang cukup, API key dibagikan, dan key terbatas mendapat hasil error dengan kode yang sama seperti route HTTP-nya, misalnya workspace_access_required. Perubahan hanya dilakukan lewat API workspace. Ketiga tool ini tidak berfungsi untuk klien yang terhubung lewat Masuk dari klien: key Koneksi MCP-nya mendapat hasil error yang menjelaskan hal itu. Pasang API key kenari yang dibuat dengan akses workspace di konfigurasi klien.
Argumen
Section titled “Argumen”| Tool | Argumen |
|---|---|
kenari_search_docs | query (string, wajib). |
kenari_list_models | search (string, opsional). Menyaring berdasarkan id model atau provider. |
kenari_model_get | model (string, wajib). Id model dari kenari_list_models. |
kenari_model_changes | since (integer, detik unix, opsional): hanya perubahan yang dikonfirmasi pada atau setelah waktu itu. limit (integer, 1 sampai 200, default 50). |
kenari_ask | model (string, wajib), prompt (string, wajib), system (string, opsional), dan max_tokens (integer, opsional, default 4.096, maksimal 32.768, dan nilai yang lebih besar diturunkan ke 32.768). |
kenari_web_search | query (string, wajib) dan max_results (integer, 1 sampai 10, default 5, dan nilai di luar rentang itu dipindah ke batas terdekat). |
kenari_web_fetch | url (string, wajib). |
kenari_x_search | query (string, wajib) dan x_search_filter (object, opsional). |
kenari_ocr | Satu input: url (string), data (string, base64), atau reuse_id (string). Dengan data, mime_type (string, opsional). |
kenari_transcribe | Satu input: url (string) atau data (string, base64). Dengan data, mime_type (string, opsional). model (string, opsional, model transkripsi termurah kalau dikosongkan), language (string, opsional), dan format (string, opsional: text (default), srt, vtt, atau verbose_json). |
kenari_translate_audio | Satu input: url (string) atau data (string, base64). Dengan data, mime_type (string, opsional). model (string, opsional: kalau dikosongkan, model transkripsi yang dipakai kenari Studio jika model itu bisa menerjemahkan, atau model termurah yang bisa) dan format (string, opsional: text (default), srt, vtt, atau verbose_json). Hasilnya selalu bahasa Inggris, jadi tool ini tidak menerima language. |
kenari_image_generate | prompt (string, wajib), model (string, opsional, model gambar yang dipakai kenari Studio kalau dikosongkan), size dan quality (string, opsional), n (integer, 1 sampai 4, default 1), dan preview (boolean, default true). |
kenari_image_edit | prompt (string, wajib) dan images (1 sampai 4 gambar, wajib), ditambah mask opsional. Tiap gambar adalah objek berisi satu url (link publik, atau link kenari dari hasil sebelumnya) atau data (base64) dengan mime_type opsional. model, size, quality, n, dan preview sama seperti di kenari_image_generate. |
kenari_speech | text (string, wajib, maksimal 4.000 karakter), model (string, opsional), voice (string, opsional), format (string, opsional: mp3 secara default, atau wav, pcm, opus, aac, atau flac kalau modelnya mendukung, dan wav serta pcm maksimal 2.000 karakter), speed (angka, 0,25 sampai 4, opsional), dan language (string, opsional). |
kenari_music | prompt dan lyrics (string, isi salah satu atau keduanya), instrumental (boolean, opsional), model (string, opsional), dan format (string, opsional: mp3 atau m4a). |
kenari_video_generate | prompt dan model (string, wajib), duration (integer, detik, opsional), aspect_ratio dan resolution (string, opsional), serta gambar image (frame pertama), end_image (frame terakhir), dan reference_images (maksimal 4), masing-masing objek berisi satu url atau data. |
kenari_video_extend | id dan model (string, wajib), prompt (string, opsional), dan duration (integer, detik, opsional). |
kenari_video_status | id (string, wajib). |
kenari_embed | model (string, wajib) dan input (array berisi 1 sampai 64 string, wajib). Vektor dari dua model tidak bisa dibandingkan, jadi model tidak punya default. |
kenari_rerank | query (string, wajib), documents (array berisi 1 sampai 100 string, masing-masing maksimal 8 KB dan 512 KB secara total, wajib), top_n (integer, opsional, default semua), dan model (string, opsional, model rerank termurah kalau dikosongkan). |
kenari_systemone | model (string, wajib), ditambah body POST /v1/systemone sebagai field: state, lalu questions atau fields, serta opsional assets, images, audio, videos, reference_date, dan options. kenari memeriksanya dengan cara yang sama seperti endpoint itu. |
kenari_usage_daily | range (string, opsional: today, 24h, 7d, atau 30d, default 30d), start dan end (integer, detik unix, opsional, dan keduanya mengalahkan range), dan model (string, opsional). |
kenari_usage_log | Sama seperti kenari_usage_daily, ditambah page (integer, mulai dari 0, default 0), limit (integer, 1 sampai 200, default 50), dan billing_kind (string, opsional: payg, plan, coupon, token_alloc, free, atau byok). |
kenari_balance, kenari_usage, kenari_quota, kenari_workspace_members, kenari_workspace_seats, kenari_workspace_invites | Tidak ada. |
x_search_filter memakai field yang sama dengan POST /v1/x/search. allowed_x_handles dan excluded_x_handles masing-masing berisi maksimal 20 handle tanpa @ dan tidak bisa dipakai bersamaan. from_date dan to_date berformat YYYY-MM-DD. enable_image_understanding dan enable_video_understanding membaca media di dalam postingan. Lihat Pencarian web & X untuk tabel lengkapnya.
File untuk OCR dan transkripsi
Section titled “File untuk OCR dan transkripsi”kenari_ocr, kenari_transcribe, dan kenari_translate_audio menerima file dengan salah satu dari dua cara. Kirim tepat satu.
url: tautan publikhttpatauhttpsyang diunduh kenari. Tautan itu harus menjawab200dengan file-nya sendiri, di port standar. kenari mengikuti hingga 3 pengalihan, jadi tautan berbagi dan unduhan tetap bisa dipakai. Tautan ke alamat jaringan privat, atau yang perlu login, ditolak. Maksimal 15 MiB untuk OCR dan 25 MiB untuk audio.data: file-nya sendiri dalam base64, maksimal 10 MiB. Cara ini cocok untuk skrip dan tool lokal yang sudah memegang file-nya. Model tidak bisa menulis file besar ke dalam panggilan tool, jadi untuk file yang tidak kecil, pakai tautan.
kenari memeriksa isi file, bukan hanya nama atau tipe yang disebutkan. Tautan yang menjawab halaman web, bukan PDF, ditolak sebelum ada yang dibaca atau ditagih. OCR menerima PDF, PNG, JPEG, WebP, GIF, dan TIFF. Transkripsi dan terjemahan menerima MP3, M4A, MP4, WAV, WebM, OGG, dan FLAC.
reuse_id dari hasil kenari_ocr sebelumnya membaca dokumen yang sama lagi tanpa biaya.
File yang dibuat kenari
Section titled “File yang dibuat kenari”Tool pembuatan konten menjawab dengan link unduhan di kenari.id. Link ini bisa dibuka tanpa key oleh siapa pun yang memilikinya sampai kedaluwarsa, jadi bagikan hanya ke tempat yang kamu maksud.
- Gambar, suara, dan lagu disimpan selama 24 jam.
- Link video berlaku 6 jam.
kenari_video_statusmemberi link baru selama videonya masih ada, sekitar 6 jam setelah selesai. Unduh yang ingin kamu simpan. kenari_image_generatedankenari_image_editjuga menampilkan pratinjau JPEG kecil untuk tiap gambar di hasilnya, supaya model bisa melihat hasilnya. Isipreviewdenganfalseuntuk menghilangkannya.- kenari menyimpan file terbaru hingga 1 GiB per akun. Lewat dari itu, link paling lama berhenti berfungsi lebih awal.
- Link kenari dari hasil sebelumnya bisa menjadi input
kenari_image_editatau tool video. Link itu harus berasal dari akunmu sendiri. kenari_embedmenampilkan vektornya di hasil kalau muat dalam 60.000 karakter. Jawaban yang lebih besar disimpan sebagai file JSON selama 24 jam, dan hasilnya memberi link-nya, jumlah vektor, dan dimensinya.
Penagihan
Section titled “Penagihan”Tiga tool pencarian ditagih per panggilan dari akunmu, sama seperti endpoint di Pencarian web & X. Pencarian web dan pengambilan halaman berbagi satu jatah harian paket, dan kenari_x_search ditagih dari saldo saja.
kenari_ask ditagih persis seperti request yang sama ke Chat completions: sesuai harga per token model, dari paket, kupon, atau saldomu dengan aturan yang sama. Jawabannya berhenti di max_tokens, 4.096 token kecuali kamu meminta lebih, jadi satu panggilan tidak lebih mahal dari yang kamu izinkan.
kenari_ocr ditagih per halaman yang dibaca, dari saldo saja, dan kenari_transcribe serta kenari_translate_audio per detik audio sesuai harga model, sama persis seperti OCR dan Transkripsi. File yang ditolak tidak ditagih.
Tool pembuatan konten ditagih persis seperti request yang sama ke Gambar, Text to speech, Musik, dan Video: per gambar, per 1.000 karakter, per lagu, dan per detik video. Video ditagih saat dimulai dan dikembalikan kalau gagal. Setiap hasil menyebutkan biayanya. Maksimal 2 panggilan gambar, suara, atau musik berjalan bersamaan per akun.
kenari_embed, kenari_rerank, dan kenari_systemone ditagih per token input, sama persis seperti Embeddings, Rerank, dan System One. Setiap hasil menyebutkan biayanya. kenari_usage_daily, kenari_usage_log, dan kenari_model_changes gratis.
Panggilan yang gagal tidak ditagih. Lihat Cara penagihan.
Daftar tool untuk klien
Section titled “Daftar tool untuk klien”GET https://kenari.id/v1/tools mengembalikan tool yang sama tanpa key: skema input setiap tool, anotasi MCP-nya, dan cara penagihannya (free, per_call, per_token, per_page, per_second, per_image, atau per_1k_chars). Klien bisa membacanya untuk membuat perintahnya sendiri. Lihat Dokumentasi untuk agen AI untuk spesifikasi OpenAPI.
API key dibagikan
Section titled “API key dibagikan”API key dibagikan tidak bisa mengakses informasi saldo, pemakaian, dan kuota pemilik. kenari_balance, kenari_usage, kenari_usage_daily, kenari_usage_log, dan kenari_quota ditolak untuk API key dibagikan, karena kelimanya akan membuka data tersebut. Tool pencarian dan kenari_ask tetap berfungsi dengan API key dibagikan, sesuai yang diizinkan pembagiannya. kenari_ask mengikuti pembatasan model dan batas key itu, sama seperti endpoint chat. Pakai key dari akunmu sendiri untuk melihat angka-angka itu.
Key yang dibatasi, yaitu key dengan pembatasan model, batas biaya, atau batas token, ditolak oleh kenari_balance dan kenari_quota. kenari_usage, kenari_usage_daily, dan kenari_usage_log tetap berfungsi, tetapi hanya menampilkan pemakaian key itu sendiri. Lihat Ringkasan akun.