saltar al contenido principal
Explorar la documentación

Syncanix con Rails

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

Las rutas de Rails se declaran en config/routes.rb con macros de recursos y anidamiento. El descubrimiento expande esas declaraciones en los pares concretos de verbo y ruta que sirve tu API.

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:

# config/routes.rb
namespace :api do
  resources :orders, only: [:index, :show] do
    member { post :refund }   # → POST /api/orders/:id/refund
  end
end
Rutas representativas que el extractor compone: rutas completas, prefijos incluidos.

El extractor expande los bloques namespace y scope (en forma de cadena y de símbolo), los resources anidados, las rutas member y collection, y respeta los filtros only:/except: — incluso las rutas de autenticación de devise_for se expanden.

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