Démarrage rapide

Ce guide vous mène d'une application existante à un assistant Syncanix en service, dans l'ordre où cela se fait vraiment : ajoutez le script, cartographiez votre site, puis publiez les guides qu'il rédige à partir de ce qu'il a trouvé. La revue et la mise en production encadrent cette séquence. Deux étapes sont facultatives et signalées comme telles — une analyse plus poussée de votre code, et la connexion directe de votre backend.

Avant de commencer

• Un espace de travail Syncanix — contactez notre service commercial sur syncanix.com/contact pour 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 l’accès géré au modèle, inclus dans votre offre.

1. Configurez votre espace de travail et vos clés

La CLI de découverte téléverse dans un espace de travail Syncanix, et le widget s’authentifie avec une clé publiable — créez donc l’espace de travail et récupérez les deux clés avant de lancer quoi que ce soit.

1. 1
   Obtenez votre espace de travailContactez notre service commercial sur syncanix.com/contact pour obtenir votre espace de travail. Le tableau de bord est l’endroit où vivent votre catalogue, vos clés d’API et la configuration de votre widget.
2. 2
   Connectez-vous depuis la CLIExécutez npx syncanix login : votre navigateur ouvre le tableau de bord pour approuver cet appareil, et la CLI enregistre une session liée à votre compte dans ~/.syncanix/credentials afin qu'init puisse téléverser votre catalogue. Machine sans interface ? Exécutez npx syncanix login --key et collez une clé machine depuis Paramètres → Clés d'API.
3. 3
   Copiez votre clé publiableDepuis Paramètres → Clés d’API dans le tableau de bord, copiez votre clé publiable (pk_live_…). L’extrait d’intégration du widget l’utilise comme data-key — elle peut être exposée dans le navigateur sans risque.

npx syncanix login

2. Intégrez le widget

Ajoutez une balise de script à votre application, avec votre clé publiable. C’est toute l’installation : aucun paquet à ajouter, aucun code à modifier.

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

3. Laissez-le lire votre produit

Une fois le widget en place, l’agent détermine ce que votre produit sait faire en le regardant. Cela se produit de deux manières, et vous n’avez pas à choisir : la première est délibérée et rapide, la seconde tourne discrètement ensuite.

1. 1
   Cartographiez votre site, en une passeLancez la cartographie depuis le tableau de bord et parcourez votre produit dans votre navigateur, connecté avec votre compte. Il note chaque écran au fil de l'eau. Rien n'est envoyé depuis autre chose que l'onglet où vous êtes.
2. 2
   Puis en continu, au fil des déplacements de vos utilisateursUne fois en service, il continue de lire les écrans que les gens visitent réellement : une page publiée le mardi est connue le mardi. Personne n’ouvre de ticket pour le lui apprendre.

4. Passez en revue ce qu’il a trouvé

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.

5. Facultatif : lire votre source pour les formes exactes

Lire un écran indique à l'agent ce qu'une personne peut y faire. Lire votre source lui indique exactement ce que votre logiciel accepte — les noms de paramètres, les types, ce qui est obligatoire — et trouve des capacités que personne n'a encore visitées. C'est la voie plus approfondie, pas la plus difficile : aucun fichier source ne quitte votre machine. Lancez-la depuis votre dépôt :

npx syncanix init

6. Facultatif : connectez votre backend

Lorsque vous l'ajoutez, installez le SDK sur le service qui détient votre API. Il démarre en quelques millisecondes et garde votre catalogue à jour grâce à la détection des changements à l'exécution :

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

7. Connectez un client IA

Chaque espace de travail dispose aussi de son propre serveur MCP, afin que vos utilisateurs atteignent les mêmes capacités depuis Claude Desktop, Cursor et ChatGPT. La connexion est fédérée à votre fournisseur d’identité.

8. Passez 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.
• 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