zum Hauptinhalt springen
Dokumentation durchsuchen

Syncanix mit Rails

Machen Sie eine Rails-API agent-ready: was die Discovery liest, wie Sie sie ausführen und wie Sie Chat-Oberfläche und MCP-Server ausliefern.

Rails-Routen werden in config/routes.rb mit Ressourcen-Makros und Verschachtelung deklariert. Die Discovery expandiert diese Deklarationen in die konkreten Verb-Pfad-Paare, die Ihre API ausliefert.

Was die Discovery liest

Die Discovery arbeitet statisch — sie liest Ihren Quellcode, nicht Ihren Traffic. Sie setzt vollständige Request-Pfade über Dateigrenzen hinweg zusammen, sodass gemountete Präfixe Teil jeder extrahierten Route sind:

# config/routes.rb
namespace :api do
  resources :orders, only: [:index, :show] do
    member { post :refund }   # → POST /api/orders/:id/refund
  end
end
Repräsentative Routen, die der Extraktor zusammensetzt — vollständige Pfade, Präfixe inklusive.

Der Extraktor expandiert namespace- und scope-Blöcke (String- und Symbol-Form), verschachtelte resources, member- und collection-Routen und respektiert only:-/except:-Filter — selbst devise_for-Authentifizierungsrouten werden expandiert.

Discovery ausführen

Führen Sie im Wurzelverzeichnis des Repositories den init-Befehl aus. Er erkennt das Framework automatisch, holt vor jeder LLM-Anreicherung Ihre Zustimmung ein und schreibt einen deterministischen Katalog:

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

Katalog prüfen

Der Katalog unter .syncanix/catalog.json listet jede gefundene Capability auf — Methode, Pfad und die angereicherte Beschreibung, die Ihre Nutzer sehen. Prüfen Sie ihn wie Code, bevor Sie ihn hochladen: Er ist der Vertrag, den Ihre Chat-Oberfläche und Ihr MCP-Server offenlegen.

Oberfläche ausliefern

Sobald der Katalog hochgeladen ist, betten Sie das Widget für den In-App-Chat ein und verbinden den MCP-Server pro Tenant für Claude, ChatGPT und Cursor. Jede Schreibaktion bleibt berechtigungsgeprüft, bestätigt und auditiert.

Nächste Schritte