Ressourcen
SwiftXEO bietet eine Workspace-bezogene REST-API, einen MCP-Server mit OAuth und signierte eingehende Webhooks – jede Schreib-Schnittstelle dient nur für Vorschläge, und die Freigabe bleibt angemeldeten Menschen vorbehalten.
Verbinden Sie Claude, ChatGPT, Cursor oder ein benutzerdefiniertes System mit freigegebener Business-DNA, Zielen und aktiven Erkenntnissen – und liefern Sie Nachweise sowie Vorschläge über denselben menschlichen Prüfprozess zurück, der alles steuert.
Kerndoktrin
Ein über die API oder MCP verbundener Agent kann alles lesen, was Ihr Workspace freigegeben hat, und darauf aufbauend nützliche Arbeit leisten. Er kann prüfenswerte Beobachtungen machen und eine lernenswerte Erkenntnis vorschlagen. Was er nicht kann: selbst entscheiden, dass seine eigene Schlussfolgerung korrekt ist.
Kein Scope, kein Tool und keine Webhook-Payload kann eine Erkenntnis genehmigen oder aktivieren. Diese Entscheidung trifft einmalig innerhalb des Produkts ein Workspace-Admin – dasselbe Nadelöhr, das auch jeder intern generierte Vorschlag passieren muss.
Prinzipien der offenen Plattform
Anmeldedaten-gebundener Zugriff
Der Workspace wird aus dem Schlüssel abgeleitet. Er kann nicht durch einen Anfrage-Parameter ausgewählt oder überschrieben werden.
Freigegebene Wahrheit lesen
Business-DNA, aktive Erkenntnisse, Ziele und Historie – exakt die Daten, die das Produkt auch einem Menschen anzeigt.
Vorschlagen, niemals genehmigen
Externe Schreibzugriffe verbleiben im Status „Ausstehend“. Kein Scope erreicht die Autorisierungsroute.
Signierter Nachweis-Eingang
Webhook-Payloads werden per HMAC verifiziert und als verknüpfter Kontext zur Überprüfung gespeichert – niemals direkt ausgeführt.
Standardmäßig nicht vertrauenswürdig
Externes Material wird beim Eingang als nicht vertrauenswürdig markiert. Die Freigabe ist jedes Mal eine menschliche Entscheidung.
Projektierte Daten, keine Rohdaten
Antworten sind Positivlisten-Projektionen. Interne Kennungen bleiben intern; Prüfer erscheinen als Rollenbezeichnungen, nicht mit Namen.
Authentifizierung
Erstellen Sie unter Einstellungen → Infrastruktur → Zugriff auf offene Plattform einen Workspace-API-Schlüssel (Workspace-Admin erforderlich). Das Secret wird einmalig angezeigt; nur sein Hash wird gespeichert. Lese-Scopes sind ab dem Growth-Tarif enthalten; Schreib-Scopes erfordern den Execution-Tarif und werden bei der Verwendung erneut geprüft, sodass eine Tarifänderung sofort bei der nächsten Anfrage wirksam wird.
Authorization: Bearer sxk_live_k_xxxxxxxx_...
Business-DNA-Momentaufnahme, aktive Erkenntnisse, Ziele und Historie
Workspace-Suche über Themen, Keywords, Kampagnen, Briefings und Wettbewerber
Erkenntnisse vorschlagen – landet immer als AUSSTEHEND in der menschlichen Prüfwarteschlange
Nachweise, Signale oder Dokumente als verknüpften Kontext einreichen
Governance-konforme Content-Generierung – zieht Workspace-Guthaben ab
Growth = freigegebene Ausrichtung nutzen · Execution = zum kontrollierten Workflow beitragen
REST-API v1
Jede Antwort nutzt dasselbe Format – { data, meta? } bei Erfolg, { error: { code, message } } im Fehlerfall. Leseanfragen sind auf 60 Anfragen pro Minute pro Workspace beschränkt, Schreibanfragen auf 20. Die Generierung zieht vor dem Modellaufruf Workspace-Guthaben ab.
Freigegebene Business-DNA-Momentaufnahme – eine Positivlisten-Projektion der Unternehmenswahrheit
Vom Menschen freigegebene (aktive) Erkenntnisse, filterbar nach Art
Offene Wachstumsziele
Nachweise, Überarbeitungshistorie und menschliche Autorisierung für ein Element
Eine Erkenntnis vorschlagen – AUSSTEHEND, bis ein Mensch sie freigibt
Verknüpften Kontext zur Überprüfung einreichen
Governance-konforme Content-Generierung, guthabenbasiert
curl https://www.swiftxeo.com/api/v1/context/dna \
-H "Authorization: Bearer sxk_live_..."
curl -X POST https://www.swiftxeo.com/api/v1/learnings/propose \
-H "Authorization: Bearer sxk_live_..." \
-H "Content-Type: application/json" \
-d '{
"kind": "content_learnings",
"category": "overclaim",
"lesson": "Avoid absolute performance claims without evidence.",
"evidenceNote": "Three campaign replies flagged the launch copy as overstated."
}'MCP-Server
Der Endpunkt /api/mcp nutzt zustandsloses, streamfähiges HTTP. Gehostete Clients – Claude Web, Desktop und Mobil sowie ChatGPT im Entwicklermodus – verbinden sich über OAuth: URL einfügen, anmelden, Workspace auswählen, Zugriff bestätigen. Konfigurationsbasierte Clients wie Claude Code und Cursor nutzen einen statischen Workspace-Schlüssel.
Die Tool-Liste wird nach den Scopes der Verbindung gefiltert: Lese-Tools liefern die freigegebene Wahrheit zurück, Schreib-Tools reichen nur Vorschläge ein. Es gibt bewusst kein Tool zum Genehmigen, Aktivieren oder Autorisieren auf irgendeiner Ebene.
Claude Code, Cursor & andere konfigurationsbasierte Clients
claude mcp add swiftxeo \ https://www.swiftxeo.com/api/mcp \ --transport http \ --header "Authorization: Bearer sxk_live_..."
Claude Web, Desktop, Mobil & ChatGPT
Benutzerdefinierten Connector hinzufügen URL: https://www.swiftxeo.com/api/mcp → Bei SwiftXEO anmelden, Workspace auswählen, Zugriff bestätigen. Kein Schlüssel erforderlich – diese Verbindung nutzt OAuth.
Verfügbare Tools
Eingehende Webhooks
Erstellen Sie unter Einstellungen → Infrastruktur → Eingehende Quellen eine Quelle, um einen quellspezifischen Endpunkt und ein Signatur-Secret zu erhalten. Jede Payload wird per HMAC-SHA256 über den Rohdaten-Body verifiziert, bevor sie als verknüpfter Kontext landet – Material für die menschliche Überprüfung, niemals eine eigenständige Wahrheit.
Growth enthält eine aktive Quelle; Execution ermöglicht mehrere.
POST /api/hooks/{workspaceId}/{sourceId}
X-Signature: sha256=<hmac of raw body>
{
"kind": "signal",
"title": "CRM: deal closed",
"body": "Acme signed the annual
plan after the Q3 campaign."
}Fragen
Nein. Kein API-Scope, MCP-Tool oder Webhook kann einen Vorschlag auf genehmigt setzen oder die Autorisierungsroute erreichen. Externe Systeme können die freigegebene Wahrheit lesen, Nachweise einreichen und Erkenntnisse vorschlagen – jeder Vorschlag verbleibt im Status „Ausstehend“, und nur ein als menschlicher Benutzer angemeldeter Workspace-Admin kann ihn genehmigen.
Über zwei Anmeldedaten-Typen auf demselben Bearer-Header: ein statischer Workspace-API-Schlüssel für konfigurationsbasierte Clients oder ein OAuth-Access-Token für gehostete Clients wie Claude und ChatGPT. In beiden Fällen stammt der Workspace aus den Anmeldedaten – niemals aus Tool-Argumenten.
Growth deckt Lesezugriffe ab: Business-DNA, Ziele, aktive Erkenntnisse, Historie und Workspace-Suche sowie eine eingehende Webhook-Quelle. Execution ergänzt Schreibzugriffe: Vorschlagen von Erkenntnissen, Einreichen von Nachweisen, Governance-konforme Content-Generierung und mehrere eingehende Quellen.
Ausschließlich Rollenbezeichnungen. Externe Antworten werden über eine Anonymisierungsschicht projiziert: Die Identitäten von Prüfern und Autoren werden zu „Workspace-Administrator“, und interne Kennungen werden entfernt, bevor etwas den Workspace verlässt.
Die vollständige Plattform-Referenz finden Sie in der Dokumentation, und die Seite „Offene Plattform“ erklärt das Governance-Modell, das diese Endpunkte durchsetzen.