← Terug naar het helpcentrum

Siggmund koppelen aan uw AI-assistent (MCP)

Waar het voor dient

MCP (Model Context Protocol) is een standaard waarmee een AI-assistent, zoals Claude, een externe dienst kan raadplegen. Is Siggmund eenmaal gekoppeld, dan stelt u uw vragen gewoon aan uw assistent en die leest uw Siggmund-metingen om te antwoorden: waar u staat, wat er sinds vorige week is veranderd, wie u voor is.

Met een organisatiesleutel (shg_) is de toegang alleen-lezen en beperkt tot uw gegevens (inloggen met Google in claude.ai en ChatGPT, hieronder beschreven, geeft iets meer). Uw assistent kan niets wijzigen bij Siggmund, geen rapport genereren en geen andere klant zien.

Twee manieren om Siggmund te koppelen

  • Zonder sleutel, met uw Google-account: vanuit claude.ai of ChatGPT. U voegt Siggmund toe als connector en logt in met Google, zonder iets te kopiëren. Elk lid van een organisatie kan het doen, niet alleen beheerders.
  • Met een sleutel: voor Claude Code, Claude Desktop, Cursor en andere clients die u met een opdracht of een bestand instelt (secties hieronder).

In claude.ai

  1. Open in claude.ai Settings (Instellingen), dan Connectors (Connectors) en kies Add custom connector (Aangepaste connector toevoegen). Afhankelijk van uw abonnement kan deze optie voorbehouden zijn aan de beheerders van uw Claude-werkruimte.
  2. Geef de naam "Siggmund" en het adres https://mcp.siggmund.com/mcp op en bevestig.
  3. Klik op Connect (Verbinden). Er opent een Google-venster: kies het Google-account waarvan het e-mailadres dat van uw Siggmund-toegang is en accepteer. Siggmund vraagt Google alleen om uw e-mailadres.
  4. Zet in een gesprek de Siggmund-connector aan en stel uw vraag.

In ChatGPT

  1. Open in ChatGPT Settings (Instellingen), dan Apps (of Connectors) en zet de Developer mode (ontwikkelaarsmodus) aan als ChatGPT die vraagt om een MCP-server toe te voegen.
  2. Maak een connector aan: naam "Siggmund", adres van de MCP-server https://mcp.siggmund.com/mcp, authenticatie OAuth.
  3. Sla op en log in met uw Google-account, zoals in claude.ai (stap 3 hierboven).
  4. Voeg in een gesprek Siggmund toe aan de gebruikte tools en stel uw vraag.

Wat u moet weten over inloggen met Google

  • Uw toegang is die van uw e-mailadres in Siggmund: u ziet de klanten die u ook in de applicatie ziet. Een Google-account met een ander adres logt in, maar ziet geen enkele Siggmund-tool.
  • Wat de assistent kan doen: uw gegevens lezen, een rapport of een presentatie maken en ons support schrijven. Hij ziet alleen de klanten van uw eigen toegang, nooit die van een ander.
  • Een ingetrokken toegang wordt na ongeveer een minuut afgesloten. Om zelf los te koppelen verwijdert u de connector in claude.ai of ChatGPT.

Voordat u begint: een sleutel aanmaken

Deze sectie en de drie volgende gaan over koppelingen met een sleutel (Claude Code, Claude Desktop, Cursor). Vanuit claude.ai of ChatGPT hebt u geen sleutel nodig: zie hierboven.

De beheerders van de organisatie kunnen een sleutel aanmaken. Voelt u zich niet thuis in een terminal of een configuratiebestand, geef deze gids dan door aan de persoon die uw tools beheert.

  1. Open Koppelingen in het menu en daarna de sectie MCP-toegang.
  2. Open de kaart MCP-toegangssleutels en geef de sleutel een naam, bijvoorbeeld "Claude van Marie".
  3. Kies de levensduur: 1 dag, 1 week, 1 maand, 1 jaar of zonder vervaldatum.
  4. Klik op De sleutel aanmaken en kopieer hem. Hij begint met shg_.

De sleutel wordt maar één keer getoond. Siggmund bewaart de waarde niet: raakt u hem kwijt, maak dan een andere aan.

Wat u nodig hebt

  • Het adres van de server: https://mcp.siggmund.com/mcp (hebt u het oude run.app-adres geconfigureerd, dan blijft dat geldig)
  • Uw sleutel, doorgegeven in een HTTP-header: Authorization: Bearer shg_…

Vervang shg_… in de voorbeelden hieronder door uw sleutel.

In Claude Code

Voer in een terminal uit:

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

Wilt u dat de koppeling in al uw projecten werkt, voeg dan --scope user toe vóór het adres. Zonder dat geldt ze alleen voor de huidige map.

Controleer daarna: claude mcp list moet siggmund tonen met de vermelding "Connected". In Claude Code geeft de opdracht /mcp dezelfde status. Een mislukking met code 401 betekent dat de sleutel onjuist, ingetrokken of verlopen is.

In Claude Desktop

Het menu Connectors van Claude Desktop biedt geen veld voor een sleutel. Siggmund wordt daarom gekoppeld via het configuratiebestand, met de kleine brug mcp-remote. Daarvoor moet Node.js zijn geïnstalleerd.

  1. Open in Claude Desktop Settings (Instellingen), tabblad Developer, en klik op Edit Config. Het bestand claude_desktop_config.json opent. Het staat in ~/Library/Application Support/Claude/ op macOS en in %APPDATA%\Claude\ op Windows.
  2. Voeg het blok siggmund toe (behoud uw andere servers als die er zijn):
