Inicio rápido

Este recorrido te lleva de una aplicación existente a un asistente de Syncanix en funcionamiento: descubre tu API, revisa lo que el asistente puede hacer, conecta tu backend, integra el widget y promueve a producción. La mayoría de los equipos lo completan en unos 90 minutos.

Antes de 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 una clave gestionada (en algunos planes se aplica un pequeño recargo).

1. Descubre tu API

Ejecuta la CLI en tu proyecto. Detecta tu framework, lee tus rutas, escribe un catálogo de capacidades y lo sube. El descubrimiento es estático por defecto: lee tu código, no lo ejecuta, y ningún dato de producción sale de tu máquina.

npx syncanix init

El enriquecimiento opcional con IA (títulos y descripciones más claros) solo se ejecuta tras dar tu consentimiento explícito de cero retención de datos en la solicitud. También puedes omitirlo y enriquecer más tarde.

2. Revisa el catálogo

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.

3. Conecta tu backend

Añade el SDK de Node al servicio dueño de tu API. Resuelve tu clave y arranca en unos pocos milisegundos:

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 });
  },
});

4. Integra el widget

Añade una etiqueta de script a tu aplicación, usando tu clave publicable:

<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.

5. Conecta un cliente MCP (opcional)

En los planes Growth y superiores, cada espacio de trabajo también obtiene su propio servidor MCP, de modo que tus usuarios acceden a las mismas capacidades desde Claude Desktop, Cursor y ChatGPT. El inicio de sesión se federa con tu proveedor de identidad.

6. Promueve a 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 (Growth y superiores).
• 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