MCP 配置

一句话总结：MCP（Model Context Protocol）让 Agent 通过统一协议调用外部工具；MCP Server 由 Claw 直接管理，会话发起时按需挂载。

什么时候用 MCP

给 Agent 接数据库、内部 API、文件系统索引、监控系统。
复用开源 MCP（如 GitHub MCP、Slack MCP）。
同一 Claw 上跑多个 MCP Server，按会话挑用。

在 Claw 上新增一个 MCP Server

Claw 管理页 → 当前主机 → MCP → 添加。
填 serverKey（唯一）、name、defaultConfig（含 transport / command / args / env 等）。
保存后系统会即时验证连接。
在新会话「MCP 选择」中勾选要挂载的 Server。

Transport 与 defaultConfig 字段

支持的 transport：

stdio：本地进程通过 stdin/stdout 通信（最常见）。
sse：Server-Sent Events。
http：标准 HTTP。

JSON 格式示例（stdio）：

json
{
  "transport": "stdio",
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-postgres"],
  "env": {
    "PG_URL": "postgres://user:pwd@localhost/db"
  }
}

另有 manageDoc：一段 Markdown 文本，作为该 MCP 的运维说明，仅展示给配置者。

在会话里挂载 MCP

新建会话时，输入区有「MCP picker」，勾选要挂载的 Server。选择会随会话恢复——下次接续同一会话仍然保留勾选状态。

Trigger 会话默认不挂 MCP

Trigger 启动的会话默认不挂载 MCP（避免凭据语义混乱）。如有需要，请在 Trigger 配置中指明。

安全与凭据边界

不要在 defaultConfig 里硬塞用户级密钥

defaultConfig 是 Claw 本机共享配置；用户隔离的密钥应通过环境变量或独立 Connection 方式注入。

MCP 列表不向前端暴露完整配置

Client UI 仅展示摘要信息，保护凭据字段不外泄。

删除 MCP 不会自动清理依赖会话

删除前请确认没有正在运行的会话挂载它。

何时选 Skill 何时选 MCP

Skill 适合「可复用的工作流脚本」，由 Agent 在需要时按指令加载。
MCP 适合「外部系统的工具协议」，把数据库、内部服务、第三方 API 暴露成工具。
两者可以同时存在：Skill 提供步骤、MCP 提供工具。

继续阅读