# MCP 指令

以 `kura remote` 開關 daemon 的 HTTP MCP endpoint，並以 `kura mcp` 透過 stdio 提供 MCP。

## 控制 HTTP MCP endpoint

```bash
kura remote enable
kura remote disable
```

兩者都會把 `remote` 旗標寫進 `config.json`，並印出 `remote MCP enabled (/mcp)` 或 `remote MCP disabled`。旗標為 true 時才掛載 `/mcp`，因此未設定的 daemon 在該路徑回 404，而 `/api/*` 照常運作。

Route 在啟動時決定，所以有 daemon 在跑時兩個指令都會重啟它；沒有 daemon 時只寫入設定。缺少或無法辨識的參數會印出用法並以狀態碼 2 結束。

## 以 stdio 提供 MCP

```bash
kura mcp
```

此命令在自己的 process 內開啟已註冊的資料庫、從 SQLite 重建 vector cache，並在 stdin 與 stdout 上進行 JSON-RPC。它設計為由 MCP client spawn，而非手動執行；診斷訊息走 stderr，不會污染協定串流。關閉 stdin 或送出 `SIGINT`／`SIGTERM` 時 session 結束，狀態碼為 0。

它不需要 daemon 在跑，不註冊 query cache 寫入 hook，也不啟動 watcher 或 embedding loop。由於 semantic query 需即時 embedding，仍需要 OpenAI API key。Client 設定見 [連接 client](/zh/mcp-server-connect)，tool 契約見 [MCP Tools](/zh/mcp-server-tools)。