Démarrage rapide

Ce guide vous mène d’une application existante à un assistant Syncanix opérationnel : découvrez votre API, vérifiez ce que l’assistant peut faire, connectez votre backend, intégrez le widget et promouvez en production. La plupart des équipes y parviennent en environ 90 minutes.

Avant de commencer

• Node.js 20 ou plus récent.
• Une API HTTP existante avec au moins un point de terminaison authentifié.
• Un fournisseur d’identité pour vos utilisateurs — Auth0, Clerk, Cognito, WorkOS, ou votre propre OIDC.
• Une clé Anthropic, OpenAI ou AWS Bedrock-EU — ou utilisez une clé gérée (une légère majoration s’applique sur certaines offres).

1. Découvrez votre API

Exécutez la CLI dans votre projet. Elle détecte votre framework, lit vos routes, écrit un catalogue de capacités et le téléverse. La découverte est statique par défaut : elle lit votre code, ne l’exécute pas, et aucune donnée de production ne quitte votre machine.

npx syncanix init

L’enrichissement IA facultatif (titres et descriptions plus clairs) ne s’exécute qu’après votre consentement explicite de non-conservation des données dans l’invite. Vous pouvez aussi l’ignorer et enrichir plus tard.

2. Vérifiez le catalogue

Ouvrez le tableau de bord pour voir ce qui a été découvert. C’est là que vous décidez ce que l’assistant peut faire, et avec quelle prudence :

• Marquez les points de terminaison internes pour qu’ils restent hors de portée de l’assistant.
• Définissez l’effet de chaque action — lecture, écriture ou destruction — ce qui détermine la façon dont elle est confirmée.
• Exigez une authentification renforcée sur les actions sensibles, afin que l’utilisateur reconfirme son identité avant leur exécution.

3. Connectez votre backend

Ajoutez le SDK Node au service qui détient votre API. Il résout votre clé et démarre en quelques millisecondes :

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`);

Vous pouvez aussi enregistrer des outils natifs du SDK — des actions que l’assistant peut appeler et qui ne sont pas de simples routes HTTP. Chacune s’exécute avec l’identité de l’utilisateur final, fournie par votre fournisseur d’identité :

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. Intégrez le widget

Ajoutez une balise de script à votre application, avec votre clé publiable :

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

C’est tout. Le widget se charge de façon différée, s’exécute dans un Shadow DOM pour que vos styles et les nôtres n’entrent jamais en conflit, reprend automatiquement votre marque et est prêt pour le droite-à-gauche.

5. Connectez un client MCP (facultatif)

À partir des offres Growth, chaque espace de travail dispose aussi de son propre serveur MCP, de sorte que vos utilisateurs accèdent aux mêmes capacités depuis Claude Desktop, Cursor et ChatGPT. La connexion est fédérée à votre fournisseur d’identité.

6. Promouvez en production

Lorsque le comportement de l’assistant en développement vous convient, promouvez-le en production depuis le tableau de bord. Une étape d’évaluation s’exécute d’abord et bloque la promotion si la qualité régresse, de sorte que la production ne change que pour le mieux.

Ce que vous avez maintenant

• Un assistant intégré à votre application qui répond aux questions et exécute vos actions.
• Un serveur MCP par espace de travail pour Claude Desktop, Cursor et ChatGPT (Growth et au-delà).
• Une piste d’audit de chaque action, promotion et modification d’administration.
• Tout est hébergé dans l’UE, avec vos données chiffrées au repos.

Étapes suivantes