安裝
npm install -g @1mcp/agent
1mcp mcp add context7 -- npx -y @upstash/context7-mcp
1mcp serve適合誰
1MCP 面向要把多台 MCP 伺服器收成一個執行時的人。官方寫明 1MCP is the unified MCP runtime，1mcp serve aggregates your MCP servers；CLI mode 給 Codex、Claude、Cursor 以及 similar tool-using agents 一條更薄的代理工作流。
更適合你的情況是：你能全域安裝 npm 包，並接受先按官方例子加入 context7，再啟動 1mcp serve。第一次只做唯讀發現，呼叫 1mcp instructions。
不適合的情況是：你還沒有 Node/npm，卻想跳過安裝直接編造後端；或者第一次就 1mcp run 去執行未核對過的工具。官方沒有給出 --args 的示例 JSON。
3 分鐘完成第一次嘗試
前置條件：本機有 npm。官方主路徑是這三步，不要改成別的安裝器：
npm install -g @1mcp/agent
1mcp mcp add context7 -- npx -y @upstash/context7-mcp
1mcp serve
安裝位置是全域的 @1mcp/agent。serve 起來後，HTTP 用戶端可按官方片段連接到： http://127.0.0.1:3050/mcp?app=cursor
第一次呼叫用 1mcp instructions。它屬於 CLI mode for progressive discovery，用來拿使用說明，比 1mcp run 更低風險。不要帶未出現的參數。
成功訊號：回傳一段 instructions 文本，說明如何繼續 inspect 或 run。這會在本機拉起聚合執行時，並按例子透過 npx 拉取 @upstash/context7-mcp，不是「無網路、無本機行程」。
若 serve 沒起來，先確認全域 1mcp 命令可用，以及 mcp add 已加入 context7。不要改去只跑 1mcp cli-setup --codex 當成唯一安裝。
使用案例
案例一：先讀發現說明。在 serve 已執行時執行 1mcp instructions。用回傳文本確認 CLI 發現通道可用。不要在這一步傳 --args。
案例二：查看某個後端裡有什麼。官方寫出 1mcp inspect <server> 以及 1mcp inspect <server>/<tool>。對官方例子中的 context7 執行 1mcp inspect context7。成功時看到該 server 的工具資訊。只有在你已經從 inspect 得到真實工具名之後，才考慮 1mcp run <server>/<tool> --args；原文沒有給出 JSON 樣例，第一次不要 run。
使用邊界
1mcp serve 會聚合你添加的 MCP 伺服器，並在 127.0.0.1:3050 提供 HTTP。app=cursor 只是官方示例查詢串，不代表必須使用該用戶端。
1mcp cli-setup --codex 是 CLI 模式的另一種接線，不是第二條軟體包安裝通道。1mcp run 會真正執行後端工具，副作用取決於被聚合的伺服器，官方沒有統一撤銷路徑。除 instructions、inspect、run 和示例中的 context7 以外，不要編造其他後端名。