一、最简上手
确保 Claude Code 已安装且可正常启动。
添加一个 HTTP 类型的 MCP Server:
添加成功后验证:
预期输出中包含刚添加的 Server:
重启 Claude Code,新 Server 的工具即可在会话中使用。
二、更多添加方式
stdio — 本地子进程
stdio Server 作为本地进程运行,通过标准输入/输出与 Claude 通信。适合 npm/PyPI 分发的 Server。
-- 之后的内容是 Server 的启动命令。Claude Code 每次启动时自动执行该命令拉起进程。
需要传递 API Key 时,使用 -e 参数:
Python Server 使用 uvx 或 uv run:
http — 远程 HTTP 端点
http Server 运行在远程服务器上,使用 Streamable HTTP 协议通信。适合云服务商提供的 MCP 端点。
需要认证的 HTTP Server,使用 --header 传递凭据:
add-json — JSON 直接配置
配置项较多时,用 add-json 一次性传入完整 JSON:
从 Claude Desktop 导入
macOS 上已有 Claude Desktop 配置时,可一键导入:
传输方式对比
三、参数与配置
命令语法
所有选项必须放在 Server 名称之前。-- 分隔 Claude Code 选项和传递给 Server 的启动命令。