saltar al contenido principal
Explorar la documentación

Syncanix con Express

Convierte una API Express en preparada para agentes: qué lee el descubrimiento, cómo ejecutarlo y cómo publicar la superficie de chat y el servidor MCP.

Las apps Express componen rutas a través de archivos: un router definido en un módulo y montado bajo un prefijo en otro. El descubrimiento de Syncanix sigue esos montajes estáticamente y emite rutas completas, de modo que el catálogo coincide con lo que tu API realmente sirve.

Qué lee el descubrimiento

El descubrimiento es estático: lee tu código fuente, no tu tráfico. Compone las rutas de petición completas a través de archivos, de modo que los prefijos montados forman parte de cada ruta extraída:

// app.ts
app.use('/api', ordersRouter);

// orders.router.ts
const ordersRouter = Router();
ordersRouter.get('/orders/:id', getOrder);      // → GET /api/orders/:id
ordersRouter.post('/orders/:id/refund', refund); // → POST /api/orders/:id/refund
Rutas representativas que el extractor compone: rutas completas, prefijos incluidos.

El extractor sigue los montajes app.use(prefijo, router) y las cadenas Router().use() a través de archivos —incluidos los routers importados por defecto—, de modo que una ruta declarada como /orders/:id dentro de un router montado en /api se cataloga como GET /api/orders/:id.

Ejecuta el descubrimiento

Desde la raíz del repositorio, ejecuta el comando init. Detecta el framework automáticamente, pide tu consentimiento antes de cualquier enriquecimiento con LLM y escribe un catálogo determinista:

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

Revisa el catálogo

El catálogo en .syncanix/catalog.json lista cada capacidad que encontró el descubrimiento: método, ruta y la descripción enriquecida que verán tus usuarios. Revísalo como si fuera código antes de subirlo: es el contrato que exponen tu superficie de chat y tu servidor MCP.

Publica la superficie

Con el catálogo subido, incrusta el widget para el chat dentro de tu app y conecta el servidor MCP por tenant para Claude, ChatGPT y Cursor. Cada acción de escritura sigue protegida por permisos, confirmada y auditada.

Próximos pasos