AI Drive MCP 伺服器

在 Claude Desktop 等外部 MCP 用戶端中搜尋並讀取 Keural 雲端硬碟文件。

Keural 雲端硬碟以 MCP 伺服器的形式提供。外部 MCP 用戶端連線後，持有金鑰的使用者可以搜尋其有權查看的雲端硬碟文件，並以頁為單位讀取。外掛程式是將外部系統連接到 Keural，此伺服器則是將 Keural 文件連接到外部 AI。

驗證使用組織 API 金鑰。組織 API 金鑰由 Keural 營運方發行，請向導入負責人申請。金鑰以取得金鑰的使用者一人的權限運作，且需要 drive:read 權限。回收金鑰後，既有的連線也會在 1 分鐘內被阻擋。

連線資訊

項目	值
傳輸方式	MCP Streamable HTTP
位址	`https://<各環境的代理程式伺服器網域>/core/v1/mcp-drive`
驗證	`Authorization: Bearer <組織 API 金鑰>`（每個請求皆需）

請求方式

方法	用途
`POST`	一則 JSON-RPC 請求。回應一律為一個 `application/json`。通知（`notifications/*`）不含內文，會回傳 `202`。
`GET`	伺服器事件串流。需要 `Accept: text/event-stream` 與 `Mcp-Session-Id`。每 15 秒傳送一次 keepalive，並可透過 `Last-Event-ID` 接續接收。
`DELETE`	結束工作階段。需要 `Mcp-Session-Id`，會回傳 `204`。

initialize 成功後，會以回應標頭 Mcp-Session-Id 回傳工作階段 ID。工作階段為選用，不使用工作階段、只送出 POST 也可以。工作階段在最後一次請求後保留 1 小時，並綁定到建立它的金鑰。
MCP-Protocol-Version 標頭為選用，若傳送，其值必須為 2025-06-18。
伺服器資訊為 keural-ai-drive，提供的功能只有 tools。

HTTP 錯誤

HTTP 階段的錯誤不是 JSON-RPC 格式，因此請以狀態碼確認。

狀態	原因
`401`	金鑰不存在或不正確，或金鑰已回收、已過期
`403`	金鑰沒有 `drive:read` 權限
`400`	不支援的 `MCP-Protocol-Version`、JSON 解析失敗（`-32700`），或 `GET`·`DELETE` 沒有工作階段 ID
`404`	未知或已過期的工作階段 ID
`405`	`GET` 沒有 `Accept: text/event-stream`

JSON-RPC 階段的錯誤會以 200 搭配 error 回傳。未知的方法或工具回傳 -32601，請求格式錯誤回傳 -32600。

工具

工具	輸入	說明
`list_files`	無	可查看的文件清單（名稱、id、上傳日期、修改日期，若為他人上傳則顯示上傳者）。雲端硬碟文件與對話中附加的檔案會一併回傳，並以 `origin` 區分。最多 500 筆，超過時會加上 `truncated: true`
`search_drive`	`query`	以語意搜尋文件內容，回傳相關段落與引用資訊
`read_document_page`	`file_id`、`page`	讀取文件特定頁的全文。`file_id` 取自上述兩個工具的結果，`page` 從 1 開始計算

工具結果以 JSON 字串的形式放在 content[0].text 中。

工具	`text` 中的 JSON
`list_files`	`{"files":[{"name","id","created_date","modified_date","owner_name","origin"}], "truncated": false}`。日期格式為 `yyyy-MM-dd HH:mm`
`search_drive`	`{"sources":[{"id","name","url","contents":[…]}]}`
`read_document_page`	`{"file_id","page","rows":[…]}`

工具執行失敗時，會回傳 isError: true 與 {"error": "…"}（非 JSON-RPC 錯誤）。無權查看或不存在的文件，一律回傳 file not found or not accessible。

用戶端設定範例

在支援遠端 MCP 伺服器的用戶端中登錄位址與標頭。設定格式因用戶端而異，請依該用戶端新增遠端 MCP 伺服器的方式進行設定。

{
  "mcpServers": {
    "keural-drive": {
      "type": "http",
      "url": "https://<各環境的代理程式伺服器網域>/core/v1/mcp-drive",
      "headers": { "Authorization": "Bearer <組織 API 金鑰>" }
    }
  }
}

支援的 MCP 通訊協定版本為 2025-06-18。

AI Drive MCP 伺服器

連線資訊複製錨點連結

請求方式複製錨點連結

HTTP 錯誤複製錨點連結

工具複製錨點連結

用戶端設定範例複製錨點連結

本頁內容

連線資訊

請求方式

HTTP 錯誤

工具

用戶端設定範例