zum Hauptinhalt springen
Dokumentation durchsuchen

Syncanix mit Fastify

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

Fastify kapselt Routen in Plugins und mountet sie mit Präfixen. Die Discovery folgt register(plugin, { prefix }) über Dateien hinweg, sodass Plugin-Routen mit ihren vollständigen Pfaden katalogisiert werden.

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:

// 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
Repräsentative Routen, die der Extraktor zusammensetzt — vollständige Pfade, Präfixe inklusive.

Der Extraktor folgt register(plugin, { prefix })-Mounts über Dateien hinweg — einschließlich der von @fastify/autoload aus Verzeichnissen abgeleiteten Präfixe und autoPrefix-Überschreibungen —, sodass plugin-gekapselte Routen ihren vollständigen gemounteten Pfad tragen.

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