Connecter Claude ou un autre assistant IA à SynkriaOps

Connecter un assistant revient à lui donner l’adresse du serveur MCP de SynkriaOps, puis à autoriser l’accès depuis votre navigateur. À la fin de cette page, vous saurez ajouter SynkriaOps dans Claude ou dans un autre client MCP, créer une clé pour une automatisation sans navigateur, et vérifier que la connexion fonctionne.

Pré-requis

• L’accès machine est ouvert sur votre compte (sinon, contactez le support SynkriaOps).
• Vous avez le droit de connecter un assistant : rôle Administrateur, ou collaborateur autorisé par l’administrateur. Par défaut, aucun collaborateur n’est autorisé : voir La direction décide qui utilise un assistant IA.
• Un assistant capable de se connecter à un serveur MCP distant (voir ci-dessous).

L’adresse du serveur

https://mcp.synkriaops.com/mcp

Elle est aussi affichée dans SynkriaOps, Paramètres → Assistants IA et MCP, dans le bloc « Connectez vos assistants IA » (bouton « Copier l’adresse »). Saisissez-la exactement, avec /mcp à la fin.

Deux façons de se connecter

Méthode	Pour qui	Ce qui se passe
Connexion par navigateur (recommandée)	Claude, ou tout assistant qui sait ouvrir une autorisation dans le navigateur	Aucun secret à recopier. Vous autorisez l’accès sur une page SynkriaOps. Valable 90 jours.
Clé d’agent	Une automatisation sans navigateur (n8n, un script, un service)	Vous créez un secret dans SynkriaOps et le déployez vous-même, avec l’échéance de votre choix.

Le bloc « Configuration développeur », en bas de la page Assistants IA et MCP, résume ce même choix sous le titre « Quand utiliser quoi ».

Option 1 : connexion par navigateur

La connexion part toujours de l’assistant, jamais de SynkriaOps. Quand vous ajoutez l’adresse, l’assistant ouvre votre navigateur sur une page d’autorisation SynkriaOps.

Claude (web et bureau)

1. Copier l’adresse

   Dans SynkriaOps : Paramètres → Assistants IA et MCP, bouton « Copier l’adresse ».

2. Ajouter le connecteur dans Claude

   Dans Claude : Paramètres → Connecteurs → Ajouter un connecteur personnalisé. Donnez-lui un nom (par exemple « SynkriaOps ») et collez l’adresse.

3. Lancer la connexion

   Depuis la fiche du connecteur, lancez la connexion. Claude ouvre votre navigateur sur app.synkriaops.com. Connectez-vous à SynkriaOps si ce n’est pas déjà fait.

4. Autoriser l’accès

   L’écran « Autoriser Claude à accéder à… ? » s’affiche. Choisissez la société (ou votre cabinet et ses dossiers), le niveau d’accès, puis cliquez sur « Autoriser N accès ». Le détail de cet écran est dans Authentification et autorisations.

5. Revenir dans Claude

   Le navigateur vous renvoie vers Claude. Le connecteur est actif et ses outils sont disponibles dans vos conversations.

Libellés de Claude

Les noms de menus de l’étape 2 sont ceux de Claude, édité par Anthropic. Ils peuvent évoluer, et l’ajout de connecteurs personnalisés dépend de votre formule Claude : en cas de doute, consultez l’aide de Claude.

Claude Code

1. Déclarer le serveur

   Dans un terminal :

   claude mcp add --transport http synkriaops https://mcp.synkriaops.com/mcp

2. S’authentifier

   Dans une session Claude Code, tapez /mcp, choisissez synkriaops et lancez l’authentification. Votre navigateur s’ouvre sur la page d’autorisation SynkriaOps.

3. Autoriser l’accès

   Choisissez la société ou le cabinet, le niveau d’accès, puis « Autoriser N accès ». De retour dans le terminal, les outils SynkriaOps sont disponibles.

Autre client MCP

Tout assistant qui sait se connecter à un serveur MCP distant avec une autorisation par navigateur peut utiliser SynkriaOps. L’écran de SynkriaOps cite Claude, ChatGPT et Cursor. Ajoutez l’adresse https://mcp.synkriaops.com/mcp là où votre client déclare un serveur MCP distant, puis suivez l’autorisation dans le navigateur.

Pour les profils techniques

