自定義 MCP

通過 URL、自定義配置或 JSON 導入，連接你信任的 MCP 服務器。

自定義 MCP 將 Minara 連接到你信任的遠程工具服務器。預檢通過後，該服務器的工具會加入目錄。工具默認保持禁用狀態，等待你審查並啟用。

打開 Connectors → Add connectors → Add MCP server。

通過 URL 添加

Add by URL 適用於 HTTPS Streamable HTTP 或 SSE 服務器。需填寫：

服務器名稱
服務器 URL
可選備註
可選 OAuth client ID
可選 OAuth client secret

OAuth 字段支持三種模式：

輸入	授權模式
無 client ID	通過 CIMD 或 DCR 進行 OAuth 發現，配合 PKCE
僅 client ID	使用 Authorization Code 和 PKCE 的公開客戶端
client ID 和 secret	通過網關進行 code exchange 的機密客戶端

提供 client secret 但不填 client ID 為無效配置。secret 為只寫字段，網關將其加密存入憑證存儲，Minara 不會通過 API、診斷、導出或日誌返回該值。

自定義配置

Custom configuration 適用於需要自定義圖標、備註和非敏感公開請求頭的 HTTP 或 SSE 端點。該表單會拒絕 authorization、Bearer、API key、password 及 secret 等請求頭。若服務器需要 OAuth client secret，請使用 Add by URL。

導入 JSON 或 JSONC

導入器接受 mcpServers 和 servers 兩種映射格式。保存前會預覽所有條目。名稱重複時默認選擇 Skip；若要替換，請選擇 Replace。

遠程條目支持 HTTPS HTTP 或 SSE 傳輸協議。導入器識別使用 npx、pnpm dlx 或 uvx 配合註冊表包的受限 stdio 定義。當前版本在網關未配置受支持的隔離運行器時，保持 stdio 執行禁用。jail 不可用時，預檢以關閉狀態失敗。

JSON 導入會拒絕嵌入的 secret、授權值、Bearer token、API key 及密碼。如需添加機密 OAuth 客戶端，請通過 Add by URL 操作。

預檢與工具審查

保存前，Minara 將依次執行：

規範化配置。
校驗傳輸協議及網絡目標。
在需要時發現 OAuth 元數據。
初始化 MCP 會話並請求 tools/list。
展示每個工具的 schema 及風險說明。
確認後方可保存配置。

若任一步驟失敗，Minara 將回滾新配置及其憑證引用。

工具默認關閉，啟用後使用 Ask every time 策略。schema 發生變更時，受影響的寫工具會暫停，等待你審查新 schema。自定義 MCP 工具不能直接發起任意資金操作；x402 費用由獨立支付門控處理，必須逐筆確認或符合預授權。Autopilot、機構分析師及子 Agent 也無法調用自定義 MCP 工具。

網絡限制

遠程 MCP URL 必須使用 HTTPS。Minara 會屏蔽以下目標：URL 內嵌憑證、query 中的 token、迴環地址、私有地址、鏈路本地地址及雲元數據地址。OAuth 的 issuer、authorization、registration、token 及 redirect 端點會分別獨立校驗。連接期間如發生 DNS 變更，將重新檢查。

自定義 MCP 僅支持 MCP 協議。工具缺失或運行時失敗會返回明確的錯誤信息，Minara 不會將自定義操作路由至 REST 接口。

使用 x402 的付費 MCP

MCP 伺服器可以在 MCP JSON-RPC 錯誤中返回 x402 挑戰；直連遠程 HTTP 或 SSE 工具也可以返回 402 Payment Required。服務提供受支持的 x402 exact USDC 挑戰時，Minara 會把挑戰綁定到原 MCP 請求，展示商戶、金額、資產和網絡，使用託管錢包建立證明，並只重試一次相同請求。

付費伺服器的安裝方式與其他 MCP 相同。不要把錢包私鑰、支付簽名或交易證明寫入 URL、請求頭、JSON 配置或 OAuth 字段。MCP JSON-RPC 形式適用於包括本機 stdio 在內的 MCP transport；HTTP header 支付僅適用於直連遠程連接，託管 Broker 必須原樣轉發 PAYMENT-REQUIRED、PAYMENT-SIGNATURE 和 PAYMENT-RESPONSE。參閱 x402 支付。