Ressourcer
SwiftXEO stiller et workspace-afgrænset REST API, en MCP-server med OAuth og signerede indgående webhooks til rådighed. Enhver skriveflade er udelukkende til forslag (propose-only), og godkendelse forbliver hos indloggede personer.
Forbind Claude, ChatGPT, Cursor eller dit eget system til godkendt Business DNA, målsætninger og aktive læringer. Send dokumentation og forslag retur gennem det samme menneskelige review som alt andet.
Kernereglen
En agent forbundet via API eller MCP læser den godkendte kontekst, dens adgang er afgrænset til: Business DNA, aktive læringer, målsætninger og historik. Den kan markere emner, der bør undersøges, og foreslå en læring. Hvad den ikke kan, er at erklære sin egen konklusion for korrekt.
Intet scope, værktøj eller webhook-payload kan godkende eller aktivere en læring. Det sker inde i SwiftXEO, udført af en autoriseret person under destinationens egne review-regler. Aktivering af en læring kræver specifikt en administrator eller workspace-ejer.
Open Platform-principper
Adgang bundet til adgangsdata
Workspacet udledes fra nøglen. Det kan ikke vælges eller tilsidesættes af en forespørgselsparameter.
Læs godkendt kontekst
Business DNA, aktive læringer, målsætninger og historik — den samme log, som produktet viser et menneske.
Foreslå, aldrig godkende
Eksterne skrivninger lander som afventende. Intet scope når autorisationsruten.
Signeret indtag af dokumentation
Webhook-payloads HMAC-verificeres og gemmes som tilkoblet kontekst til gennemgang — afvikles aldrig.
Ikke-betroet som standard
Eksternt materiale stemples som ikke-betroet ved modtagelse. Ophøjelse er hver gang en menneskelig beslutning.
Projektioner, ikke rådata
Svar leveres som godkendelsesliste-projektioner. Interne identifikatorer forbliver indeni; korrektører vises som rollebetegnelser, ikke navne.
Autentificering
Opret en workspace-API-nøgle under Indstillinger → Infrastruktur → Open Platform Access (kræver workspace-administrator). Hemmeligheden vises én gang; kun dens hash gemmes. Læse-scopes er inkluderet fra Growth-abonnementet; skrive-scopes kræver Execution og genkontrolleres ved brug, så en abonnementsændring træder i kraft ved næste forespørgsel.
Authorization: Bearer sxk_live_k_xxxxxxxx_...
Business DNA-øjebliksbillede, aktive læringer, målsætninger og historik
Workspace-søgemaskine på tværs af emner, keywords, kampagner, briefs og konkurrenter
Foreslå læringer — lander altid som AFVENTENDE (PENDING) i den menneskelige review-kø
Indsend dokumentation, signaler eller dokumenter som tilkoblet kontekst
Gennemgået content-generering — trækker på workspacets credits
Growth = anvend godkendte retningslinjer · Execution = bidrag til styret workflow
REST API v1
Ethvert svar bruger samme struktur — { data, meta? } ved succes, { error: { code, message } } ellers. Læsninger er begrænset til 60 forespørgsler pr. minut pr. workspace, skrivninger til 20. Generering fratrækker workspace-credits før modelkaldet.
Godkendt Business DNA-snapshot – returneret via en afgrænset allowlist-projektion
Menneskegodkendte (aktive) læringer, kan filtreres efter type
Åbne vækstmål
Dokumentation, revisionshistorik og den menneskelige godkendelse for en entitet
Foreslå en læring — AFVENTENDE indtil et menneske godkender
Indsend tilkoblet kontekst til gennemgang
Kvalitetssikret content-generering, styret af credits. Angiv persist: true for at gemme resultatet som en kladde med tilknyttet udbyder-/opgavehistorik; ellers returneres kun teksten
Ved længerevarende eksternt arbejde kan SwiftXEO udstede en afgrænset opgave knyttet til en målsætning, modtage det resulterende arbejde og koble senere observationer tilbage til samme historik.
Kompiler en afgrænset kontekstopgave for én autoriseret målsætning – den afgrænsede ramme, en ekstern agent arbejder ud fra
Indsend arbejde til en tildelt opgave — kladde, dokumentation eller foreslået læring — som lander til afventende menneskeligt review. Forbindelsen mellem opgave og resultat valideres på serversiden, og forældede eller opdigtede opgave-ID'er afvises
Rapportér en kvalitativ eller metrisk observation mod et målsætningsresultat, idempotent og underlagt manuel gennemgang
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
/api/mcp-endpointet benytter tilstandsløs, streambar HTTP. De aktuelt testede hosted klienter omfatter Claude (web, desktop, mobil) og ChatGPT, som opretter forbindelse via OAuth: indsæt URL'en, log ind, vælg et workspace, og godkend adgang. Konfigurationsfil-klienter som Claude Code og Cursor bruger en statisk workspace-nøgle.
Værktøjslisten filtreres i forhold til forbindelsens scopes: Læseværktøjer returnerer godkendt kontekst, skriveværktøjer stiller kun forslag. Der findes bevidst intet værktøj til godkendelse, aktivering eller autorisering i noget scope.
Claude Code, Cursor & andre konfigurationsfil-klienter
claude mcp add swiftxeo \ https://www.swiftxeo.com/api/mcp \ --transport http \ --header "Authorization: Bearer sxk_live_k_xxxxxxxxxxxx_..."
Claude web, desktop, mobil & ChatGPT
Tilføj tilpasset connector URL: https://www.swiftxeo.com/api/mcp → Log ind på SwiftXEO, vælg et workspace, godkend adgang. Ingen nøgle at indsætte — denne forbindelse bruger OAuth.
Tilgængelige værktøjer
Opdateringer af udkast forbliver kun ændringer af udkastet. Ekstern revidering kan ikke godkende, autorisere, låse eller publicere elementet, og et revideret udkast skal igennem en ny gennemgang, før det kan gå videre.
Afgrænsning
En API-nøgle eller MCP/OAuth-forbindelse giver afgrænset, indgående adgang til SwiftXEO's REST API og værktøjer – intet mere. Den registrerer ikke afsenderen som et Agent Room-teammedlem og giver aldrig @mention-synlighed inde i et workspaces Agent Room.
Agent Rooms AI-kolleger udgør en separat, fast opstilling: Claude, OpenAI, Gemini, SwiftXEO Advisor og Verifier. Hver har sine egne routing- og adgangsregler, som ingen eksterne legitimationsoplysninger kan udvide eller omgå.
Local Connector-protokollen er beslægtet, men separat. Den forbinder en lokal runtime, såsom en Mac der kører Agent Room-opgaver, med dens eget sæt af legitimationsoplysninger, leasing- og tilbagekaldelsescyklus. Dette er adskilt fra både API-nøgler og MCP-forbindelser.
Indgående webhooks
Opret en indgående kilde under Indstillinger → Infrastruktur → Indgående kilder for at modtage et kildespecifikt endpoint og en signeringsnøgle (signing secret). Hver payload verificeres med HMAC-SHA256 over den rå body, før den gemmes som tilknyttet kontekst – materiale til manuel gennemgang, aldrig en sandhed i sig selv. Hvis verificeringen fejler, afvises anmodningen, før noget parseres eller gemmes.
Growth indeholder én aktiv kilde; Execution tillader flere.
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."
}Spørgsmål
Nej. Intet API-scope, MCP-værktøj eller webhook kan markere et forslag som godkendt eller tilgå godkendelsesruten. Eksterne systemer kan læse godkendt kontekst, tilføje dokumentation og foreslå læringer. Ethvert forslag lander som afventende, og aktivering af en læring kræver en indlogget administrator eller workspace-ejer.
To typer adgangsdata på den samme bearer-header: en statisk workspace-API-nøgle til konfigurationsfil-klienter eller et OAuth-adgangstoken til hostede klienter som Claude og ChatGPT. Uanset hvad stammer workspacet fra adgangsdataene — aldrig fra værktøjsargumenter.
Growth dækker læseadgange: Business DNA, målsætninger, aktive læringer, historik og workspace-søgning, plus én indgående webhook-kilde. Execution tilføjer skriveadgange: forslag til læringer, indsendelse af dokumentation, kvalitetssikret content-generering og flere indgående kilder.
Kun rollebetegnelser. Eksterne svar projiceres gennem et anonymiseringslag: Identiteter på korrektører og forfattere bliver til "Workspace-administrator", og interne identifikatorer fjernes, før noget forlader workspacet.
Den komplette platformsreference findes i dokumentationen. Siden om den åbne platform forklarer den review-model, disse endpoints håndhæver.