aller au contenu principal
Parcourir la documentation

Syncanix avec Fastify

Rendez une API Fastify 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.

Fastify encapsule ses routes dans des plugins et les monte avec des préfixes. La découverte suit register(plugin, { prefix }) à travers les fichiers, si bien que les routes des plugins sont cataloguées avec leurs chemins complets.

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 :

// server.ts
await fastify.register(ordersPlugin, { prefix: '/api' });

// orders.plugin.ts
fastify.get('/orders/:id', getOrder);        // → GET /api/orders/:id
fastify.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 register(plugin, { prefix }) à travers les fichiers — y compris les préfixes dérivés des répertoires de @fastify/autoload et les surcharges autoPrefix — de sorte que les routes encapsulées dans des plugins portent leur chemin monté complet.

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