Risorse
SwiftXEO mette a disposizione un'API REST con ambito di workspace, un server MCP con OAuth e webhook in entrata firmati — ogni superficie di scrittura è in modalità sola proposta, e l'approvazione spetta esclusivamente agli utenti umani autenticati.
Connetti Claude, ChatGPT, Cursor o un sistema personalizzato al Business DNA approvato, agli obiettivi e agli apprendimenti attivi — e contribuisci con dati di riscontro e proposte attraverso lo stesso processo di revisione umana che governa tutto il resto.
Dottrina principale
Un agente connesso tramite API o MCP può leggere tutto ciò che il tuo workspace ha approvato e svolgere un lavoro utile basato su di esso. Può individuare elementi meritevoli di revisione e proporre un apprendimento utile. Ciò che non può fare è stabilire in autonomia che la propria conclusione sia corretta.
Nessun ambito, strumento o payload di webhook può approvare o attivare un apprendimento. Tale decisione avviene un'unica volta, all'interno del prodotto, da parte di un amministratore del workspace — lo stesso gate attraverso cui passa già ogni proposta generata internamente.
Principi della Piattaforma Aperta
Accesso vincolato alle credenziali
Il workspace viene derivato dalla chiave. Non può essere selezionato o sovrascritto da un parametro di richiesta.
Lettura della verità approvata
Business DNA, apprendimenti attivi, obiettivi e storico — lo stesso registro che il prodotto mostra a un utente umano.
Proporre, mai approvare
Le scritture esterne rimangono in attesa di approvazione. Nessun ambito di permesso può raggiungere la rotta di autorizzazione.
Acquisizione di riscontri firmati
I payload dei webhook vengono verificati tramite HMAC e archiviati come contesto connesso per la revisione — mai eseguiti direttamente.
Non verificato per impostazione predefinita
Il materiale esterno viene contrassegnato come non verificato al momento dell'acquisizione. La promozione a contenuto approvato è sempre una decisione umana.
Proiettato, non grezzo
Le risposte sono proiezioni basate su un elenco di autorizzazioni (allowlist). Gli identificativi interni restano all'interno; i revisori appaiono come etichette di ruolo, non con i propri nomi.
Autenticazione
Crea una chiave API del workspace in Impostazioni → Infrastruttura → Accesso Piattaforma Aperta (richiede il ruolo di amministratore del workspace). Il secret viene mostrato solo una volta; viene memorizzato solo il relativo hash. Gli ambiti di lettura sono inclusi dal piano Growth; gli ambiti di scrittura richiedono il piano Execution e vengono verificati al momento dell'uso, in modo che qualsiasi modifica al piano abbia effetto immediato alla richiesta successiva.
Authorization: Bearer sxk_live_k_xxxxxxxx_...
Snapshot del Business DNA, apprendimenti attivi, obiettivi e storico
Ricerca nel workspace tra argomenti, keyword, campagne, brief e concorrenti
Proposta di apprendimenti — rimangono sempre IN ATTESA nella coda di revisione umana
Invio di dati di riscontro, segnali o documenti come contesto connesso
Generazione di contenuti regolamentata — scala i crediti del workspace
Growth = utilizzo delle direttive approvate · Execution = contributo al workflow regolamentato
API REST v1
Ogni risposta utilizza lo stesso formato — { data, meta? } in caso di successo, { error: { code, message } } in caso contrario. Le letture sono limitate a 60 richieste al minuto per workspace, le scritture a 20. La generazione scala i crediti del workspace prima della chiamata al modello.
Snapshot del Business DNA approvato — una proiezione della verità aziendale basata su allowlist
Apprendimenti approvati da utenti umani (attivi), filtrabili per tipologia
Obiettivi di crescita aperti
Dati di riscontro, cronologia delle modifiche e autorizzazioni umane per un'entità
Proposta di un apprendimento — IN ATTESA finché un utente umano non lo approva
Invio di contesto connesso per la revisione
Generazione di contenuti regolamentata, soggetta a crediti
curl https://www.swiftxeo.com/api/v1/context/dna \
-H "Authorization: Bearer sxk_live_..."
curl -X POST https://www.swiftxeo.com/api/v1/learnings/propose \
-H "Authorization: Bearer sxk_live_..." \
-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."
}'Server MCP
L'endpoint /api/mcp supporta lo streaming HTTP stateless. I client hosted — Claude web, desktop e mobile, e ChatGPT in modalità sviluppatore — si connettono tramite OAuth: incolla l'URL, effettua l'accesso, seleziona un workspace, approva l'accesso. I client basati su file di configurazione come Claude Code e Cursor utilizzano una chiave statica del workspace.
L'elenco degli strumenti viene filtrato in base agli ambiti della connessione: gli strumenti di lettura restituiscono la verità approvata, gli strumenti di scrittura consentono unicamente di avanzare proposte. Non esiste deliberatamente alcuno strumento di approvazione, attivazione o autorizzazione in alcun ambito.
Claude Code, Cursor e altri client basati su file di configurazione
claude mcp add swiftxeo \ https://www.swiftxeo.com/api/mcp \ --transport http \ --header "Authorization: Bearer sxk_live_..."
Claude web, Desktop, mobile e ChatGPT
Aggiungi connettore personalizzato URL: https://www.swiftxeo.com/api/mcp → Accedi a SwiftXEO, seleziona un workspace, approva l'accesso. Nessuna chiave da incollare — questa connessione utilizza OAuth.
Strumenti disponibili
Webhook in entrata
Crea una sorgente in entrata sotto Impostazioni → Infrastruttura → Sorgenti in entrata per ricevere un endpoint dedicato e un secret di firma. Ogni payload viene verificato con HMAC-SHA256 sul corpo grezzo prima di essere registrato come contesto connesso — materiale destinato alla revisione umana, mai verità di per sé.
Il piano Growth include una sorgente attiva; Execution ne consente multiple.
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."
}Domande
No. Nessun ambito API, strumento MCP o webhook può impostare una proposta come approvata o accedere alla rotta di autorizzazione. I sistemi esterni possono leggere la verità approvata, inviare dati di riscontro e proporre apprendimenti — ogni proposta rimane in attesa e solo un amministratore di workspace autenticato come utente umano può approvarla.
Due tipi di credenziali sullo stesso header bearer: una chiave API del workspace statica per i client basati su file di configurazione, o un token di accesso OAuth per i client hosted come Claude e ChatGPT. In entrambi i casi, il workspace viene derivato dalla credenziale — mai dagli argomenti dello strumento.
Growth copre le letture: Business DNA, obiettivi, apprendimenti attivi, storico e ricerca nel workspace, oltre a una sorgente webhook in entrata. Execution aggiunge le scritture: proposta di apprendimenti, invio di riscontri, generazione regolamentata di contenuti e sorgenti in entrata multiple.
Solo le etichette dei ruoli. Le risposte destinate all'esterno vengono filtrate attraverso un livello di oscuramento: le identità di revisori e autori diventano "Amministratore del workspace", e gli identificativi interni vengono rimossi prima che qualsiasi dato lasci il workspace.
I riferimenti completi della piattaforma si trovano nella documentazione, mentre la pagina Open Platform illustra il modello di governance applicato da questi endpoint.