MCP untuk agent

Setelah mengikuti panduan ini, agent kamu akan memiliki konfigurasi untuk membaca workspace Kanesh lewat MCP. Setiap workspace punya endpoint sendiri, dan agent hanya bisa melihat data yang boleh dilihat pemilik token.

Note: Kanesh tidak menjalankan, meng-host, atau menagih model AI apa pun dan tidak butuh API key AI. Codex dan Claude Code memakai langganan atau akun yang sudah kamu punya; Kanesh hanya menyajikan datamu ke mereka lewat MCP.

Sebelum mulai

Selesaikan panduan Memulai dan siapkan workspace.
Gunakan akun yang punya izin baca untuk koleksi yang ingin diakses agent.
Pastikan kamu bisa mengatur variabel environment untuk Kanesh dan agent.

Note: Tool MCP hanya bisa membaca data. Untuk membuat koleksi atau record, gunakan REST API meskipun pemilik token punya izin tulis.

1. Aktifkan MCP

Atur variabel environment ini saat menjalankan Kanesh:

MCP_ENABLED=true

Lalu buka Pengaturan → AI & MCP di Studio. Di sana ada URL endpoint dan contoh konfigurasi untuk Codex dan Claude Code.

2. Buat token pribadi

Di Akun → Token API, buat token pribadi. Secret hanya ditampilkan sekali dan disimpan dalam bentuk hash. Ekspor untuk agent kamu:

export KANESH_TOKEN=...

Note: Ganti ... dengan secret token. Jaga kerahasiaannya; Studio hanya menampilkannya sekali.

3. Hubungkan Codex

Ganti WORKSPACE_ID dengan ID workspace kamu, sesuai endpoint di Pengaturan → AI & MCP. Atur Codex agar memakai KANESH_TOKEN yang sudah diekspor:

[mcp_servers.kanesh]
url = "http://127.0.0.1:8080/api/v1/workspaces/WORKSPACE_ID/mcp"
bearer_token_env_var = "KANESH_TOKEN"

4. Baca data workspace

Gunakan tool berikut untuk memeriksa skema dan membaca record:

Tool	Yang dikembalikan
`get_workspace_schema`	Koleksi dan field yang boleh dibaca token
`get_schema_model`	Lookup tersimpan dan index terkelola
`list_records`	Satu halaman record terbatas, dengan filter dan urutan

Agent yang perlu membuat koleksi atau record bisa memakai REST API dengan token yang sama; ekspor OpenAPI menjelaskan setiap endpoint.

Pemecahan masalah

MCP tidak tersedia: pastikan Kanesh dijalankan dengan MCP_ENABLED=true dan gunakan endpoint untuk workspace yang dituju.
Autentikasi gagal: pastikan KANESH_TOKEN berisi token pribadi yang belum kedaluwarsa atau dicabut. Kirim hanya satu sumber kredensial; kredensial ganda atau cookie bersama token menghasilkan 401. Token lewat parameter query tidak diterima.
Koleksi yang dicari tidak muncul: periksa akses efektif pemilik token di workspace tersebut. MCP memakai izin yang sama dengan Studio, REST, dan GraphQL.
Agent tidak bisa menulis record: tool MCP hanya bisa membaca. Gunakan REST API dengan akun yang punya izin tulis yang sesuai.