Ressources
SwiftXEO met à disposition une API REST au niveau de l'espace de travail, un serveur MCP avec OAuth et des webhooks entrants signés. Toutes les opérations d'écriture fonctionnent en mode proposition seule, la validation restant réservée aux utilisateurs humains connectés.
Connectez Claude, ChatGPT, Cursor ou vos systèmes internes à votre ADN Métier validé, vos objectifs et vos enseignements actifs. Renvoyez des preuves et des propositions via le même processus de révision humaine que le reste de la plateforme.
Le principe fondamental
Un agent connecté via l'API ou le protocole MCP consulte le contexte validé auquel ses accès lui donnent droit : ADN Métier, enseignements actifs, objectifs, traçabilité. Il peut signaler des éléments méritant une révision et proposer des leçons à retenir. Ce qu'il ne peut pas faire, c'est décider lui-même de la validité de sa conclusion.
Aucune portée d'accès, aucun outil ni aucune charge utile de webhook ne peut approuver ou activer un enseignement. Cette action se déroule au sein de SwiftXEO, par une personne habilitée, selon les règles de révision de la destination. L'activation d'un enseignement exige spécifiquement un rôle d'administrateur ou de propriétaire de l'espace de travail.
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 le contexte approuvé
ADN Métier, enseignements actifs, objectifs et traçabilité — le même registre que celui présenté à un utilisateur dans l'interface.
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 Métier, enseignements actifs, objectifs et traçabilité
Recherche et découverte dans l'espace de travail à travers les sujets, mots-clés, campagnes, briefs et concurrents
Proposer des enseignements — arrive systématiquement 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 révisé — 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 d'entreprise approuvé — retourné via une projection limitée par liste d'autorisations
Enseignements validés par un humain (actifs), filtrables par type
Objectifs de croissance ouverts
Preuves, historique des révisions et validation humaine associée à une entité
Proposer un enseignement — EN ATTENTE jusqu'à validation humaine
Soumettre du contexte connecté pour révision
Génération de contenu révisé, soumise aux crédits. Passez persist: true pour enregistrer le résultat comme brouillon avec la provenance du fournisseur/tâche attachée ; sinon seul le texte brut est retourné
Pour les travaux externes plus longs, SwiftXEO peut émettre une mission cadrée liée à un objectif, réceptionner le livrable résultant et rattacher les observations ultérieures au même registre.
Compiler une attribution de contexte délimité pour un objectif autorisé — le cadre défini à partir duquel un agent externe travaille
Soumettre un livrable pour une mission — brouillon, preuve ou proposition d'enseignement — en attente de révision humaine. La liaison mission/résultat est validée côté serveur, et les identifiants de mission obsolètes ou inventés sont rejetés
Rapporter une observation qualitative ou métrique par rapport au résultat d'un objectif, de manière idempotente et sous réserve de révision humaine
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."
}'Serveur MCP
Le point d'accès /api/mcp communique en HTTP sans état avec flux continu. Les clients hébergés actuellement testés incluent Claude (web, bureau, mobile) et ChatGPT, qui se connectent via OAuth : collez l'URL, connectez-vous, sélectionnez un espace de travail et approuvez l'accès. Les clients configurés par fichier, tels que 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 le contexte approuvé, les outils d'écriture ne font que proposer. Il n'existe délibérément 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_k_xxxxxxxxxxxx_..."
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
Les mises à jour de brouillon restent de simples modifications de brouillon. Une révision externe ne peut ni approuver, ni autoriser, ni verrouiller, ni publier l'artefact, et un brouillon révisé doit passer un nouvel examen avant de pouvoir progresser.
Limite
Une clé API ou une connexion MCP/OAuth accorde un accès entrant ciblé à l'API REST et aux outils de SwiftXEO — rien de plus. Elle n'enregistre pas l'appelant comme coéquipier dans l'Agent Room et ne donne jamais de visibilité aux @mentions au sein de l'Agent Room d'un espace de travail.
Les agents intégrés d'Agent Room forment une équipe prédéfinie : Claude, OpenAI, Gemini, ainsi que l'Advisor et le Verifier de SwiftXEO. Chacun applique ses propres règles de routage et d'accès qu'aucun identifiant externe ne peut étendre ou contourner.
Le protocole Local Connector est lié mais distinct. Il associe un environnement d'exécution local (par exemple un Mac exécutant des tâches Agent Room) à ses propres identifiants, baux et cycles de révocation. Il est indépendant des clés d'API et des connexions MCP.
Webhooks entrants
Créez une source entrante sous Paramètres → Infrastructure → Sources entrantes pour recevoir un point d'accès et un secret de signature dédiés par source. Chaque payload est vérifié avec HMAC-SHA256 sur le corps brut avant d'intégrer le contexte connecté — un élément destiné à l'examen humain, jamais une vérité absolue en soi. Un échec de vérification rejette la requête avant tout parsing ou stockage.
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. Aucune portée d'API, aucun outil MCP ni aucun webhook ne peut marquer une proposition comme approuvée ou accéder aux routes de validation. Les systèmes externes peuvent lire le contexte validé, ajouter des preuves et proposer des enseignements. Chaque proposition arrive en attente, et l'activation d'un enseignement nécessite un administrateur ou un propriétaire d'espace de travail connecté.
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.
Le forfait Growth couvre les lectures : ADN Métier, objectifs, enseignements actifs, traçabilité et recherche dans l'espace de travail, ainsi qu'une source de webhook entrant. Le forfait Execution ajoute les écritures : proposition d'enseignements, soumission de preuves, génération de contenu révisé 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 documentation complète de la plateforme est accessible en ligne. La page Plateforme Ouverte détaille le modèle de gouvernance appliqué par ces points de terminaison.