SDK 与 MCP。

我需要哪一个？

三者都以某个主体的身份进行认证。它们都不能创建或扩大授权——那始终是人的行为。

托管 MCP 服务器

https://api.commandagi.com/mcp——Streamable HTTP，无状态，JSON 响应。使用 API 密钥（cagi_…）认证，密钥在工作台账户菜单的 API 密钥中创建。

claude mcp add --transport http commandagi https://api.commandagi.com/mcp \
  --header "Authorization: Bearer cagi_YOUR_KEY"

它提供一个庞大的工具目录——超过三百个——包括线程（list_threads、create_thread、send_message、get_thread）、文件（list_drive、read_drive_file、write_drive_file）、你的账户（whoami、get_credits、list_models）、代码（run_code）、托管网站（create_site、deploy_site）、交易（trade_venues、trade_order、trade_account、trade_cancel）以及已配对的主机（list_hosts、host_call）。用 search_tools 找到你需要的那个。

本地 MCP 中继

在运行主机的电脑上，commandagi mcp 是一个 stdio MCP 服务器，它把请求中继到主机自己的端点。通过环境变量或文件向它提供智能体的主机凭据——绝不要作为命令行参数传入：

claude mcp add commandagi -e COMMANDAGI_CREDENTIAL=cagp_… -- commandagi mcp
# or
claude mcp add commandagi -- commandagi mcp \
  --credential-file ~/.config/claude/commandagi.credential

没有凭据时，客户端可以读取和显示内容，但不能执行操作。主机的端点只在本机回环地址上响应，并拒绝带有网页来源（origin）的请求。同样的控制工具也以普通 HTTP 的形式在 POST /control/<tool> 上响应，需携带 Authorization: Bearer <credential>。

本地工具

控制工具遵循智能体与长期授权中的每一条规则：每个工具都需要授权中包含对应的操作，stop 只需任意一条授权，而且每个动作在发送之前都会被记录。

TypeScript SDK

npm i commandagi        # Node 22 or later

import { CommandAGI } from "commandagi";

const cagi = new CommandAGI(); // reads COMMANDAGI_API_KEY
const { threadId } = (await cagi.threads.create({
  intent: "Summarise this week's robotics news",
})) as { threadId: string };
await cagi.threads.send(threadId, "Add a link for each one.");

这个软件包还会安装 commandagi 命令：commandagi whoami、commandagi threads create --intent "…"、commandagi call <tool> --json '{…}'，单独运行时则是一个交互式终端。源码：github.com/CommandAGI/commandagi-sdk-typescript。

Python SDK

pip install commandagi   # Python 3.9 or later

from commandagi import CommandAGI

cagi = CommandAGI()  # reads COMMANDAGI_API_KEY
with cagi.launch("simulation/warehouse") as world:
    world.sim.ik(target=[0.3, 0.0, 0.4])
    jpeg = world.observe(fresh=True)

源码：github.com/CommandAGI/commandagi-sdk-python。

环境变量