← Retour au centre d'aide

Connecter Siggmund à votre assistant IA (MCP)

À quoi ça sert

Le MCP (Model Context Protocol) est un standard qui permet à un assistant IA, comme Claude, de consulter un service externe. Une fois Siggmund connecté, vous posez vos questions en français à votre assistant, et il va lire vos mesures Siggmund pour y répondre : où vous en êtes, ce qui a bougé depuis la semaine dernière, qui vous devance.

L'accès est en lecture seule et limité à vos données. Votre assistant ne peut ni modifier quoi que ce soit chez Siggmund, ni générer de rapport, ni voir un autre client.

Avant de commencer : créer une clé

Les administrateurs de l'organisation peuvent créer une clé. Si vous n'êtes pas à l'aise avec un terminal ou un fichier de configuration, transmettez ce guide à la personne qui gère vos outils.

  1. Ouvrez Connexions dans le menu, puis la section Accès MCP.
  2. Ouvrez la carte Clés d'accès MCP et donnez un nom à la clé, par exemple « Claude de Marie ».
  3. Choisissez sa durée de vie : 1 jour, 1 semaine, 1 mois, 1 an, ou sans expiration.
  4. Cliquez sur Créer la clé et copiez-la. Elle commence par shg_.

La clé ne s'affiche qu'une seule fois. Siggmund n'en garde pas la valeur : si vous la perdez, créez-en une autre.

Ce dont vous avez besoin

  • L'adresse du serveur : https://mcp.siggmund.com/mcp (si vous avez configuré l'ancienne adresse en run.app, elle reste valide)
  • Votre clé, transmise dans un en-tête HTTP : Authorization: Bearer shg_…

Remplacez shg_… par votre clé dans les exemples ci-dessous.

Dans Claude Code

Dans un terminal, lancez :

Terminal
claude mcp add --transport http siggmund https://mcp.siggmund.com/mcp \
  --header "Authorization: Bearer shg_…"

Pour que la connexion serve dans tous vos projets, ajoutez --scope user avant l'adresse. Sans cela, elle ne vaut que pour le dossier courant.

Vérifiez ensuite : claude mcp list doit afficher siggmund avec la mention « Connected ». Dans Claude Code, la commande /mcp donne le même état. Un échec avec un code 401 veut dire que la clé est fausse, révoquée ou expirée.

Dans Claude Desktop

Le menu Connecteurs de Claude Desktop ne propose pas de champ pour une clé. On branche donc Siggmund par le fichier de configuration, avec le petit pont mcp-remote. Il demande que Node.js soit installé.

  1. Dans Claude Desktop, ouvrez Settings (Paramètres), onglet Developer, puis cliquez sur Edit Config. Le fichier claude_desktop_config.json s'ouvre. Il se trouve dans ~/Library/Application Support/Claude/ sous macOS et dans %APPDATA%\Claude\ sous Windows.
  2. Ajoutez le bloc siggmund (gardez vos autres serveurs s'il y en a) :
JSON
{
  "mcpServers": {
    "siggmund": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.siggmund.com/mcp",
        "--header",
        "Authorization:${SIGGMUND_AUTH}"
      ],
      "env": {
        "SIGGMUND_AUTH": "Bearer shg_…"
      }
    }
  }
}
  1. Enregistrez, puis quittez complètement Claude Desktop et relancez-le.
  2. Dans la zone de saisie, ouvrez le menu Connecteurs : siggmund doit y figurer avec ses outils.

L'espace manquant après Authorization: est voulu : il évite que Windows coupe la valeur en deux. La clé se trouve dans l'entrée env, pas dans la ligne de commande.

Dans Cursor (ou un autre client compatible)

Cursor sait envoyer un en-tête directement, sans pont. Dans le fichier ~/.cursor/mcp.json (pour tous vos projets) ou .cursor/mcp.json (pour un projet) :

JSON
{
  "mcpServers": {
    "siggmund": {
      "url": "https://mcp.siggmund.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SIGGMUND_KEY}"
      }
    }
  }
}

Définissez la variable d'environnement SIGGMUND_KEY avec votre clé (sans le mot Bearer), puis relancez Cursor.

Pour tout autre client MCP : choisissez un serveur distant en transport HTTP (« Streamable HTTP »), donnez l'adresse ci-dessus et ajoutez l'en-tête Authorization: Bearer shg_….

Des questions à poser

Votre assistant choisit lui-même l'outil qui convient. Voici des questions que Siggmund sait traiter aujourd'hui, et ce que l'assistant va lire.

Vous demandezCe que l'assistant consulte
« Sur quoi suis-je mesuré ? »Vos lignes de revenu et leurs points d'entrée
« Quel est mon score sur chacun de mes points d'entrée, moteur par moteur ? »Vos indicateurs : taux de citation, préférence, score
« Qui est devant moi sur ChatGPT pour cette ligne de revenu ? »Le classement de vos concurrents par moteur
« Qu'est-ce qui a changé depuis la dernière mesure ? »Le résumé de la semaine : vos mesures, les concurrents, les sites plus ou moins cités
« Quels sites les IA citent-elles quand on leur parle de mon marché ? »Les sites et les pages cités, les vôtres, ceux de vos concurrents ou des tiers
« Où en étais-je le mois dernier ? »La liste de vos mesures passées, puis la mesure de la date voulue
« Que reprochent les acheteurs à mes prix ? »Les réponses des IA et les avis d'acheteurs simulés
« Comment Siggmund a-t-il compris mon activité ? »Votre fiche : métier, lignes de revenu, préoccupations de réputation
« Que veut dire le score de recommandabilité ? »Les définitions de Siggmund
« Que dit la recherche sur la façon dont les IA choisissent leurs sources ? »La bibliothèque d'études sur le GEO

Vous pouvez aussi demander un tableau croisé de vos chiffres (par exemple « classe mes points d'entrée du plus faible au plus fort score ») : l'assistant interroge alors directement vos données.

Ce que le MCP ne fait pas avec une clé de ce type : produire un rapport ou une présentation, écrire à notre support, modifier votre compte.

Sécurité

  • La clé ne s'affiche qu'une fois. Copiez-la dans votre outil dès qu'elle apparaît. Elle n'est ni retrouvable, ni renvoyée par e-mail.
  • Ne la partagez pas et ne la collez ni dans un document partagé, ni dans un e-mail, ni dans un dépôt de code. Une clé par personne ou par outil permet de couper un accès sans gêner les autres.
  • Choisissez une durée de vie courte si vous n'avez pas besoin d'un accès permanent. Une clé expirée est refusée dès l'appel suivant.
  • Révoquez-la à tout moment dans Connexions, section Accès MCP, via le bouton de révocation de la clé : l'accès est coupé immédiatement. Faites-le dès que vous soupçonnez qu'elle a fuité.
  • La clé ne donne accès qu'à votre organisation, en lecture seule.

Si ça ne marche pas

  • 401 ou « Failed to connect » : la clé est mal copiée, révoquée ou expirée. Vérifiez la liste dans Connexions, et créez-en une nouvelle au besoin.
  • Le serveur n'apparaît pas dans Claude Desktop : Node.js est-il installé ? Avez-vous quitté complètement l'application avant de la relancer ? Le fichier de configuration doit être du JSON valide (virgules, guillemets).
  • Premier appel lent : le service peut mettre quelques secondes à se réveiller. Réessayez.
  • L'assistant ne trouve pas d'outil Siggmund : vérifiez que le serveur est activé dans les réglages de votre assistant, et demandez-lui explicitement d'utiliser Siggmund.

Dernière mise à jour : · Première publication :