aller au contenu principal
Parcourir la documentation

Syncanix avec Express

Rendez une API Express prête pour les agents : ce que lit la découverte, comment la lancer et comment mettre en service la surface de chat et le serveur MCP.

Les applications Express composent leurs routes à travers les fichiers : un routeur défini dans un module, monté sous un préfixe dans un autre. La découverte Syncanix suit ces montages statiquement et émet des chemins complets, si bien que le catalogue correspond à ce que votre API sert réellement.

Ce que lit la découverte

La découverte est statique : elle lit votre code source, pas votre trafic. Elle compose les chemins de requête complets à travers les fichiers, si bien que les préfixes montés font partie de chaque route extraite :

// app.ts
app.use('/api', ordersRouter);

// orders.router.ts
const ordersRouter = Router();
ordersRouter.get('/orders/:id', getOrder);      // → GET /api/orders/:id
ordersRouter.post('/orders/:id/refund', refund); // → POST /api/orders/:id/refund
Routes représentatives que l’extracteur compose — chemins complets, préfixes inclus.

L’extracteur suit les montages app.use(préfixe, routeur) et les chaînes Router().use() à travers les fichiers — y compris les routeurs importés par défaut — de sorte qu’une route déclarée /orders/:id dans un routeur monté sur /api est cataloguée GET /api/orders/:id.

Lancez la découverte

Depuis la racine du dépôt, lancez la commande init. Elle détecte le framework automatiquement, demande votre consentement avant tout enrichissement par LLM et écrit un catalogue déterministe :

$ npx syncanix init
✓ detected framework
✓ scanned routes
✓ wrote .syncanix/catalog.json
→ review your capabilities in the dashboard

Relisez le catalogue

Le catalogue dans .syncanix/catalog.json liste chaque capacité trouvée par la découverte : méthode, chemin et la description enrichie que verront vos utilisateurs. Relisez-le comme du code avant de l’envoyer : c’est le contrat qu’exposent votre surface de chat et votre serveur MCP.

Mettez la surface en service

Une fois le catalogue envoyé, intégrez le widget pour le chat dans votre application et connectez le serveur MCP par tenant pour Claude, ChatGPT et Cursor. Chaque action d’écriture reste soumise aux permissions, confirmée et auditée.

Étapes suivantes