Semurai MCP-server: koppel Claude en ChatGPT

MCP (Model Context Protocol) is de open standaard waarmee AI-assistenten verbinding maken met andere apps. Je voegt één adres toe in je assistent, keurt de koppeling één keer goed en vraagt daarna SEO- en contentwerk aan in de chat die je al gebruikt. Een overzicht van wat het je oplevert, staat op de pagina Semurai MCP-server.

Wat je kunt doen

Vraag het in je eigen woorden. De assistent kiest de juiste acties in Semurai, werkt in je werkruimte en vertelt wat hij heeft gedaan. Een paar voorbeelden per onderdeel:

SEO-onderzoek

Zoekwoordonderzoek en gerelateerde zoekwoorden, concurrentieanalyse en zoekwoordgaten, wie rankt op een zoekopdracht, een domeinoverzicht, live rankingchecks en topicclusters. Meer in Zoekwoordonderzoek.

Vind longtail-zoekwoorden over cold brew-koffie met een lage moeilijkheid.
Op welke zoekwoorden ranken mijn concurrenten en wij niet?
Bouw een topiccluster rond espresso thuis.

Rankings en Search Console

Gevolgde zoekwoorden en hun rankinggeschiedenis, nieuwe zoekwoorden om te volgen, rapporten uit Google Search Console (overzicht, topzoekopdrachten, toppagina's, trends in zoekopdrachten en kansen), pagina-audits, volledige site-audits en prestatierapporten.

Hoe hebben onze gevolgde zoekwoorden zich deze maand ontwikkeld?
Laat de zoekopdrachten uit Search Console zien met veel vertoningen en een lage CTR.
Doe een volledige SEO-audit van onze website en zet de belangrijkste verbeteringen op een rij.

Content

Je artikelen en documenten zoeken en lezen, outlines maken, SEO-artikelen schrijven met plaatshouders voor afbeeldingen, content bijwerken, documenten en e-mailconcepten maken, content en campagnes plannen, marketingmomenten vinden en suggesties voor interne links krijgen.

Schrijf op basis van ons zoekwoordonderzoek een SEO-artikel over het kiezen van een koffiemolen.
Plan een maand blogcontent voor onze webshop.
Stel interne links voor bij het artikel over espressomachines.

Conceptposts voor social media (tekst), een lijst van je posts, de contentkalender en het inplannen van content en socialmediaposts.

Schrijf drie LinkedIn-posts die ons nieuwste artikel promoten.
Wat staat er volgende week in de contentkalender?
Plan de LinkedIn-post over de herfstmelange in voor vrijdag om 9:00 uur.

Publiceren

Artikelen publiceren op WordPress, PrestaShop of de Shoper-blog. In WordPress kan de assistent ook berichten bekijken en SEO-wijzigingen voorbereiden, doorvoeren of verwerpen.

Publiceer het artikel over koffiemolens op onze Shoper-blog.
Controleer de SEO van onze vijf nieuwste WordPress-berichten en bereid verbeteringen voor.

E-commerce

Werk met je gekoppelde webshops op Shoper, WooCommerce en PrestaShop: producten en categorieën zoeken, SEO-voorstellen maken voor producten, categorieën en alt-teksten van afbeeldingen, goedgekeurde voorstellen doorvoeren en Shoper-producten importeren. Meer in Webshop.

Vind producten zonder metabeschrijving en maak SEO-voorstellen.
Schrijf alt-teksten voor de afbeeldingen in de categorie Koffiemolens.
Voer de goedgekeurde voorstellen door in de webshop.

Media en taken

De mediabibliotheek doorzoeken, media toevoegen via een URL, gegevens bijwerken en mappen ordenen. Taken bekijken, aanmaken en bijwerken, en een taak toewijzen aan een van de agents van Semurai.

Zet de productfoto's van vorige week in een map Voorjaarscampagne.
Maak een taak om het prijsartikel te vernieuwen en wijs die toe aan Tenko.

Koppel je assistent

Alle assistenten gebruiken hetzelfde serveradres. Kopieer het en volg de stappen voor je assistent. Hetzelfde adres en korte instructies vind je in de Semurai-app onder Instellingen → AI-assistenten (MCP).

https://api.semur.ai/mcp

Claude (web en desktop-app)

Open in Claude Customize → Connectors.
Klik op + Add en kies Add custom connector.
Vul een naam in, bijvoorbeeld Semurai, plak het serveradres en klik op Continue en daarna op Add.
Klik op Connect en keur de koppeling goed op de Semurai-pagina.

Bij de Claude-abonnementen Team en Enterprise voegt een Owner van de organisatie de connector één keer toe in Organization settings → Connectors → Add → Custom → Web. Leden klikken daarna op Connect en loggen in met hun eigen Semurai-account. Met het Free-abonnement kun je één aangepaste connector toevoegen. Wat Claude met Semurai kan, met voorbeeldprompts: Claude voor SEO.

ChatGPT

Open in ChatGPT op het web Plugins en klik op +.
Kies Add custom MCP server, vul een naam in en plak het serveradres.
Kies bij authenticatie OAuth, vink I understand and want to continue aan en klik op Create.
Keur de koppeling goed op de Semurai-pagina.

Volledige acties (schrijven) in ChatGPT: abonnementen Business, Enterprise en Edu. Met Pro koppelen aangepaste MCP-servers in alleen-lezenmodus. Aangepaste MCP-servers voeg je toe in ChatGPT op het web. Toepassingen en prompts om te proberen vind je bij ChatGPT voor SEO.

Claude Code

Voer deze opdracht uit in je terminal:

claude mcp add --transport http --scope user semurai https://api.semur.ai/mcp

Met de optie --scope user staat Semurai in al je projecten. Log daarna in bij Semurai met claude mcp login semurai of typ /mcp in Claude Code. SEO-werk vanuit de terminal, met voorbeelden: Claude Code voor SEO.

Codex

Voer deze opdracht uit in je terminal:

codex mcp add semurai --url https://api.semur.ai/mcp

Log daarna in bij Semurai met codex mcp login semurai. Je kunt de server ook toevoegen in ~/.codex/config.toml:

config.toml

[mcp_servers.semurai]
url = "https://api.semur.ai/mcp"

De Codex-extensie voor IDE’s en de Codex-desktopapp gebruiken dezelfde configuratie. Je kunt de server daar ook toevoegen via Settings → MCP servers → Add server, met het type Streamable HTTP. Meer over werken met Semurai in Codex: Codex MCP.

Cursor

Voeg de server toe aan ~/.cursor/mcp.json om hem in al je projecten te gebruiken, of aan .cursor/mcp.json in één project:

mcp.json

{
  "mcpServers": {
    "semurai": {
      "url": "https://api.semur.ai/mcp"
    }
  }
}

VS Code (GitHub Copilot)

GitHub Copilot gebruikt in agentmodus de servers uit .vscode/mcp.json in je project:

.vscode/mcp.json

{
  "servers": {
    "semurai": {
      "type": "http",
      "url": "https://api.semur.ai/mcp"
    }
  }
}

Klik in het bestand op Start boven de server en log in bij Semurai. Voorbeelden voor Copilot in agentmodus: VS Code MCP.

Andere assistenten

Elke assistent die externe MCP-servers met OAuth-aanmelding ondersteunt, koppel je op dezelfde manier: voeg https://api.semur.ai/mcp toe als serveradres.

Gemini CLI: voeg de server toe met deze opdracht en log daarna in met /mcp auth semurai in Gemini CLI.

gemini mcp add --transport http semurai https://api.semur.ai/mcp

In het bestand settings.json van Gemini CLI staat het adres onder de sleutel httpUrl:

settings.json

{
  "mcpServers": {
    "semurai": {
      "httpUrl": "https://api.semur.ai/mcp"
    }
  }
}

Volledige server met AI-visuals

Het adres hierboven is de officiële server, voor de app-directory’s van Claude en ChatGPT en het dagelijkse werk. Semurai heeft ook een volledige server: dezelfde login en dezelfde tools, plus AI-visuals. Je voegt hem zelf toe als eigen connector, met dit adres:

https://api.semur.ai/mcp/full

Met de volledige server kan je assistent ook:

afbeeldingen maken voor social berichten en artikelen,
ontwerpen maken in Canvas,
ontwerpen maken in Creative Studio,
aan je ontwerpen in Creative Studio werken: de modus kiezen, de vragen van de ontwerper beantwoorden, een ontwerp aanpassen en teruggaan naar een eerdere versie of een variant,
beelden voor sociale media, carrousels en advertenties uit Creative Studio in je mediabibliotheek opslaan en aan social berichten toevoegen,
ontwerpideeën voor je merk voorstellen,
AI-beschrijvingen en alt-teksten schrijven voor de afbeeldingen in je mediabibliotheek.

De volledige server toevoegen

Claude: klik in Customize → Connectors op + Add, kies Add custom connector en plak het adres van de volledige server.
ChatGPT: klik in Plugins op +, kies Add custom MCP server en plak het adres van de volledige server.
Cursor en VS Code: gebruik dezelfde mcp.json als hierboven, met het adres van de volledige server.

Voer in Claude Code uit:

claude mcp add --transport http --scope user semurai-full https://api.semur.ai/mcp/full

Voer in Codex uit:

codex mcp add semurai-full --url https://api.semur.ai/mcp/full

Een koppeling die je voor de officiële server hebt goedgekeurd, werkt met de officiële server. Voor de volledige server voeg je hem toe als aparte connector en keur je de koppeling goed op de Semurai-pagina. Log in Claude Code en Codex in met claude mcp login semurai-full of codex mcp login semurai-full. Visuals die via de volledige server worden gemaakt, tellen mee voor de gebruikslimieten van de werkruimte, net als visuals uit de app.

Eerste koppeling en werkruimtes

Bij de eerste koppeling opent de assistent een Semurai-pagina. Log in als je nog niet bent ingelogd en daarna:

Controleer de naam van de app en het adres waar je browser naar terugkeert. Beide staan op de pagina.
Kies de Standaardwerkruimte.
Klik op Toestaan. De browser brengt je terug naar de assistent, klaar om te werken.

De assistent werkt in de standaardwerkruimte. Als je erom vraagt, toont hij je andere werkruimtes, werkt hij in elk daarvan en wisselt hij de standaard, bijvoorbeeld: Welke werkruimtes heb ik? Schakel over naar de werkruimte van de webshop.

Langer werk loopt op de achtergrond: een artikel schrijven, een volledige site-audit, een contentplan, socialmediaposts of een topiccluster. De assistent volgt de voortgang en brengt je het resultaat zodra het klaar is. De concepten verschijnen in de Semurai-app: in de Bibliotheek, de contentkalender en bij je socialmediaposts.

Beheren en ontkoppelen

Open in de Semurai-app Instellingen → AI-assistenten (MCP). Daar vind je:

beide serveradressen (officieel en volledig) met kopieerknoppen en korte instructies per assistent,
de gekoppelde apps, met de datum van koppeling en het laatste gebruik van elke app,
de standaardwerkruimte van elke app, die je altijd kunt wijzigen,
Ontkoppelen, waarmee de toegang van de app direct stopt.

Wil je een ontkoppelde assistent weer gebruiken, koppel hem dan opnieuw vanuit de assistent.

Veiligheid en gebruikslimieten

Jij bevestigt wat Semurai verlaat. Publiceren of inplannen buiten Semurai (WordPress, de PrestaShop- of Shoper-blog, sociale netwerken) en wijzigingen doorvoeren in een webshop of op een WordPress-site zijn aparte acties, en de assistent vraagt je elke actie te bevestigen.
Webshopwijzigingen beginnen als voorstel. SEO-wijzigingen voor producten, categorieën en afbeeldingen worden eerst als voorstel gemaakt, en alleen de voorstellen die je goedkeurt komen in de webshop.
Jouw rol geldt. De assistent werkt in elke werkruimte met jouw rol. Met de rol Kijker kan hij alleen basisinformatie over de werkruimte lezen.
Dezelfde gebruikslimieten. Acties van een assistent tellen mee voor dezelfde gebruikslimieten als je werk in de app.

Problemen oplossen

De koppelingslink is verlopen: de goedkeuringspagina is 10 minuten geldig. Start de koppeling opnieuw vanuit de assistent.
De assistent zegt dat hij geen toegang meer heeft: koppel hem opnieuw. Onder Instellingen → AI-assistenten (MCP) zie je of de app is ontkoppeld.
De gebruikslimiet is op: wacht tot hij wordt vernieuwd en vraag het dan opnieuw.
Een tool meldt dat een integratie niet gekoppeld is: koppel Google Search Console, WordPress of je webshop onder Instellingen → Integraties en vraag het dan opnieuw. Zie Je website of webshop koppelen.

Hoe verder

IntegratiesKoppel Search Console, WordPress en je webshop.
BibliotheekBekijk de concepten die je assistent heeft gemaakt.
ContentkalenderGeplande artikelen en posts op één plek.
AI-agentsMaak kennis met de agents van Semurai en het werk dat ze oppakken.
Semurai MCP-serverWat elke assistent met Semurai kan, met voorbeeldprompts.