• Transport : HTTP, un seul point d’entrée POST https://mcp.synkriaops.com/mcp, jeton Authorization: Bearer en en-tête uniquement.
• Découverte : https://mcp.synkriaops.com/.well-known/oauth-protected-resource/mcp désigne le serveur d’autorisation https://app.synkriaops.com (métadonnées sur https://app.synkriaops.com/.well-known/oauth-authorization-server).
• OAuth 2.1, flux « code d’autorisation » uniquement, PKCE S256 obligatoire, paramètre resource=https://mcp.synkriaops.com/mcp.
• Le client se fait connaître par enregistrement dynamique (RFC 7591) ou par une URL https servant de client_id (document de métadonnées client).
• Adresses de retour acceptées : https, ou http sur localhost, 127.0.0.1 ou [::1].
• Pas de jeton de rafraîchissement : à l’échéance (90 jours), le client relance l’autorisation.

Option 2 : clé d’agent, sans navigateur

Une clé d’agent (ou jeton d’API) est un secret qui remplace l’autorisation par navigateur. Elle convient à une automatisation qui ne peut pas ouvrir de page web (voir Automatiser avec n8n pour des exemples complets). Elle se crée dans Paramètres → Assistants IA et MCP, section « Agents et automatisations ».

1. Ouvrir le formulaire

   Cliquez sur « Créer un agent ».

2. Nommer l’accès

   Champ « Nom » : un nom qui dit à quoi sert l’accès (par exemple « Relances n8n »).

3. Choisir l’usage

   Sous « À quoi va-t-il servir ? », choisissez « Clé API » pour une clé destinée au serveur MCP (voir l’avertissement ci-dessous).

4. Choisir les droits

   Sous « Ce que cet accès pourra faire », choisissez un niveau ou cochez les droits un par un. Vous ne pouvez accorder que ce que vous détenez vous-même.

5. Fixer une échéance (facultatif)

   « Expiration (facultatif) » : Jamais, 3 mois, 6 mois, 1 an, 2 ans ou Personnalisée. Sans date, la clé reste valable jusqu’à sa révocation.

6. Laisser les adresses vides

   « Adresses autorisées (facultatif) » limite la clé à certaines plages réseau. Pour un usage via le serveur MCP, laissez ce champ vide : les appels vers SynkriaOps partent alors du serveur MCP, pas de votre poste.

7. Créer la clé

   Cliquez sur « Créer l’agent ». SynkriaOps vous demande de confirmer votre identité.

8. Copier le secret

   Le bloc « Notez cette clé maintenant » affiche la clé une seule fois. Cliquez sur « Copier la clé », rangez-la dans un endroit sûr, puis « J’ai noté la clé, la masquer ».

Clé « Agent IA » créée avant le 10 novembre 2026

Les deux usages fonctionnent avec le serveur MCP. Une clé créée à la main avec l’usage « Agent IA » avant le 10 novembre 2026 était refusée (message MCP token audience is invalid for this resource.) : créez-en une nouvelle, puis révoquez l’ancienne.

Votre client se configure ensuite avec l’adresse et un en-tête d’autorisation. Le bloc « Configuration développeur » propose cet exemple :

{
  "mcpServers": {
    "synkriaops": {
      "url": "https://mcp.synkriaops.com/mcp",
      "headers": {
        "Authorization": "Bearer VOTRE_CLE_API"
      }
    }
  }
}

Une clé vaut vos droits

Ne partagez jamais une clé dans un dépôt de code, un navigateur partagé ou un message. Elle donne accès à vos livres sans mot de passe ni double authentification. Si elle fuit, révoquez-la immédiatement.

Vérifier que la connexion fonctionne

1. Poser une question simple

   Dans une nouvelle conversation, demandez par exemple : « Quel est l’exercice en cours dans SynkriaOps ? » ou « Liste mes journaux comptables ». Un expert-comptable connecté en cabinet peut demander : « Quels dossiers clients puis-je consulter ? »

2. Vérifier que l’assistant a appelé un outil

   La plupart des assistants signalent l’appel d’un outil (ici obtenir_exercice_courant, lister_journaux ou lister_dossiers_cabinet). La réponse doit reprendre vos données réelles.

3. Vérifier côté SynkriaOps

   Dans Paramètres → Assistants IA et MCP, l’accès apparaît sous « Applications connectées » (connexion par navigateur) ou « Agents et automatisations » (clé), avec la mention « utilisé » et la date du dernier appel.

Les noms d'outils suivent votre langue

L’assistant voit les outils en français ou en anglais selon la langue de votre profil SynkriaOps (à défaut, celle de la société) : obtenir_exercice_courant ou get_current_fiscal_year. Les deux noms sont acceptés.

Voir aussi

• Authentification et autorisations →
• Capacités de l’assistant →
• Dépanner la connexion →