整合設定

邱敬幃 Pardn Chiu · 最後更新 2026-10-01

MCP 設定

單一檔案：~/.config/agenvoy/mcp.json。Session 範圍的層級已移除。以 TUI /mcp、web 儀表板或 /v1/mcp* 端點管理 server。完整 schema 與 ${VAR} 展開行為見 MCP 客戶端頁。

供應商設定

已無靜態供應商目錄——新增模型時由各供應商 API，或本機端點的 GET /models，取得模型清單。已註冊模型存於 config.json 的 models（順序即 fallback 優先序）、tier 存於 model_tag、自訂端點 URL 存於 compats；憑證絕不存於此，而是存於 OS keychain 的 agenvoy 服務下。寫入 config.json 會重新載入 agent registry，不需重啟。claude-code provider（v1.1.0 起）不存任何憑證 —— 它執行本機的 claude CLI —— 且僅在以 agen --enable-claude-code 啟動 Agenvoy 時啟用（daemon 須先停止）。

Compat provider URL 儲存拆分

compat provider URL 採 two-storage 模型：

URL 慣例遵循 Zed：輸入至 /v1 為止的 URL（例如 http://host:8000/v1），router 自行附加 /chat/completions。本機 Ollama（http://localhost:11434/v1）與 llama.cpp（http://localhost:8080/v1）經 configs/jsons/local_compat.json 內建，不需 compats 條目。URL 由 config 讀取，非 keychain。不存在 COMPAT_<NAME>_URL keychain key（刻意移除：一個歷史 bug 曾讓 TUI 寫入 config 而 runtime 讀 keychain，導致總是 fallback 到 localhost）。

KuraDB

已無 kuradb_enabled 旗標，也沒有 /v1/kuradb 端點。KuraDB 以一般 MCP server 形式註冊——在 mcp.json 加一筆條目——因此其工具以 mcp__kura__* 出現，取消註冊或斷線時完全消失。TUI /kuradb 精靈已於 v0.35.0 移除：請自行執行 kuradb.sh（需真實 TTY 處理 sudo），再透過 /mcp 註冊。完整說明見 KuraDB 與 RAG 頁。