Resurssit
SwiftXEO tarjoaa työtilakohtaisen REST API:n, MCP-palvelimen OAuth-tuella sekä allekirjoitetut saapuvat webhookit. Jokainen kirjoituspinta on vain ehdotuksia varten (propose-only), ja hyväksyntävalta säilyy sisäänkirjautuneilla ihmisillä.
Liitä Claude, ChatGPT, Cursor tai oma järjestelmäsi hyväksyttyyn Business DNA:han, tavoitteisiin ja aktiivisiin oppeihin. Lähetä taustatietoja ja ehdotuksia saman ihmiskatselmoinnin läpi kuin kaikki muukin.
Ydinsääntö
API:n tai MCP:n kautta liitetty agentti lukee hyväksyttyä kontekstia käyttöoikeuksiensa mukaisesti: Business DNA:ta, aktiivisia oppeja, tavoitteita ja historiaa. Se voi merkitä asioita katselmoitavaksi ja ehdottaa oppeja. Se ei kuitenkaan voi päättää oman johtopäätöksensä oikeellisuudesta.
Mikään käyttöoikeus, työkalu tai webhook-hyötykuorma ei voi hyväksyä tai aktivoida oppia. Se tapahtuu SwiftXEOn sisällä valtuutetun henkilön toimesta kohteen omien katselmointisääntöjen mukaisesti. Opin aktivointi vaatii nimenomaisesti ylläpitäjän tai työtilan omistajan roolin.
Avointen alustojen periaatteet
Tunnisteisiin sidottu pääsy
Työtila määritellään avaimen perusteella. Sitä ei voi valita tai ohittaa pyynnön parametreilla.
Lue hyväksytty konteksti
Business DNA, aktiiviset opit, tavoitteet ja historia – sama aineisto, jonka tuote näyttää ihmiselle.
Ehdota, älä koskaan hyväksy
Ulkoiset kirjoitukset jäävät odottamaan hyväksyntää. Mikään käyttöoikeus ei yllä valtuutusreitille.
Allekirjoitetun aineiston vastaanotto
Webhook-data todennetaan HMAC-allekirjoituksella ja tallennetaan tarkistettavaksi kontekstiksi — sitä ei koskaan ajeta suoraan.
Vahvistamaton oletuksena
Ulkoinen materiaali merkitään vahvistamattomaksi vastaanotettaessa. Sen nostaminen ylemmälle tasolle on aina ihmisen päätös.
Rajoitettu näkymä, ei raakadataa
Vastaukset ovat sallittujen tietojen näkymiä. Sisäiset tunnisteet pysyvät järjestelmässä; tarkistajat näkyvät roolinimikkeinä, eivät niminä.
Tunnistautuminen
Luo työtilan API-avain kohdassa Asetukset → Infrastruktuuri → Avoimen alustan pääsy (vaatii työtilan ylläpitäjän oikeudet). Salaisuus näytetään kerran; vain sen tiiviste (hash) tallennetaan. Lukuoikeudet sisältyvät Growth-tasoon; kirjoitusoikeudet vaativat Execution-tason ja ne tarkistetaan aina pyynnön yhteydessä, joten tilausmuutos astuu voimaan seuraavalla pyynnöllä.
Authorization: Bearer sxk_live_k_xxxxxxxx_...
Business DNA -tilannekuva, aktiiviset opit, tavoitteet ja historia
Työtilan haku aiheista, avainsanoista, kampanjoista, ohjeistuksista ja kilpailijoista
Ehdota oppeja – päätyy aina ODOTTAVAAN tilaan ihmiskatselmointijonoon
Lähetä aineistoa, signaaleja tai asiakirjoja kytkettynä kontekstina
Katselmoitu sisällöntuotanto – vähentää työtilan krediittejä
Growth = hyödynnä hyväksyttyä ohjeistusta · Execution = osallistu hallinnoituun työnkulkuun
REST API v1
Jokainen vastaus noudattaa samaa muotoa — onnistuessaan { data, meta? }, muuten { error: { code, message } }. Lukukutsut on rajoitettu 60 pyyntöön minuutissa työtilaa kohden, kirjoituskutsut 20 pyyntöön. Sisällön luonti vähentää työtilan krediittejä ennen mallikutsua.
Hyväksytty Business DNA -tilannevedos — palautetaan rajatun allowlist-projektion kautta
Ihmisen hyväksymät (aktiiviset) opit, suodatettavissa tyypin mukaan
Avoimet kasvutavoitteet
Entiteetin taustatiedot, versiohistoria ja ihmisen tekemä hyväksyntä
Ehdota oppia – ODOTTAVASSA tilassa kunnes ihminen hyväksyy
Lähetä kytkettyä kontekstia arvioitavaksi
Katselmoitu sisällöntuotanto, krediittipohjainen. Välitä persist: true tallentaaksesi tuloksen luonnoksena tarjoaja-/tehtävätietoineen; muuten palautetaan vain teksti
Laajempaa ulkoista työtä varten SwiftXEO voi luoda tavoitteeseen sidotun rajatun toimeksiannon, vastaanottaa valmistuneen työn ja linkittää myöhemmät havainnot takaisin samaan tietueeseen.
Kokoa rajattu kontekstitehtävä yhtä valtuutettua tavoitetta varten — se rajattu muoto, jonka pohjalta ulkoinen agentti työskentelee
Lähetä toimeksiantoon liittyvää työtä – luonnos, taustatieto tai oppiehdotus – joka jää odottamaan ihmisen katselmointia. Toimeksiannon ja tuloksen välinen linkki validoidaan palvelimella, ja vanhentuneet tai keksityt toimeksianto-ID:t hylätään
Raportoi laadullinen tai mittaripohjainen havainto tavoitteen tuloksesta, idempotentisti ja ihmisen tarkistuksen alaisena
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-palvelin
/api/mcp-päätepiste käyttää tilatonta, striimattavaa HTTP:tä. Tällä hetkellä testattuihin isännöityihin asiakasohjelmiin kuuluvat Claude (web, työpöytä, mobiili) ja ChatGPT, jotka muodostavat yhteyden OAuth-autentikoinnilla: liitä URL-osoite, kirjaudu sisään, valitse työtila ja hyväksy käyttöoikeudet. Asetustiedostoa käyttävät asiakasohjelmat, kuten Claude Code ja Cursor, käyttävät staattista työtilavainta.
Työkaluluettelo suodatetaan yhteyden käyttöoikeuksien (scopes) mukaan: lukutyökalut palauttavat hyväksytyn kontekstin, kirjoitustyökalut tekevät vain ehdotuksia. Millekään käyttöoikeustasolle ei ole tarkoituksella toteutettu hyväksymis-, aktivointi- tai valtuutustyökalua.
Claude Code, Cursor & muut konfiguraatiotiedostoja käyttävät asiakasohjelmat
claude mcp add swiftxeo \ https://www.swiftxeo.com/api/mcp \ --transport http \ --header "Authorization: Bearer sxk_live_k_xxxxxxxxxxxx_..."
Claude (selain, työpöytä, mobiili) & ChatGPT
Lisää mukautettu yhdistin URL: https://www.swiftxeo.com/api/mcp → Kirjaudu SwiftXEO-palveluun, valitse työtila, hyväksy pääsy. Avainta ei tarvitse liittää — tämä yhteys käyttää OAuthia.
Saatavilla olevat työkalut
Luonnospäivitykset pysyvät vain luonnosmuutoksina. Ulkoinen muokkaus ei voi hyväksyä, valtuuttaa, lukita tai julkaista artefaktia, ja muokatun luonnoksen on läpäistävä uusi tarkistus ennen kuin se voi edetä.
Raja
API-avain tai MCP/OAuth-yhteys myöntää rajatun, sisääntulevan pääsyn SwiftXEO:n REST API:in ja työkaluihin — ei mitään muuta. Se ei rekisteröi kutsujaa Agent Room -tiimijäseneksi, eikä se koskaan myönnä @mention-näkyvyyttä työtilan Agent Roomissa.
Agent Roomin tiimiläiset ovat erillinen, kiinteä kokoonpano: Claude, OpenAI, Gemini, SwiftXEO Advisor ja Verifier. Jokaisella on omat reititys- ja pääsysääntönsä, joita mikään ulkoinen tunnistetieto ei voi laajentaa tai ohittaa.
Local Connector -protokolla on erillinen kokonaisuus. Se parittaa paikallisen ajoympäristön, kuten Agent Room -tehtäviä suorittavan Macin, omiin käyttöoikeuksiin, varauksiin ja peruutussykliin. Tämä eroaa sekä API-avaimista että MCP-yhteyksistä.
Saapuvat webhookit
Luo saapuvan tiedon lähde kohdassa Asetukset → Infrastruktuuri → Saapuvat lähteet saadaksesi lähdekohtaisen päätepisteen ja allekirjoitussalaisuuden (signing secret). Jokainen payload vahvistetaan raakadatan yli HMAC-SHA256-menetelmällä ennen kuin se päätyy kytketyksi kontekstiksi — materiaaliksi ihmisen tarkistusta varten, ei koskaan sellaisenaan totuudeksi. Vahvistuksen epäonnistuminen hylkää pyynnön ennen kuin mitään jäsennetään tai tallennetaan.
Growth-tilaus sisältää yhden aktiivisen lähteen; Execution-tilaus sallii useita.
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."
}Kysymykset
Ei. Mikään API-oikeus, MCP-työkalu tai webhook ei voi merkitä ehdotusta hyväksytyksi tai käyttää hyväksyntäreittiä. Ulkoiset järjestelmät voivat lukea hyväksyttyä kontekstia, lisätä taustatietoa ja ehdottaa oppeja. Jokainen ehdotus päätyy odottavaan tilaan, ja opin aktivointi vaatii sisäänkirjautuneen ylläpitäjän tai työtilan omistajan.
Kaksi tunnistautumistapaa samassa bearer-otsakkeessa: staattinen työtilan API-avain konfiguraatiotiedostoja käyttäville asiakasohjelmille tai OAuth-käyttöoikeustoken pilvipalveluille, kuten Claudelle ja ChatGPT:lle. Molemmissa tapauksissa työtila määräytyy tunnisteen perusteella — ei koskaan työkalun argumenteista.
Growth kattaa lukuoikeudet: Business DNA:n, tavoitteet, aktiiviset opit, historian ja työtilahaun sekä yhden saapuvan webhook-lähteen. Execution lisää kirjoitusoikeudet: oppien ehdottamisen, taustatietojen lähettämisen, katselmoidun sisällöntuotannon ja useat saapuvat lähteet.
Vain roolinimikkeet. Ulkoiset vastaukset kulkevat suodatuksen läpi: tarkistajien ja tekijöiden henkilöllisyydet muunnetaan muotoon "Workspace administrator", ja sisäiset tunnisteet poistetaan ennen kuin mitään lähtee työtilasta.
Täydellinen alustadokumentaatio löytyy ohjeista. Avoin alusta -sivulla selitetään katselmointimalli, jota nämä päätepisteet noudattavat.