Server MCP

kenari menjalankan server Model Context Protocol yang memberi agen dokumentasi kenari, daftar model terbaru, saldo, pemakaian, dan kuota akunmu, serta pencarian web, pengambilan halaman, dan pencarian X. Hubungkan ke Claude Code, Cursor, atau klien MCP lain, dan agen bisa mencari informasi dan mengecek saldomu 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 dan menerima satu response JSON. Tidak ada stream yang dimulai dari server, jadi GET /mcp mengembalikan 405.

Hubungkan klien

Dua tool dokumentasi tidak butuh key. Tambahkan key untuk memakai sisanya. Buat key di API Keys di dashboard. Lihat Autentikasi & API key.

Claude Code

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. Hilangkan --header kalau kamu hanya ingin memakai tool publik.

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

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 dan header Authorization: Bearer $KENARI_API_KEY di pengaturan klien itu sendiri.

Kirim 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 yang valid tetap bisa memanggil tool publik. Tool yang butuh key mengembalikan error yang meminta kamu mengatur header.

Tool

Tool	Butuh key	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_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_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.

Tool yang ditagih melaporkan biaya yang dikenakan di akhir hasilnya.

Argumen

Tool	Argumen
`kenari_search_docs`	`query` (string, wajib).
`kenari_list_models`	`search` (string, opsional). Menyaring berdasarkan id model atau provider.
`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_balance`, `kenari_usage`, `kenari_quota`	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.

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. Panggilan yang gagal tidak ditagih. Lihat Cara penagihan.

API key dibagikan

API key dibagikan tidak bisa mengakses informasi saldo, pemakaian, dan kuota pemilik. kenari_balance, kenari_usage, dan kenari_quota ditolak untuk API key dibagikan, karena ketiganya akan membuka data tersebut. Tool pencarian tetap berfungsi dengan API key dibagikan, sesuai yang diizinkan pembagiannya. 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 tetap berfungsi, tetapi hanya menampilkan pemakaian key itu sendiri. Lihat Ringkasan akun.