zum Hauptinhalt springen
Dokumentation durchsuchen

Syncanix mit NestJS

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

NestJS deklariert Routen mit Dekoratoren und setzt Präfixe global zusammen. Die Discovery liest beides — das @Controller-Präfix und setGlobalPrefix — auch wenn sie in unterschiedlichen Dateien liegen.

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:

// main.ts
app.setGlobalPrefix('api');

// orders.controller.ts
@Controller('orders')
export class OrdersController {
  @Get(':id')                       // → GET /api/orders/:id
  @Post(':id/refund')               // → POST /api/orders/:id/refund
}
Repräsentative Routen, die der Extraktor zusammensetzt — vollständige Pfade, Präfixe inklusive.

Der Extraktor kombiniert das Controller-Präfix (im @Controller-Stil) mit setGlobalPrefix aus main.ts — eine dateiübergreifende Komposition —, sodass jeder Handler-Dekorator unter seinem vollständigen Produktionspfad katalogisiert wird.

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