快速入门
这个页面优先面向 AI agent 用户。它的职责很单一：让你拿到一个可运行的 1mcp serve 运行时，并验证一次 CLI 模式工作流。
完成本指南后，你会得到：
- 一个已经添加到 1MCP 的真实上游 MCP server
- 一个正在运行的
1mcp serve实例 - 已通过
cli-setup接入的 Codex 或 Claude - 一个已验证的
instructions -> inspect -> run工作流
如果你要看 proxy、直接 streamable HTTP 接入，或更深入的运行时运维说明，请跳到选择其他路径。
先决条件
- Node.js 18+
- 一个 AI agent 客户端，例如 Codex 或 Claude
5 分钟 Agent 设置
1. 安装 1MCP
bash
npm install -g @1mcp/agent2. 添加一个真实的上游 MCP server
先用一个可识别、便于验证的例子：
bash
1mcp mcp add context7 -- npx -y @upstash/context7-mcp3. 启动运行时
bash
1mcp serve保持这个 shell 运行，然后打开第二个 shell 继续。
4. 用 cli-setup 连接你的 agent
二选一：
bash
1mcp cli-setup --codexbash
1mcp cli-setup --claude --scope repo --repo-root .这个命令会安装引导文件，让 agent 按顺序使用 instructions、inspect 和 run。目标类型和作用域细节见 cli-setup。
5. 验证工作流
运行与你的 agent 将使用的同一组命令：
bash
1mcp instructions
1mcp inspect context7
1mcp inspect context7/query-docs
1mcp run context7/query-docs --args '{"libraryId":"/mongodb/docs","query":"aggregation pipeline"}'成功的样子
instructions会解释 CLI 工作流，并展示当前运行时上下文inspect context7能列出上游 server 的工具inspect context7/query-docs会在调用前展示 schemarun ...会返回来自上游 server 的真实结果
到这里，你的 agent 已经可以在不额外阅读其他设置页面的前提下，通过 CLI 模式使用 1MCP。
这个页面不覆盖什么
- 完整运行时配置
- 鉴权与团队部署
proxy与最大兼容性的 stdio 路径- 直接 streamable HTTP MCP 接入细节
当第一条工作流跑通后，再去看下面链接到的深入页面。
为什么推荐这条路径
对 agent 会话来说，CLI 模式是拿到工作结果的最窄路径：
1mcp serve在后台提供一个统一运行时cli-setup为 agent 安装引导文件instructions -> inspect -> run让工具暴露保持渐进，而不是一开始就全部展开
选择其他路径
stdio proxy
如果你在 CLI 之外还想获得最广泛的客户端兼容性，请走这条路径。
proxy 往往比直接 streamable HTTP 更适合作为回退方案，因为它通过 .1mcprc 保留项目上下文，支持模板 MCP 服务器，也更容易通过一次全局配置加项目级配置来统一落地。
直接 MCP 接入
如果你的客户端已经原生支持 streamable HTTP 的 MCP，而且你不需要项目上下文，请走这条路径。
运行时运维
当基础流程跑通后，再来看这些运行时管理文档：
下一步
常见问题
1mcp serve 启动失败
- 检查是否安装了 Node.js 18+：
node --version - 重新运行
1mcp mcp list，确认上游 server 已成功添加
cli-setup 没有影响到我的 agent
- 确认你选择了正确的目标：
--codex或--claude - 如果使用 repo 作用域，确认命令是在目标仓库根目录运行的
inspect 看不到工具
- 确认第一个 shell 里的
1mcp serve还在运行 - 再次执行
1mcp instructions，确认当前运行时状态
run 调用上游 server 失败
- 重新执行
1mcp inspect context7/query-docs，检查必填参数 - 查看
serve的输出，确认上游启动时没有报错