Ressources
SwiftXEO expose une API REST limitée à l'espace de travail, un serveur MCP avec OAuth et des webhooks entrants signés — chaque interface d'écriture fonctionne sur la base de propositions uniquement, et l'approbation reste réservée aux humains connectés.
Connectez Claude, ChatGPT, Cursor ou un système personnalisé à un ADN Business approuvé, à des objectifs et à des enseignements actifs — et contribuez en apportant des preuves et des propositions soumises au même processus de révision humaine qui régit tout le reste.
Doctrine fondamentale
Un agent connecté via l'API ou le serveur MCP peut lire tout ce que votre espace de travail a approuvé et accomplir un travail utile ancré dans ces données. Il peut observer des éléments valant d'être révisés et proposer un enseignement pertinent. Ce qu'il ne peut pas faire, c'est décider que sa propre conclusion est correcte.
Aucun périmètre, outil ou charge utile de webhook ne peut approuver ou activer un enseignement. Cette décision survient une seule fois, au sein du produit, par un administrateur de l'espace de travail — le même filtre par lequel passe déjà chaque proposition générée en interne.
Principes de la plateforme ouverte
Accès lié aux identifiants
L'espace de travail est dérivé de la clé. Il ne peut pas être sélectionné ou remplacé par un paramètre de requête.
Lire la vérité approuvée
ADN Business, enseignements actifs, objectifs et historique — le même registre que le produit affiche à un humain.
Proposer, ne jamais approuver
Les écritures externes arrivent en attente. Aucun périmètre n'atteint la route d'autorisation.
Ingestion de preuves signées
Les charges utiles de webhooks sont vérifiées par HMAC et stockées comme contexte connecté pour révision — jamais exécutées.
Non approuvé par défaut
Le matériel externe est marqué comme non approuvé dès l'ingestion. La promotion est une décision humaine, à chaque fois.
Projeté, non brut
Les réponses sont des projections basées sur une liste d'autorisations. Les identifiants internes restent à l'intérieur ; les réviseurs apparaissent sous forme d'étiquettes de rôle, non de noms.
Authentification
Créez une clé d'API d'espace de travail sous Paramètres → Infrastructure → Accès Plateforme Ouverte (rôle d'administrateur d'espace de travail requis). Le secret n'est affiché qu'une fois ; seul son hachage est stocké. Les périmètres de lecture sont inclus dès le forfait Growth ; les périmètres d'écriture nécessitent le forfait Execution et sont revérifiés à l'utilisation, de sorte qu'un changement de forfait prend effet dès la requête suivante.
Authorization: Bearer sxk_live_k_xxxxxxxx_...
Instantané de l'ADN Business, enseignements actifs, objectifs et historique
Recherche et découverte dans l'espace de travail à travers les sujets, mots-clés, campagnes, briefs et concurrents
Proposer des enseignements — arrive toujours EN ATTENTE dans la file de révision humaine
Soumettre des preuves, des signaux ou des documents comme contexte connecté
Génération de contenu gouvernée — déduit des crédits de l'espace de travail
Growth = consommer les directives approuvées · Execution = contribuer au flux de travail gouverné
API REST v1
Chaque réponse utilise le même format — { data, meta? } en cas de succès, { error: { code, message } } sinon. Les lectures sont limitées à 60 requêtes par minute et par espace de travail, les écritures à 20. La génération déduit des crédits d'espace de travail avant l'appel du modèle.
Instantané de l'ADN Business approuvé — une projection autorisée de la vérité organisationnelle
Enseignements approuvés par l'humain (actifs), filtrables par type
Objectifs de croissance ouverts
Preuves, historique des révisions et autorisation humaine pour une entité
Proposer un enseignement — EN ATTENTE jusqu'à ce qu'un humain l'approuve
Soumettre du contexte connecté pour révision
Génération de contenu gouvernée, soumise au solde de crédits
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."
}'Serveur MCP
L'endpoint /api/mcp utilise le protocole HTTP sans état en streaming. Les clients hébergés — Claude (web, ordinateur et mobile) et ChatGPT en mode développeur — se connectent via OAuth : collez l'URL, connectez-vous, choisissez un espace de travail, approuvez l'accès. Les clients avec fichier de configuration comme Claude Code et Cursor utilisent une clé d'espace de travail statique.
La liste des outils est filtrée selon les périmètres de la connexion : les outils de lecture renvoient la vérité approuvée, les outils d'écriture ne font que proposer. Il n'existe volontairement aucun outil d'approbation, d'activation ou d'autorisation, quel que soit le périmètre.
Claude Code, Cursor & autres clients configurés par fichier
claude mcp add swiftxeo \ https://www.swiftxeo.com/api/mcp \ --transport http \ --header "Authorization: Bearer sxk_live_..."
Claude Web, Desktop, mobile & ChatGPT
Ajouter un connecteur personnalisé URL : https://www.swiftxeo.com/api/mcp → Connectez-vous à SwiftXEO, choisissez un espace de travail, approuvez l'accès. Aucune clé à coller — cette connexion utilise OAuth.
Outils disponibles
Webhooks entrants
Créez une source entrante sous Paramètres → Infrastructure → Sources Entrantes pour recevoir un endpoint et un secret de signature propres à la source. Chaque charge utile est vérifiée avec HMAC-SHA256 sur le corps brut avant de parvenir comme contexte connecté — du matériel pour révision humaine, jamais une vérité en soi.
Le forfait Growth inclut une source active ; Execution en permet plusieurs.
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."
}Questions
Non. Aucun périmètre d'API, outil MCP ou webhook ne peut faire passer une proposition au statut approuvé ou accéder à la route d'autorisation. Les systèmes externes peuvent lire la vérité approuvée, apporter des preuves et proposer des enseignements — chaque proposition reste en attente, et seul un administrateur d'espace de travail connecté en tant qu'utilisateur humain peut l'approuver.
Deux types d'identifiants sur le même en-tête bearer : une clé d'API d'espace de travail statique pour les clients configurés par fichier, ou un jeton d'accès OAuth pour les clients hébergés comme Claude et ChatGPT. Dans les deux cas, l'espace de travail provient de l'identifiant — jamais des arguments de l'outil.
Growth couvre la lecture : ADN Business, objectifs, enseignements actifs, historique et recherche dans l'espace de travail, plus une source de webhook entrant. Execution ajoute l'écriture : proposition d'enseignements, soumission de preuves, génération de contenu gouvernée et sources entrantes multiples.
Uniquement les étiquettes de rôle. Les réponses externes sont projetées via une couche d'anonymisation : les identités des réviseurs et auteurs deviennent « Administrateur de l'espace de travail », et les identifiants internes sont supprimés avant que quoi que ce soit ne quitte l'espace de travail.
La référence complète de la plateforme se trouve dans la documentation, et la page Plateforme Ouverte explique le modèle de gouvernance que ces endpoints appliquent.