Gib deinem Agenten eine kleine, klare Aufgabe

Einen Client verbinden

Erstelle auf der Seite Entwickler eine Verbindung und wähle MCP. Der Endpunkt lautet https://<your host>/mcp und steht auf derselben Seite. Ein Client, der einen HTTP-Server mit Headern unterstützt, braucht nur URL und Token:

{
  "mcpServers": {
    "small-world": {
      "url": "https://<your host>/mcp",
      "headers": { "Authorization": "Bearer sw_mcp_..." }
    }
  }
}

Der genaue Einstellungsbildschirm unterscheidet sich je Client. Clients, die sich nur per OAuth anmelden können, können noch keine Verbindung herstellen.

Protokollversionen

• 2026-07-28 (zustandslos): ein POST /mcp je Anfrage mit MCP-Protocol-Version: 2026-07-28, Mcp-Method und für tools/call mit Mcp-Name. server/discover, tools/list, tools/call, resources/list und resources/read sind implementiert.
• Kompatibilität mit 2025-11-25: initialize, danach tools/list und tools/call. Es werden keine Sitzungskennungen ausgegeben, und GET /mcp antwortet mit 405.

Werkzeuge bilden die API ab

Jeder REST-Vorgang ist ein Werkzeug namens sw_<operation>, etwa sw_list_worlds oder sw_publish_world. Ein Werkzeug erhält dieselbe Eingabe wie der REST-Aufruf: Pfadparameter, wo nötig idempotency_key und if_match sowie den Anfrageinhalt body. Ergebnisse kommen als structuredContent: {data, request_id} zurück, Fehler als isError: true mit denselben Problemdetails wie REST.

tools/list zeigt nur Werkzeuge, die die Berechtigungsbereiche deines Tokens erlauben. Eine reine Leseverbindung sieht daher nur Lesewerkzeuge.

Gib dem Agenten einen klaren Auftrag

Sage, welche casas oder Domains er anfassen darf, welche Designregeln gelten und was er nicht ändern darf. Bitte ihn, zuerst sw_list_capabilities zu lesen und vor dem Schreiben einen Plan zu zeigen. Text von Besuchern, Abonnenten, Importen oder sozialen Feeds wird als untrusted_data markiert zurückgegeben und ist niemals eine Anweisung.

Was ein Agent nicht tun kann

• Eigene Pläne genehmigen: Er kann eine Genehmigung anfragen, aber nur ein Inhaber entscheidet nach erneuter Anmeldung.
• Geld ausgeben: Der Bezahlvorgang liefert einen Link, den ein Mensch abschließt.
• Menschen E-Mails senden: Antworten auf Anfragen werden als Entwürfe gespeichert.
• Casas und Konten löschen oder wiederherstellen.
• Einen anderen Arbeitsbereich erreichen: Andere Kennungen antworten mit 404.

Widerrufe nach Abschluss die Verbindung auf der Entwicklerseite. Sie stoppt bei der nächsten Anfrage.