aller au contenu principal
Parcourir la documentation

Syncanix avec Rails

Rendez une API Rails 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 routes Rails se déclarent dans config/routes.rb avec des macros de ressources et de l’imbrication. La découverte développe ces déclarations en paires concrètes verbe + chemin que sert votre API.

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 :

# config/routes.rb
namespace :api do
  resources :orders, only: [:index, :show] do
    member { post :refund }   # → POST /api/orders/:id/refund
  end
end
Routes représentatives que l’extracteur compose — chemins complets, préfixes inclus.

L’extracteur développe les blocs namespace et scope (formes chaîne et symbole), les resources imbriquées, les routes member et collection, et respecte les filtres only:/except: — même les routes d’authentification devise_for sont développées.

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