Server MCP AI Drive

Mencari dan membaca dokumen Drive Keural dari klien MCP eksternal seperti Claude Desktop.

Keural juga menyediakan Drive sebagai server MCP. Saat klien MCP eksternal terhubung, pengguna yang memegang kunci dapat mencari dan membaca dokumen Drive per halaman sesuai hak akses pengguna tersebut. Plugin menghubungkan sistem eksternal ke Keural, sedangkan server ini menghubungkan dokumen Keural ke AI eksternal.

Server ini diautentikasi dengan kunci API organisasi. Kunci API organisasi diterbitkan oleh tim operasional Keural, jadi mintalah kepada penanggung jawab penerapan. Kunci bekerja dengan hak akses satu pengguna yang menerimanya dan harus memiliki izin drive:read. Jika kunci dicabut, koneksi yang sudah ada juga diblokir dalam waktu 1 menit.

Informasi koneksi

Item	Nilai
Metode transport	MCP Streamable HTTP
Alamat	`https://<agent server domain for each environment>/core/v1/mcp-drive`
Autentikasi	`Authorization: Bearer <organization API key>` (semua permintaan)

Cara permintaan

Metode	Kegunaan
`POST`	Satu permintaan JSON-RPC. Respons selalu berupa satu `application/json`. Notifikasi (`notifications/*`) mengembalikan `202` tanpa isi.
`GET`	Aliran event server. Membutuhkan `Accept: text/event-stream` dan `Mcp-Session-Id`. Mengirim keepalive setiap 15 detik dan melanjutkan penerimaan dengan `Last-Event-ID`.
`DELETE`	Mengakhiri sesi. Membutuhkan `Mcp-Session-Id` dan mengembalikan `204`.

Jika initialize berhasil, ID sesi dikembalikan melalui header respons Mcp-Session-Id. Sesi bersifat opsional, jadi Anda boleh hanya mengirim POST tanpa sesi. Sesi bertahan 1 jam setelah permintaan terakhir dan terikat pada kunci yang membuatnya.
Header MCP-Protocol-Version bersifat opsional. Jika dikirim, nilainya harus 2025-06-18.
Informasi server adalah keural-ai-drive, dan fitur yang disediakan hanya tools.

Galat HTTP

Galat pada tahap HTTP tidak memakai format JSON-RPC, jadi periksa dengan kode status.

Status	Penyebab
`401`	Kunci tidak ada atau salah, kunci dicabut atau sudah kedaluwarsa
`403`	Kunci tidak memiliki izin `drive:read`
`400`	`MCP-Protocol-Version` tidak didukung, parsing JSON gagal (`-32700`), `GET` atau `DELETE` tanpa ID sesi
`404`	ID sesi tidak dikenal atau sudah kedaluwarsa
`405`	`GET` tanpa `Accept: text/event-stream`

Galat pada tahap JSON-RPC dikembalikan dengan 200 dalam bentuk error. Metode atau alat yang tidak dikenal menghasilkan -32601, dan format permintaan yang salah menghasilkan -32600.

Alat

Alat	Input	Keterangan
`list_files`	Tidak ada	Daftar dokumen yang dapat dilihat (nama, id, tanggal unggah, tanggal ubah, dan pengunggah jika diunggah orang lain). Dokumen Drive dan file lampiran chat dikembalikan bersamaan, dibedakan dengan `origin`. Maksimal 500 item. Jika melebihi, `truncated: true` ditambahkan
`search_drive`	`query`	Mencari isi dokumen secara semantik dan mengembalikan kutipan yang relevan beserta informasi sumbernya
`read_document_page`	`file_id`, `page`	Membaca seluruh isi halaman tertentu dari dokumen. `file_id` diambil dari hasil dua alat di atas, dan `page` dihitung mulai dari 1

Hasil alat dimuat sebagai string JSON di content[0].text.

Alat	JSON di dalam `text`
`list_files`	`{"files":[{"name","id","created_date","modified_date","owner_name","origin"}], "truncated": false}`. Tanggal dalam format `yyyy-MM-dd HH:mm`
`search_drive`	`{"sources":[{"id","name","url","contents":[…]}]}`
`read_document_page`	`{"file_id","page","rows":[…]}`

Jika eksekusi alat gagal, server mengembalikan isError: true dan {"error": "…"} (bukan galat JSON-RPC). Dokumen yang tidak dapat diakses atau tidak ada selalu dikembalikan dengan file not found or not accessible.

Contoh pengaturan klien

Daftarkan alamat dan header pada klien yang mendukung server MCP jarak jauh. Format pengaturan berbeda di setiap klien, jadi ikuti cara menambahkan server MCP jarak jauh pada klien yang Anda gunakan.

{
  "mcpServers": {
    "keural-drive": {
      "type": "http",
      "url": "https://<domain server agen per lingkungan>/core/v1/mcp-drive",
      "headers": { "Authorization": "Bearer <kunci API organisasi>" }
    }
  }
}

Versi protokol MCP yang didukung adalah 2025-06-18.

Server MCP AI Drive

Informasi koneksiSalin tautan judul

Cara permintaanSalin tautan judul

Galat HTTPSalin tautan judul

AlatSalin tautan judul

Contoh pengaturan klienSalin tautan judul

Di halaman ini

Informasi koneksi

Cara permintaan

Galat HTTP

Alat

Contoh pengaturan klien