自定义 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 支付。