接上你自己的 MCP 伺服器

agent 平常依據你寫在 Context 的內容回答。當答案在即時系統裡——CRM、庫存服務、資料庫——你可以改指向你自己運行的 MCP 伺服器。agent 在有人提問時呼叫那個伺服器,使用它傳回的內容,然後繼續。你的源系統留在你的網路裡;工具請求與回應會為那則對話跨進我們的託管服務。

依你運行 kavilo 的方式,有兩種做法:

託管 Enterprise 方案——在控制台設定 context provider。當訪客的已簽署權杖帶有 context key 時,agent 在回覆前呼叫一個 MCP 工具,讓你的伺服器傳回針對該訪客的資料。沒有那個 key 的訪客跳過這次呼叫。
自行託管——在你的 config.json 的 tools.mcpServers 中加入一個或多個 MCP 伺服器。它們會變成 agent 在推理期間可以呼叫的工具,與原生工具的工作方式相同。

在控制台,打開你的機器人設定,捲到 MCP context provider。你要設定四樣東西:

Endpoint URL——你的 MCP 伺服器的 HTTP 或 HTTPS 位址。必須從我們的雲端可達。本機位址或私有 IP 行不通;開發期間改用公開主機名稱或隧道(Cloudflare Tunnel、Tailscale Funnel、ngrok)。
Tool name——要呼叫的 MCP 工具名稱。這是你的伺服器公開的工具;名稱由你決定。
Header carrying the visitor key(選填)——用來把你的後端簽發的訪客權杖中的不透明 context key 轉發給伺服器的標頭名稱。預設是 X-Context-Key。只有當權杖包含 key 時,工具才會被呼叫;用公開金鑰的訪客跳過這次呼叫。
Auth header and credential(選填)——一個標頭加一個靜態值,讓你的伺服器認出是 kavilo 在呼叫,例如 X-API-Key 加一個你簽發的 secret。與 context key 是分開的:驗證憑證識別呼叫方,context key 識別訪客。憑證是唯寫的——你設定,我們永不傳回。

儲存後,用 Test connection 確認 agent 連得到你的伺服器並呼叫工具。測試會列出你的伺服器公開的工具;如果指定名稱的工具不在清單中,機器人在執行時就用不到它。

執行時,帶著 context key 的訪客會在回覆前觸發工具。它傳回的內容會注入 agent 該回合的 context。如果呼叫逾時(預設五秒)或回傳錯誤,agent 會照常回答,而不是拒絕——把你的工具設計成快速回傳、優雅降級。

工具的原始回應不會加進機器人永久的 Context,但來自其中的事實可能出現在回覆裡,因此也會出現在儲存的對話與逐字稿中。

在 config.json 中,把每個伺服器加到 tools.mcpServers 之下。這個 key 是別名;agent 會看到命名為 mcp_<alias>_<tool> 的工具。

一個 HTTP 伺服器:

"tools": { "mcpServers": { "inventory": { "url": "https://internal.example.com/mcp", "enabled": true } } }

一個本機行程(stdio):

"tools": { "mcpServers": { "crm": { "command": "npx", "args": ["-y", "@example/crm-mcp"], "env": { "CRM_API_KEY": "sk_…" }, "enabled": true } } }

agent 在推理期間會主動呼叫這些工具,與它呼叫內建工具的方式相同。你也可以設定 enabledTools,限制某個伺服器公開哪些工具。

對 config.json 的變更在下次 kavilo start 時生效。kavilo mcp 命令可以幫你管理伺服器項目,不必手動編輯檔案。

在託管 Enterprise 方案下,對話、MCP 請求和工具回應都在我們的雲端處理。你的底層系統留在你的網路裡,但請求、可選的已簽署訪客權杖,以及傳回的列或物件會跨越界線。如果這不可接受,就自行託管 agent 並使用本機推理,讓對話和工具資料都不離開。

MCP context 在 Enterprise 方案提供;較低的方案會隱藏這些設定。想先討論資料界線再選部署,就升級,或與我們談談。