Ressurser
SwiftXEO tilbyr et arbeidsområde-avgrenset REST API, en MCP-server med OAuth og signerte innkommende webhooks. Alle skrivegrensesnitt er kun for forslag («propose-only»), og godkjenning forblir forbeholdt innloggede mennesker.
Koble Claude, ChatGPT, Cursor eller dine egne systemer til godkjent Business DNA, mål og aktive erfaringer. Send dokumentasjon og forslag tilbake gjennom samme menneskelige kvalitetssikring som alt annet.
Kjerneregelen
En agent tilkoblet via API eller MCP leser den godkjente konteksten tilgangen er avgrenset til: Business DNA, aktive erfaringer, mål og sporbarhet (lineage). Den kan flagge ting som er verdt en gjennomgang og foreslå lærdommer verdt å ta vare på. Det den ikke kan gjøre, er å bestemme at dens egen konklusjon er korrekt.
Ingen tilgang, verktøy eller webhook-nyttelast kan godkjenne eller aktivere en erfaring. Det skjer inne i SwiftXEO, av en autorisert person, underlagt målets egne godkjenningsregler. Aktivering av en erfaring krever spesifikt en administrator eller eier av arbeidsområdet.
Prinsipper for Åpen plattform
Nøkkelbundet tilgang
Arbeidsområdet utledes fra nøkkelen. Det kan ikke velges eller overstyres av en forespørselsparameter.
Les godkjent kontekst
Business DNA, aktive erfaringer, mål og sporbarhet – nøyaktig samme dokumentasjon som produktet viser et menneske.
Foreslå, aldri godkjenne
Eksterne skriveoperasjoner havner i ventemodus. Ingen tilganger når frem til godkjenningsruten.
Signert mottak av underlag
Webhook-payloads HMAC-verifiseres og lagres som tilknyttet kontekst for gjennomgang — de kjøres aldri automatisk.
Uverifisert som standard
Eksternt materiale merkes som uverifisert ved mottak. Opphøying til godkjent er en menneskelig beslutning, hver eneste gang.
Projisert, ikke rådata
Responser er hvitelistede projiseringer. Interne identifikatorer blir værende på innsiden; godkjennere vises med rollebeskrivelse, ikke navn.
Autentisering
Opprett en API-nøkkel under Innstillinger → Infrastruktur → Tilgang til åpen plattform (krever administratorrolle). Hemmeligheten vises én gang; bare hashen lagres. Lesetilganger følger med fra Growth-planen; skrivetilganger krever Execution og re-sjekkes ved bruk, slik at en endring i abonnementet trer i kraft ved neste forespørsel.
Authorization: Bearer sxk_live_k_xxxxxxxx_...
Øyeblikksbilde av Business DNA, aktive erfaringer, mål og sporbarhet
Søk i arbeidsområdet på tvers av emner, nøkkelord, kampanjer, briefs og konkurrenter
Foreslå erfaringer – havner alltid som PENDING i den menneskelige godkjenningskøen
Send inn underlag, signaler eller dokumenter som tilknyttet kontekst
Kvalitetssikret innholdsgenerering – trekker kreditter fra arbeidsområdet
Growth = bruk godkjente føringer · Execution = bidra til styrt arbeidsflyt
REST API v1
Alle responser bruker samme struktur — { data, meta? } ved suksess, { error: { code, message } } ellers. Lesing er begrenset til 60 forespørsler per minutt per arbeidsområde, skriving til 20. Generering trekker kreditter fra arbeidsområdet før modellkallet utføres.
Godkjent Business DNA-snapshot — returnert gjennom en avgrenset allowlist-projeksjon
Menneskegodkjente (aktive) erfaringer, kan filtreres etter type
Åpne vekstmål
Dokumentasjon, revisjonshistorikk og menneskelig godkjenning for en entitet
Foreslå en erfaring – PENDING frem til et menneske godkjenner
Send inn tilknyttet kontekst for gjennomgang
Kvalitetssikret innholdsgenerering, kredittstyrt. Send med persist: true for å lagre resultatet som et utkast med leverandør-/oppgaveopprinnelse vedlagt; ellers returneres kun teksten
For mer omfattende eksternt arbeid kan SwiftXEO utstede et avgrenset oppdrag knyttet til et mål, ta imot det resulterende arbeidet og koble senere observasjoner tilbake til samme historikk.
Kompiler et avgrenset kontekstoppdrag for ett autorisert mål — den definerte rammen en ekstern agent arbeider ut fra
Send inn arbeid knyttet til et oppdrag – utkast, dokumentasjon eller en foreslått erfaring – som legges til ventende menneskelig gjennomgang. Koblingen mellom oppdrag og resultat valideres på serversiden, og utløpte eller oppdiktede oppdrags-ID-er avvises
Rapporter en kvalitativ eller måltagbar observasjon mot et målt resultat, idempotent og underlagt menneskelig vurdering
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
Endepunktet /api/mcp kommuniserer via tilstandsløs, strømbar HTTP. Testede vertsklienter inkluderer for øyeblikket Claude (web, desktop, mobil) og ChatGPT, som kobler til over OAuth: lim inn URL-en, logg inn, velg et arbeidsområde og godkjenn tilgang. Klienter som bruker konfigurasjonsfiler, som Claude Code og Cursor, bruker en statisk nøkkel for arbeidsområdet.
Verktøylisten filtreres basert på tilkoblingens scopes: leseverktøy returnerer godkjent kontekst, skriveverktøy kan kun foreslå. Det finnes bevisst ingen verktøy for godkjenning, aktivering eller autorisering på noe tilgangsnivå.
Claude Code, Cursor og andre konfigurasjonsfil-klienter
claude mcp add swiftxeo \ https://www.swiftxeo.com/api/mcp \ --transport http \ --header "Authorization: Bearer sxk_live_k_xxxxxxxxxxxx_..."
Claude web, desktop, mobil og ChatGPT
Legg til tilpasset kobling URL: https://www.swiftxeo.com/api/mcp → Logg inn på SwiftXEO, velg et arbeidsområde, godkjenn tilgang. Ingen nøkkel å lime inn — denne tilkoblingen bruker OAuth.
Tilgjengelige verktøy
Endringer i utkast forblir kun utkastmutasjoner. Ekstern revidering kan ikke godkjenne, autorisere, låse eller publisere elementet, og et revidert utkast må gjennomgå en ny vurdering før det kan gå videre.
Avgrensning
En API-nøkkel eller MCP/OAuth-tilkobling gir avgrenset, innkommende tilgang til SwiftXEOs REST API og verktøy — ingenting mer. Den registrerer ikke innringeren som et teammedlem i Agent Room, og den gir aldri synlighet for @omtale inne i et arbeidsområdes Agent Room.
AI-kollegene i Agent Room er en egen, fast liste: Claude, OpenAI, Gemini, SwiftXEO Advisor og Verifier. Hver har sine egne ruting- og tilgangsregler som ingen ekstern tilgang kan utvide eller omgå.
Local Connector-protokollen er beslektet, men separat. Den kobler et lokalt kjøremiljø, som en Mac som kjører Agent Room-oppgaver, med egne pålogginger, leieavtaler og tilbakekallingsrutiner. Dette er adskilt fra både API-nøkler og MCP-tilkoblinger.
Inngående webhooks
Opprett en innkommende kilde under Innstillinger → Infrastruktur → Innkommende kilder for å motta et kildespesifikt endepunkt og en signeringshemmelighet. Hver payload verifiseres med HMAC-SHA256 over råteksten (raw body) før den legges til som tilkoblet kontekst — materiale for manuell vurdering, aldri en sannhet i seg selv. Feil ved verifisering avviser forespørselen før noe analyseres eller lagres.
Growth inkluderer én aktiv kilde; Execution tillater 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ørsmål
Nei. Ingen API-tilgang, MCP-verktøy eller webhook kan markere et forslag som godkjent eller nå godkjenningsendepunktet. Eksterne systemer kan lese godkjent kontekst, legge til dokumentasjon og foreslå erfaringer. Alle forslag legges på vent, og aktivering av en erfaring krever en innlogget administrator eller eier av arbeidsområdet.
To typer legitimasjon på samme bearer-header: en statisk API-nøkkel for konfigurasjonsfil-klienter, eller en OAuth-tilgangstoken for skytjenester som Claude og ChatGPT. Uansett hentes arbeidsområdet fra legitimasjonen — aldri fra verktøyargumenter.
Growth dekker lesetilgang: Business DNA, mål, aktive erfaringer, sporbarhet og søk i arbeidsområdet, pluss én innkommende webhook-kilde. Execution legger til skrivetilgang: foreslå erfaringer, sende inn dokumentasjon, kvalitetssikret innholdsgenerering og flere innkommende kilder.
Kun rollebeskrivelser. Eksterne responser filtreres gjennom et anonymiseringslag: identiteten til godkjennere og forfattere blir til «Arbeidsområde-administrator», og interne identifikatorer fjernes før noe forlater arbeidsområdet.
Den fullstendige plattformreferansen finnes i dokumentasjonen. Siden om åpen plattform forklarer godkjenningsmodellen disse endepunktene håndhever.