JSON
{
  "mcpServers": {
    "siggmund": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.siggmund.com/mcp",
        "--header",
        "Authorization:${SIGGMUND_AUTH}"
      ],
      "env": {
        "SIGGMUND_AUTH": "Bearer shg_…"
      }
    }
  }
}
  1. Sla op, sluit Claude Desktop volledig af en start het opnieuw.
  2. Open in het invoerveld het menu Connectors: siggmund moet er staan met zijn tools.

De ontbrekende spatie na Authorization: is bedoeld: ze voorkomt dat Windows de waarde in tweeën knipt. De sleutel staat in de env-invoer, niet in de opdrachtregel.

In Cursor (of een andere compatibele client)

Cursor kan een header rechtstreeks meesturen, zonder brug. In het bestand ~/.cursor/mcp.json (voor al uw projecten) of .cursor/mcp.json (voor één project):

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

Definieer de omgevingsvariabele SIGGMUND_KEY met uw sleutel (zonder het woord Bearer) en start Cursor opnieuw.

Voor elke andere MCP-client: kies een externe server met HTTP-transport ("Streamable HTTP"), geef het adres hierboven op en voeg de header Authorization: Bearer shg_… toe.

Vragen die u kunt stellen

Uw assistent kiest zelf de passende tool. Hier zijn vragen die Siggmund vandaag kan beantwoorden, en wat de assistent daarvoor leest.

U vraagtWat de assistent raadpleegt
"Waarop word ik gemeten?"Uw omzetlijnen en hun ingangen
"Wat is mijn score op elk van mijn ingangen, engine per engine?"Uw indicatoren: vermeldingspercentage, voorkeur, score
"Wie staat er op ChatGPT voor mij bij deze omzetlijn?"De rangschikking van uw concurrenten per engine
"Wat is er veranderd sinds de laatste meting?"De samenvatting van de week: uw metingen, de concurrenten, de meer of minder geciteerde sites
"Welke sites citeren AI's als het over mijn markt gaat?"De geciteerde sites en pagina's: de uwe, die van uw concurrenten of van derden
"Waar stond ik vorige maand?"De lijst van uw eerdere metingen en daarna de meting van de gewenste datum
"Wat verwijten kopers mijn prijzen?"De antwoorden van AI's en gesimuleerde koperbeoordelingen
"Hoe heeft Siggmund mijn activiteit begrepen?"Uw profiel: beroep, omzetlijnen, reputatiezorgen
"Wat betekent de aanbevelingsscore?"De definities van Siggmund
"Wat zegt het onderzoek over hoe AI's hun bronnen kiezen?"De bibliotheek met GEO-studies

U kunt ook om een kruistabel van uw cijfers vragen (bijvoorbeeld "rangschik mijn ingangen van laagste naar hoogste score"): de assistent bevraagt dan rechtstreeks uw gegevens.

Wat MCP met een sleutel van dit type niet doet: een rapport of presentatie maken, onze support schrijven, uw account wijzigen.

Beveiliging

  • De sleutel wordt maar één keer getoond. Kopieer hem in uw tool zodra hij verschijnt. Hij is niet terug te vinden en wordt niet per e-mail teruggestuurd.
  • Deel hem niet en plak hem niet in een gedeeld document, een e-mail of een coderepository. Eén sleutel per persoon of per tool maakt het mogelijk één toegang af te sluiten zonder anderen te hinderen.
  • Kies een korte levensduur als u geen permanente toegang nodig hebt. Een verlopen sleutel wordt bij de volgende aanroep geweigerd.
  • Trek hem op elk moment in onder Koppelingen, sectie MCP-toegang, via de intrekknop van de sleutel: de toegang wordt onmiddellijk afgesloten. Doe dit zodra u vermoedt dat hij is gelekt.
  • De organisatiesleutel (shg_) geeft alleen toegang tot uw organisatie, alleen-lezen.

Als het niet werkt

  • 401 of "Failed to connect": de sleutel is verkeerd gekopieerd, ingetrokken of verlopen. Controleer de lijst onder Koppelingen en maak zo nodig een nieuwe aan.
  • De server verschijnt niet in Claude Desktop: is Node.js geïnstalleerd? Hebt u de applicatie volledig afgesloten voordat u haar opnieuw startte? Het configuratiebestand moet geldige JSON zijn (komma's, aanhalingstekens).
  • Eerste aanroep traag: de dienst heeft soms enkele seconden nodig om wakker te worden. Probeer het opnieuw.
  • De assistent vindt geen Siggmund-tool: controleer of de server is ingeschakeld in de instellingen van uw assistent en vraag hem uitdrukkelijk Siggmund te gebruiken.
  • Inloggen met Google mislukt of verloopt (claude.ai, ChatGPT): de service heeft soms enkele seconden nodig om wakker te worden en claude.ai geeft na ongeveer 10 seconden op. Start de koppeling opnieuw.
  • Ingelogd, maar geen Siggmund-tool: het adres van het Google-account is niet dat van uw Siggmund-toegang. Verwijder de connector, log opnieuw in met het juiste adres of vraag een beheerder u toe te voegen onder Leden.

Laatst bijgewerkt: · Eerste publicatie: