Resurser
SwiftXEO erbjuder ett REST API för arbetsytan, en MCP-server med OAuth och signerade inkommande webhooks. Alla skrivytor är endast för förslag (propose-only), och godkännandet stannar hos inloggade människor.
Anslut Claude, ChatGPT, Cursor eller era egna system till godkänt Business DNA, mål och aktiva lärdomar. Skicka tillbaka underlag och förslag via samma mänskliga granskning som allt annat.
Kärnregeln
En agent ansluten via API eller MCP läser den godkända kontext som dess behörighet omfattar: Business DNA, aktiva lärdomar, mål och spårbarhet. Den kan flagga saker värda att granska och föreslå en lärdom värd att ta tillvara. Vad den inte kan göra är att själv besluta att dess slutsats är korrekt.
Inget behörighetsomfång, verktyg eller webhook-data kan godkänna eller aktivera en lärdom. Det sker inuti SwiftXEO, av en behörig person, enligt destinationens egna granskningsregler. Att aktivera en lärdom kräver specifikt en administratör eller arbetsyteägare.
Principer för Öppen plattform
Åtkomst bunden till autentiseringsuppgift
Arbetsytan härleds från nyckeln. Den kan inte väljas eller åsidosättas av en anropsparameter.
Läs godkänt kontext
Business DNA, aktiva lärdomar, mål och spårbarhet – samma register som produkten visar för en människa.
Föreslå, aldrig godkänna
Externa skrivningar landar som väntande (pending). Ingen behörighet når auktoriseringsvägen.
Signerat intag av underlag
Webhook-payloads är HMAC-verifierade och lagras som sammankopplad kontext för granskning — exekveras aldrig.
Icke-betrodd som standard
Externt material stämplas som icke-betrott vid intag. Upphöjning är ett mänskligt beslut, varje gång.
Projicerat, inte rådata
Svar är tillåtelselistade projiceringar. Interna identifierare stannar kvar på insidan; granskare visas som rollbeteckningar, inte namn.
Autentisering
Skapa en API-nyckel för arbetsytan under Inställningar → Infrastruktur → Åtkomst till öppen plattform (kräver administratör för arbetsytan). Hemligheten visas en gång; endast dess hash lagras. Läsrättigheter ingår från Growth-planen; skrivrättigheter kräver Execution och kontrolleras på nytt vid användning, så att en ändring av abonnemang träder i kraft vid nästa anrop.
Authorization: Bearer sxk_live_k_xxxxxxxx_...
Ögonblicksbild av Business DNA, aktiva lärdomar, mål och spårbarhet
Sökning och utforskning i arbetsytan över ämnen, sökord (keywords), kampanjer, briefs och konkurrenter
Föreslå lärdomar – landar alltid som VÄNTANDE i den mänskliga granskningskön
Skicka in underlag, signaler eller dokument som sammankopplad kontext
Granskad innehållsgenerering – drar krediter från arbetsytan
Growth = konsumera godkänd riktning · Execution = bidra till styrda arbetsflöden
REST API v1
Varje svar använder samma struktur — { data, meta? } vid framgång, { error: { code, message } } i annat fall. Läsningar är begränsade till 60 anrop per minut per arbetsyta, skrivningar till 20. Generering drar krediter från arbetsytan före modellanropet.
Godkänd Business DNA-snapshot — returneras via en avgränsad allowlist-projektion
Mänskligt godkända (aktiva) lärdomar, filtrerbara efter typ
Öppna tillväxtmål
Underlag, versionshistorik och det mänskliga godkännandet för en entitet
Föreslå en lärdom – VÄNTANDE tills en människa godkänner
Skicka in sammankopplad kontext för granskning
Granskad innehållsgenerering, kreditbegränsad. Skicka med persist: true för att spara resultatet som ett utkast med tillhörande leverantörs- och uppgiftshärkomst; annars returneras endast texten
För längre externa arbeten kan SwiftXEO utfärda ett avgränsat uppdrag kopplat till ett mål, ta emot det resulterande arbetet och länka senare observationer tillbaka till samma register.
Sammanställ ett avgränsat kontextuppdrag för ett auktoriserat mål — den avgränsade struktur som en extern agent arbetar utifrån
Skicka in arbete mot ett uppdrag – utkast, underlag eller en föreslagen lärdom – som landar i väntan på mänsklig granskning. Kopplingen mellan uppdrag och resultat valideras på serversidan, och inaktuella eller påhittade uppdrags-ID:n avvisas
Rapportera en kvalitativ eller mätbar observation mot ett målresultat, idempotent och föremål för mänsklig granskning
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
Endpunkten /api/mcp använder tillståndslös strömmande HTTP. För närvarande testade värdklienter inkluderar Claude (webb, desktop, mobil) och ChatGPT, vilka ansluter via OAuth: klistra in URL:en, logga in, välj en arbetsyta och godkänn åtkomst. Klienter med konfigurationsfil, som Claude Code och Cursor, använder en statisk workspace-nyckel.
Verktygslistan filtreras utifrån anslutningens behörigheter: läsverktyg returnerar godkänt kontext, skrivverktyg ger endast förslag. Det finns avsiktligen inget verktyg för att godkänna, aktivera eller auktorisera på någon behörighetsnivå.
Claude Code, Cursor & andra konfigurationsbaserade klienter
claude mcp add swiftxeo \ https://www.swiftxeo.com/api/mcp \ --transport http \ --header "Authorization: Bearer sxk_live_k_xxxxxxxxxxxx_..."
Claude webb, skrivbord, mobil & ChatGPT
Lägg till anpassad koppling URL: https://www.swiftxeo.com/api/mcp → Logga in på SwiftXEO, välj en arbetsyta, godkänn åtkomst. Ingen nyckel att klistra in — denna anslutning använder OAuth.
Tillgängliga verktyg
Uppdateringar av utkast förblir endast ändringar av utkastet. Externa revideringar kan inte godkänna, auktorisera, låsa eller publicera objektet, och ett reviderat utkast måste genomgå en ny granskning innan det kan gå vidare.
Avgränsning
En API-nyckel eller MCP/OAuth-anslutning ger avgränsad, inkommande åtkomst till SwiftXEOs REST API och verktyg — ingenting mer. Den registrerar inte anroparen som en teammedlem i Agent Room och ger aldrig @omnämningssynlighet i en arbetsytas Agent Room.
AI-kollegorna i Agent Room utgör en separat, fast uppsättning: Claude, OpenAI, Gemini, SwiftXEO Advisor och Verifier. Var och en har sina egna routnings- och åtkomstregler som ingen extern inloggningsuppgift kan utöka eller kringgå.
Protokollet för Local Connector är relaterat men separat. Det kopplar ihop en lokal körmiljö, som en Mac som kör Agent Room-uppgifter, med en egen livscykel för autentisering, behörighet och återkallande. Detta är skilt från både API-nycklar och MCP-anslutningar.
Inkommande webhooks
Skapa en inkommande källa under Inställningar → Infrastruktur → Inkommande källor för att få en källspecifik endpunkt och signeringshemlighet. Varje payload verifieras med HMAC-SHA256 över den råa brödtexten innan den landar som kopplad kontext — underlag för mänsklig granskning, aldrig sanning i sig själv. Om verifieringen misslyckas avvisas begäran innan något tolkas eller sparas.
Growth inkluderar en aktiv källa; Execution tillåter flera.
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."
}Frågor och svar
Nej. Inget API-omfång, MCP-verktyg eller webhook kan markera ett förslag som godkänt eller nå godkännanderutten. Externa system kan läsa godkänd kontext, lägga till underlag och föreslå lärdomar. Varje förslag landar som väntande, och att aktivera en lärdom kräver en inloggad administratör eller arbetsyteägare.
Två typer av autentiseringsuppgifter på samma bearer-header: en statisk API-nyckel för arbetsytan för konfigurationsbaserade klienter, eller en OAuth-åtkomsttoken för molnbaserade klienter som Claude och ChatGPT. Oavsett vilket härleds arbetsytan från autentiseringsuppgiften — aldrig från verktygsargument.
Growth omfattar läsbehörighet: Business DNA, mål, aktiva lärdomar, spårbarhet och sökning i arbetsytan, plus en inkommande webhook-källa. Execution lägger till skrivbehörighet: föreslå lärdomar, skicka in underlag, granskad innehållsgenerering och flera inkommande källor.
Endast rollbeteckningar. Externa svar projiceras genom ett maskeringslager: granskares och författares identiteter blir "Workspace administrator", och interna identifierare tas bort innan något lämnar arbetsytan.
Den fullständiga plattformsreferensen finns i dokumentationen. Sidan för Open Platform förklarar den granskningsmodell som dessa ändpunkter tillämpar.