aller au contenu principal
Parcourir la documentation

Syncanix avec Next.js

Rendez une application Next.js 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.

Next.js dérive ses routes du système de fichiers. La découverte parcourt les routeurs App et Pages et transforme les chemins de fichiers en chemins de requête — segments dynamiques, catch-all et groupes de routes inclus.

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/api/orders/[id]/route.ts   → GET /api/orders/[id]
export async function GET(req: Request) { /* … */ }

// app/api/orders/[id]/refund/route.ts → POST /api/orders/[id]/refund
export async function POST(req: Request) { /* … */ }
Routes représentatives que l’extracteur compose — chemins complets, préfixes inclus.

L’extracteur dérive les chemins du système de fichiers pour les deux routeurs : les segments dynamiques comme [id], les segments catch-all et les groupes de routes sont résolus, et les fonctions exportées portant un verbe HTTP déterminent la méthode de chaque capacité.

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