Pelayan MCP AI Drive

Cari dan baca dokumen Drive Keural daripada klien MCP luaran seperti Claude Desktop.

Drive Keural turut disediakan sebagai pelayan MCP. Apabila klien MCP luaran menyambung ke pelayan ini, pengguna yang memegang kunci boleh mencari dan membaca dokumen Drive mengikut halaman, dalam skop yang boleh dilihat oleh pengguna tersebut. Pemalam menyambungkan sistem luaran ke Keural, manakala pelayan ini menyambungkan dokumen Keural ke AI luaran.

Pelayan ini disahkan dengan kunci API organisasi. Kunci dikeluarkan oleh pasukan operasi Keural, jadi mintalah daripada pegawai pelaksanaan anda. Kunci beroperasi di bawah kebenaran seorang pengguna yang menerimanya dan mesti mempunyai kebenaran drive:read. Jika kunci dibatalkan, sambungan sedia ada disekat dalam masa 1 minit.

Maklumat sambungan

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

Cara permintaan

Kaedah	Kegunaan
`POST`	Satu permintaan JSON-RPC. Respons sentiasa satu `application/json`. Pemberitahuan (`notifications/*`) memulangkan `202` tanpa badan.
`GET`	Strim acara pelayan. Memerlukan `Accept: text/event-stream` dan `Mcp-Session-Id`. Menghantar keepalive setiap 15 saat dan menyambung semula dengan `Last-Event-ID`.
`DELETE`	Menamatkan sesi. Memerlukan `Mcp-Session-Id` dan memulangkan `204`.

Apabila initialize berjaya, ID sesi diberikan dalam pengepala respons Mcp-Session-Id. Sesi bersifat pilihan, jadi anda boleh hanya menghantar POST tanpa sesi. Sesi kekal selama 1 jam selepas permintaan terakhir dan terikat kepada kunci yang mencipta sesi tersebut.
Pengepala MCP-Protocol-Version bersifat pilihan. Jika dihantar, nilainya mesti 2025-06-18.
Maklumat pelayan ialah keural-ai-drive, dan fungsi yang disediakan hanyalah tools.

Ralat HTTP

Ralat peringkat HTTP tidak menggunakan format JSON-RPC, jadi semak kod status.

Status	Punca
`401`	Kunci tiada atau salah, kunci dibatalkan atau tamat tempoh
`403`	Kunci tidak mempunyai kebenaran `drive:read`
`400`	`MCP-Protocol-Version` tidak disokong, parsing JSON gagal (`-32700`), `GET` atau `DELETE` tanpa ID sesi
`404`	ID sesi tidak dikenali atau tamat tempoh
`405`	`GET` tanpa `Accept: text/event-stream`

Ralat peringkat JSON-RPC dikembalikan dengan 200 sebagai error. Kaedah atau alat yang tidak dikenali memberi -32601, dan format permintaan yang salah memberi -32600.

Alat

Alat	Input	Penerangan
`list_files`	Tiada	Senarai dokumen yang boleh dilihat (nama, id, tarikh muat naik, tarikh ubah suai, dan pemuat naik jika bukan anda). Dokumen Drive dan fail sembang dikembalikan bersama dan dibezakan dengan `origin`. Maksimum 500 item. Jika melebihi had, `truncated: true` ditambah
`search_drive`	`query`	Mencari kandungan dokumen secara semantik dan memulangkan petikan berkaitan beserta maklumat rujukan
`read_document_page`	`file_id`, `page`	Membaca keseluruhan teks halaman tertentu dalam dokumen. `file_id` diambil daripada hasil dua alat di atas, dan `page` dikira bermula dari 1

Hasil alat dimuatkan sebagai rentetan JSON dalam content[0].text.

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

Jika pelaksanaan alat gagal, hasil berupa isError: true bersama {"error": "…"}, bukan ralat JSON-RPC. Dokumen yang tidak boleh dilihat atau tidak wujud semuanya dijawab dengan file not found or not accessible.

Contoh tetapan klien

Daftarkan alamat dan pengepala dalam klien yang menyokong pelayan MCP jauh. Contoh di bawah hanya format. Format tetapan berbeza bagi setiap klien, jadi ikuti cara menambah pelayan MCP jauh bagi klien anda.

{
  "mcpServers": {
    "keural-drive": {
      "type": "http",
      "url": "https://<domain pelayan ejen mengikut persekitaran>/core/v1/mcp-drive",
      "headers": { "Authorization": "Bearer <kunci API organisasi>" }
    }
  }
}

Versi protokol MCP yang disokong ialah 2025-06-18.

Pelayan MCP AI Drive

Maklumat sambunganSalin pautan tajuk

Cara permintaanSalin pautan tajuk

Ralat HTTPSalin pautan tajuk

AlatSalin pautan tajuk

Contoh tetapan klienSalin pautan tajuk

Pada halaman ini

Maklumat sambungan

Cara permintaan

Ralat HTTP

Alat

Contoh tetapan klien