Resources
SwiftXEO biedt een REST API op workspace-niveau, een MCP-server met OAuth en ondertekende inkomende webhooks. Elk schrijfendpoint is uitsluitend bedoeld voor voorstellen; goedkeuring blijft voorbehouden aan ingelogde mensen.
Verbind Claude, ChatGPT, Cursor of je eigen systeem met goedgekeurd Business DNA, doelstellingen en actieve lessen. Stuur bewijs en voorstellen terug via dezelfde menselijke review als al het andere werk.
De kernregel
Een agent die is verbonden via de API of MCP leest de goedgekeurde context uit waarvoor de inloggegevens geautoriseerd zijn: Business DNA, actieve lessen, doelstellingen en lineage. Het kan zaken signaleren die een review waard zijn en lessen voorstellen. Wat het niet kan, is besluiten dat de eigen conclusie juist is.
Geen enkele scope, tool of webhook-payload kan een les goedkeuren of activeren. Dat gebeurt binnen SwiftXEO, door een geautoriseerd persoon, volgens de reviewregels van de bestemming. Het activeren van een les vereist specifiek een beheerder of workspace-eigenaar.
Principes van het Open Platform
Aan credential gebonden toegang
De workspace is afgeleid van de key. Deze kan niet worden geselecteerd of overschreven door een request-parameter.
Goedgekeurde context lezen
Business DNA, actieve lessen, doelstellingen en lineage — exact hetzelfde overzicht dat het product aan een mens toont.
Voorstellen, nooit goedkeuren
Externe schrijfopdrachten komen binnen als 'in behandeling'. Geen enkele scope heeft toegang tot de autorisatieroute.
Ondertekende invoer van onderbouwing
Webhook-payloads worden via HMAC geverifieerd en opgeslagen als gekoppelde context voor beoordeling — nooit direct uitgevoerd.
Standaard niet-vertrouwd
Externe gegevens worden bij binnenkomst als niet-vertrouwd aangemerkt. Promotie is telkens een menselijke beslissing.
Geprojecteerd, niet ruw
Responsen zijn allowlist-projecties. Interne identificaties blijven binnen; beoordelaars verschijnen als rollabels, niet als namen.
Authenticatie
Maak een workspace API-key aan onder Instellingen → Infrastructuur → Open Platform Toegang (workspace-admin vereist). De secret wordt eenmalig getoond; alleen de hash wordt opgeslagen. Lees-scopes zijn inbegrepen vanaf het Growth-abonnement; schrijf-scopes vereisen Execution en worden opnieuw gecontroleerd bij gebruik, zodat een abonnementswijziging direct ingaat bij het volgende verzoek.
Authorization: Bearer sxk_live_k_xxxxxxxx_...
Snapshot van Business DNA, actieve lessen, doelstellingen en lineage
Workspace-zoekfunctie over onderwerpen, keywords, campagnes, briefs en concurrenten
Lessen voorstellen — belandt altijd als PENDING in de menselijke review-wachtrij
Onderbouwing, signalen of documenten indienen als gekoppelde context
Gecontroleerde contentgeneratie — verbruikt workspace-credits
Growth = goedgekeurde richting gebruiken · Execution = bijdragen aan beheerde workflow
REST API v1
Elke respons gebruikt dezelfde structuur — { data, meta? } bij succes, anders { error: { code, message } }. Leesverzoeken zijn beperkt tot 60 verzoeken per minuut per workspace, schrijfverzoeken tot 20. Generatie brengt workspace-credits in mindering vóór de modelaanroep.
Goedgekeurde Business DNA-snapshot — geretourneerd via een afgebakende allowlist-projectie
Door mensen goedgekeurde (actieve) lessen, filterbaar op type
Openstaande groeidoelstellingen
Bewijs, revisiegeschiedenis en de menselijke goedkeuring voor een entiteit
Stel een les voor — PENDING totdat een mens deze goedkeurt
Gekoppelde context indienen voor beoordeling
Gecontroleerde contentgeneratie, beperkt door credits. Geef persist: true mee om het resultaat op te slaan als concept met herkomst van provider/taak; anders wordt alleen de tekst geretourneerd
Voor langere externe opdrachten kan SwiftXEO een afgebakende opdracht uitgeven die is gekoppeld aan een doelstelling, het resulterende werk accepteren en latere observaties terugkoppelen aan hetzelfde dossier.
Stel een begrensde contexttoewijzing samen voor één geautoriseerde doelstelling — de afgebakende structuur waar vanuit een externe agent werkt
Dien werk in voor een opdracht — concept, bewijs of een voorgestelde les — dat binnenkomt in afwachting van menselijke review. De koppeling tussen opdracht en resultaat wordt op de server gevalideerd; verouderde of verzonnen opdracht-ID's worden afgewezen
Rapporteer een kwalitatieve of meetbare observatie voor een beoogd resultaat, idempotent en onderhevig aan menselijke beoordeling
curl https://www.swiftxeo.com/api/v1/context/dna \
-H "Authorization: Bearer sxk_live_k_xxxxxxxxxxxx_..."
curl -X POST https://www.swiftxeo.com/api/v1/learnings/propose \
-H "Authorization: Bearer sxk_live_k_xxxxxxxxxxxx_..." \
-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
Het /api/mcp-endpoint ondersteunt stateless streambare HTTP. Momenteel geteste hosted clients zijn onder meer Claude (web, desktop, mobiel) en ChatGPT, die verbinding maken via OAuth: plak de URL, meld u aan, kies een workspace en keur de toegang goed. Clients met een configuratiebestand, zoals Claude Code en Cursor, gebruiken een statische workspace-sleutel.
De lijst met tools is gefilterd op basis van de bereiken van de verbinding: lees-tools tonen goedgekeurde context, schrijf-tools doen alleen voorstellen. Er is bewust geen tool voor goedkeuren, activeren of autoriseren binnen welk bereik dan ook.
Claude Code, Cursor & andere config-file clients
claude mcp add swiftxeo \ https://www.swiftxeo.com/api/mcp \ --transport http \ --header "Authorization: Bearer sxk_live_k_xxxxxxxxxxxx_..."
Claude web, Desktop, mobiel & ChatGPT
Voeg aangepaste connector toe URL: https://www.swiftxeo.com/api/mcp → Log in op SwiftXEO, kies een workspace, keur toegang goed. Geen key om te plakken — deze verbinding gebruikt OAuth.
Beschikbare tools
Concept-updates blijven uitsluitend conceptmutaties. Externe revisies kunnen het artefact niet goedkeuren, autoriseren, vergrendelen of publiceren, en een herzien concept moet opnieuw worden beoordeeld voordat het verder kan.
Begrenzing
Een API-sleutel of MCP/OAuth-verbinding verleent afgebakende, inkomende toegang tot de REST API en tools van SwiftXEO — niets meer. Het registreert de aanroeper niet als teamlid in de Agent Room en geeft nooit @mention-zichtbaarheid binnen de Agent Room van een workspace.
De teamleden in Agent Room vormen een vast, afzonderlijk team: Claude, OpenAI, Gemini, de SwiftXEO Advisor en Verifier. Elk heeft eigen routerings- en toegangsregels die door geen enkele externe inlogcode kunnen worden uitgebreid of omzeild.
Het Local Connector-protocol is hieraan verwant, maar staat op zichzelf. Het koppelt een lokale runtime, zoals een Mac die Agent Room-taken uitvoert, aan eigen inloggegevens, lease- en intrekkingscycli. Dit staat los van zowel API-sleutels als MCP-verbindingen.
Inbound webhooks
Maak een inkomende bron aan onder Instellingen → Infrastructuur → Inkomende bronnen om een endpoint per bron en een signing secret te ontvangen. Elke payload wordt geverifieerd met HMAC-SHA256 over de raw body voordat deze binnenkomt als gekoppelde context — materiaal voor menselijke beoordeling, nooit op zichzelf staande waarheid. Een mislukte verificatie weigert het verzoek voordat er iets wordt geparst of opgeslagen.
Growth omvat één actieve bron; Execution staat meerdere bronnen toe.
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."
}Vragen
Nee. Geen enkele API-scope, MCP-tool of webhook kan een voorstel als goedgekeurd markeren of de goedkeuringsroute aanroepen. Externe systemen kunnen goedgekeurde context uitlezen, bewijs toevoegen en lessen voorstellen. Elk voorstel komt binnen met de status pending, en het activeren van een les vereist een ingelogde beheerder of workspace-eigenaar.
Twee typen credentials op dezelfde bearer-header: een statische workspace API-key voor config-file clients, of een OAuth access-token voor gehoste clients zoals Claude en ChatGPT. In beide gevallen is de workspace afgeleid van de credential — nooit van tool-argumenten.
Growth dekt leesrechten af: Business DNA, doelstellingen, actieve lessen, lineage en zoeken in de workspace, plus één inkomende webhook-bron. Execution voegt schrijfrechten toe: lessen voorstellen, bewijs indienen, gecontroleerde contentgeneratie en meerdere inkomende bronnen.
Alleen rollabels. Externe responsen worden geprojecteerd door een afschermingslaag: identiteiten van beoordelaars en auteurs worden "Workspace administrator", en interne identificaties worden verwijderd voordat er iets de workspace verlaat.
De volledige platformreferentie is te vinden in de documentatie. De pagina over het Open Platform legt het reviewmodel uit dat deze endpoints afdwingen.