SDK und MCP.

Welchen brauchen Sie?

Alle drei melden sich als Prinzipal an. Keiner von ihnen kann eine Berechtigung erstellen oder erweitern — das ist immer die Handlung einer Person.

Gehosteter MCP-Server

https://api.commandagi.com/mcp — Streamable HTTP, zustandslos, JSON-Antworten. Melden Sie sich mit einem API-Schlüssel (cagi_…) an, den Sie in der Werkbank über API-Schlüssel im Kontomenü erstellen.

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

Er stellt einen großen Katalog an Werkzeugen bereit — über dreihundert — darunter Unterhaltungen (list_threads, create_thread, send_message, get_thread), Dateien (list_drive, read_drive_file, write_drive_file), Ihr Konto (whoami, get_credits, list_models), Code (run_code), gehostete Websites (create_site, deploy_site), Handel (trade_venues, trade_order, trade_account, trade_cancel) und gekoppelte Hosts (list_hosts, host_call). Verwenden Sie search_tools, um das passende zu finden.

Lokales MCP-Relais

Auf einem Computer mit dem Host ist commandagi mcp ein stdio-MCP-Server, der an den eigenen Endpunkt des Hosts weiterleitet. Geben Sie ihm die Host-Anmeldedaten des Agenten — in der Umgebung oder in einer Datei, nie als Argument:

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

Ohne Anmeldedaten kann ein Client lesen und Dinge anzeigen, aber nicht handeln. Der Endpunkt des Hosts antwortet nur über Loopback und lehnt Anfragen ab, die den Ursprung einer Webseite tragen. Dieselben Steuerwerkzeuge antworten auch über einfaches HTTP unter POST /control/<tool> mit Authorization: Bearer <credential>.

Lokale Werkzeuge

Die Steuerwerkzeuge folgen jeder Regel in Agenten und Dauerberechtigungen: Jedes braucht das passende Verb in einer Berechtigung, stop braucht irgendeine Berechtigung, und jede Aktion wird aufgezeichnet, bevor sie gesendet wird.

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.");

Der Befehl commandagi gehört zu einem anderen Paket, @commandagi/host (npm install -g @commandagi/host), das zugleich der lokale Host ist: commandagi whoami, commandagi threads create --intent "…", commandagi call <tool> --json '{…}', und ein interaktives Terminal, wenn er allein gestartet wird. Quelle: github.com/CommandAGI/commandagi-sdk-typescript.

Python-SDK

pip install commandagi      # Python 3.9 or later
uv pip install commandagi   # an environment uv manages (in a uv project: uv add commandagi)

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)

Quelle: github.com/CommandAGI/commandagi-sdk-python.

Umgebung