Inicio rápido

Esta guía te lleva de una aplicación existente a un asistente Syncanix en funcionamiento, en el orden en que se hace de verdad: añade el fragmento, mapea tu sitio y publica las guías que redacta a partir de lo que encuentre. La revisión y la puesta en marcha van a ambos lados de eso. Dos pasos son opcionales y están marcados como tales: un análisis más profundo de tu código y conectar tu backend directamente.

Antes de empezar

• Un espacio de trabajo de Syncanix — habla con nuestro equipo de ventas en syncanix.com/contact para empezar.
• Node.js 20 o posterior.
• Una API HTTP existente con al menos un endpoint autenticado.
• Un proveedor de identidad para tus usuarios: Auth0, Clerk, Cognito, WorkOS o tu propio OIDC.
• Una clave de Anthropic, OpenAI o AWS Bedrock-EU, o usa el acceso gestionado al modelo, que está incluido en tu plan.

1. Configura tu espacio de trabajo y tus claves

La CLI de descubrimiento sube el catálogo a un espacio de trabajo de Syncanix, y el widget se autentica con una clave publicable, así que crea el espacio de trabajo y consigue ambas claves antes de ejecutar nada.

1. 1
   Consigue tu espacio de trabajoHabla con nuestro equipo de ventas en syncanix.com/contact para configurar tu espacio de trabajo. El panel es donde viven tu catálogo, tus claves de API y la configuración del widget.
2. 2
   Inicia sesión desde la CLIEjecuta npx syncanix login: tu navegador abre el panel para aprobar este dispositivo y la CLI guarda una sesión vinculada a tu cuenta en ~/.syncanix/credentials para que init pueda subir tu catálogo. ¿Máquina sin interfaz? Ejecuta npx syncanix login --key y pega una clave de máquina de Configuración → Claves de API.
3. 3
   Copia tu clave publicableDesde Configuración → Claves de API en el panel, copia tu clave publicable (pk_live_…). El fragmento de integración del widget la usa como su data-key: es segura para incluirse en el navegador.

npx syncanix login

2. Inserta el widget

Añade una etiqueta de script a tu app con tu clave publicable. Esta es toda la instalación: no hay paquete que añadir ni código que cambiar.

<script
  type="module"
  src="https://cdn.syncanix.com/widget.js"
  data-key="pk_live_..."
></script>

Eso es todo. El widget se carga de forma diferida, se ejecuta dentro de un Shadow DOM para que tus estilos y los nuestros nunca choquen, adopta tu marca automáticamente y está listo para derecha a izquierda.

3. Deja que lea tu producto

Con el widget en la página, el agente deduce lo que tu producto puede hacer mirándolo. Esto ocurre de dos formas, y no tienes que elegir: la primera es deliberada y rápida, la segunda se ejecuta en silencio a partir de entonces.

1. 1
   Mapea tu sitio, en una pasadaEmpieza a mapear desde el panel y recorre tu propio producto en tu propio navegador, con tu sesión iniciada. Va anotando cada pantalla sobre la marcha. No se envía nada desde ningún sitio que no sea la pestaña en la que estás.
2. 2
   Después, de forma continua, mientras tus usuarios naveganYa en marcha, sigue leyendo las pantallas que la gente visita de verdad, así que una página que publicas el martes se conoce el martes. Nadie abre un ticket para enseñárselo.

4. Revisa lo que encontró

Abre el panel para ver lo descubierto. Aquí decides qué puede hacer el asistente y con cuánta cautela:

• Marca los endpoints internos para que queden fuera del alcance del asistente.
• Define el efecto de cada acción —lectura, escritura o destructiva—, lo que determina cómo se confirma.
• Exige autenticación reforzada en las acciones sensibles, para que el usuario reconfirme su identidad antes de que se ejecuten.

5. Opcional: lee tu código para conocer las formas exactas

Leer una pantalla le dice al agente qué puede hacer allí una persona. Leer tu código le dice exactamente qué acepta tu software — los nombres de los parámetros, los tipos, cuáles son obligatorios — y encuentra capacidades que nadie ha visitado todavía. Es el camino más profundo, no el más difícil: ningún archivo de código sale de tu máquina. Ejecútalo desde tu repositorio:

npx syncanix init

6. Opcional: conecta tu backend

Cuando lo añadas, instala el SDK en el servicio que gestiona tu API. Arranca en unos milisegundos y mantiene tu catálogo al día con la detección de cambios en tiempo de ejecución:

npm install @syncanix/sdk-node

import { init } from '@syncanix/sdk-node';

// Resolves your API key from SYNCANIX_API_KEY, ~/.syncanix/credentials,
// or an inline { apiKey } — in that order.
const { environment, bootDurationMs } = await init({ environment: 'development' });
console.log(`Syncanix booted in ${bootDurationMs.toFixed(1)}ms`);

También puedes registrar herramientas nativas del SDK: acciones que el asistente puede invocar y que no son rutas HTTP normales. Cada una se ejecuta con la identidad del usuario final, facilitada por tu proveedor de identidad:

import { createToolRegistry } from '@syncanix/sdk-node';

const registry = createToolRegistry();

registry.tool({
  name: 'refund-order',
  description: 'Refund a customer order. Requires an admin role.',
  handler: async ({ orderId, amountCents }, ctx) => {
    // ctx.userId is the verified end user from your identity provider.
    return payments.refund({ orderId, amountCents, actor: ctx.userId });
  },
});

7. Conecta un cliente de IA

Cada espacio de trabajo también obtiene su propio servidor MCP, para que tus usuarios puedan alcanzar las mismas capacidades desde Claude Desktop, Cursor y ChatGPT. El inicio de sesión se federa con tu proveedor de identidad.

8. Ponlo en producción

Cuando estés conforme con el comportamiento del asistente en desarrollo, promuévelo a producción desde el panel. Antes se ejecuta una verificación de evaluación que bloquea la promoción si la calidad empeora, de modo que producción solo cambia para mejor.

Lo que tienes ahora

• Un asistente integrado en tu aplicación que responde preguntas y ejecuta tus acciones.
• Un servidor MCP por espacio de trabajo para Claude Desktop, Cursor y ChatGPT.
• Un registro de auditoría de cada acción, promoción y cambio administrativo.
• Todo alojado en la UE, con tus datos cifrados en reposo.

Próximos pasos