Promptwatch MCP koppelen aan Claude en Cursor
Praktische gids om de Promptwatch MCP-server te koppelen aan Claude en Cursor. Van Bearer-key tot read-only keys die schrijf-tools verbergen, met voorbeelden van echte toolnamen.
De Promptwatch MCP-server draait op een gehoste streamable HTTP-endpoint op https://server.promptwatch.com/mcp. Je verbindt ermee via OAuth of een Bearer-key. De ChatGPT-plugin en de Claude Connector lopen erop, en Cursor verbindt via een .cursor/mcp.json-bestand in je project. Deze gids laat zien hoe je de koppeling legt in Claude en Cursor, welke tools je daarna krijgt, en hoe je een read-only key instelt die de schrijf-tools verbergt.
Het voordeel van MCP boven een dashboard is dat je in één gesprek meet, diagnoseert en handelt. Je vraagt je agent: welke prompts zakken weg deze week, welke pagina pakt ChatGPT als bron, en welke content gap moet ik als eerste aanpakken. De agent haalt de data via read-tools en kan via schrijf-tools een rapport maken of content publiceren. Je blijft zelf de controle over wat gewijzigd wordt.
Stap 1: een API-key aanmaken
In Promptwatch maak je een API-key aan in je accountinstellingen. Je krijgt een Bearer-token dat je bewaart als een geheim. Deel het niet in een publieke repo of in een screenshot. Je gebruikt deze key in je MCP-config, en je kunt later een aparte read-only key maken voor agents die alleen hoeven te lezen.
De gratis Explore-versie geeft 10 prompts op ChatGPT en één project. Essential 95 dollar per maand geeft 50 prompts, 6.000 responses en 200.000 visitorevents. Professional 245 dollar per maand geeft 150 prompts, 25 miljoen crawlerlogs en 1 miljoen visitorevents. Business 579 dollar per maand voor vijf projecten. Bureaus gebruiken Kick-off 199 dollar, Growth 399 dollar of Scale 799 dollar per maand. De MCP-server werkt op elk plan, maar de hoeveelheid data die je terugkrijgt hangt af van je limieten.
Stap 2: koppelen in Cursor
Cursor leest MCP-servers uit een .cursor/mcp.json-bestand dat in de root van je project staat. Maak het bestand aan als het nog niet bestaat en voeg de Promptwatch-server toe. Een minimale config ziet er zo uit:
{
"mcpServers": {
"promptwatch": {
"url": "https://server.promptwatch.com/mcp",
"headers": {
"Authorization": "Bearer jouw-token-hier"
}
}
}
}
Vervang jouw-token-hier door je Bearer-key. Herstart Cursor of herlaad de MCP-verbinding in de instellingen. Cursor toont de server in de MCP-lijst, en de tools worden beschikbaar in de chat. Je vraagt daarna in gewone taal: haal de topcrawlerpagina's van deze maand op, of laat de content gaps zien voor deze prompts. Cursor kiest de juiste tool.
Een detail dat vaak fout gaat: de key in je repo checken. Voeg .cursor/mcp.json toe aan je .gitignore of gebruik een omgevingsvariabele die je lokaal invult. Een gelekte key is herroepbaar in Promptwatch, maar liever voorkom je het.
Stap 3: koppelen in Claude
Voor de Claude desktop-app voeg je de server toe via de MCP-config van Claude. De Claude Connector gebruikt hetzelfde endpoint. Je kunt de server toevoegen via de instellingen of via een config-bestand, afhankelijk van je Claude-versie. De URL is https://server.promptwatch.com/mcp, de header is Authorization: Bearer jouw-token-hier.
Voor Claude Code in de terminal gebruik je het commando-formaat dat Claude Code biedt voor HTTP-servers. De server is gehost, dus er draait niets lokaal. Je hoeft geen binary te installeren of een poort open te zetten. Dat is het verschil met self-host MCP-servers: Promptwatch regelt de uptime, jij regelt de key.
Stap 4: read-only key voor schrijf-veilige agents
Promptwatch splitst tools in read en write. Read-tools halen data op en wijzigen niets. Write-tools maken content, publiceren, maken prompts aan of wijzigen de takenlijst. Als je een agent alleen laat rapporteren, geef hem dan een read-only key. De schrijf-tools verdwijnen dan uit de tool-lijst die de agent ziet, wat voorkomt dat een agent uit zichzelf content publiceert of prompts aanmaakt.
De read-tools die je behoudt dekken de hele meetlaag: listPrompts en getPrompt voor je promptbibliotheek, getVisibilityTimeSeries voor zichtbaarheid over tijd, getCitations en getCitationTopPages voor paginacitaties, listRedditCitations en listYoutubeCitations voor Reddit en YouTube, getCompetitorHeatmap voor concurrenten, listContentGapPrompts en getContentGapRecommendations voor contentgaten, listQueryFanouts voor fan-out-volumes, getCrawlerTrend en getTopCrawlerPages voor AI-crawlerlogs, getVisitorTrend, getVisitorTopPages en getVisitorTopSources voor AI-verwezen verkeer, getResponseSentimentTimeSeries voor sentiment, listAds en listAdPrompts voor advertenties, listShoppingItems voor ChatGPT Shopping, getContentGapStats en getSiteHealth voor siteconditie, en listActionItems voor de takenlijst.
De schrijf-tools die een read-only key verbergt: createContent, listContentSlots, acceptContentSlot, publishContentLive, createReport, createActionItem, updateActionItemStatus, createPrompt, createPromptsBulk en addShoppingTrackedProducts. Gebruik een gewone key als je wilt dat je agent content publiceert naar Webflow of Framer of GEO-artikelen accepteert in de review inbox. Gebruik een read-only key voor elke agent die alleen mag rapporteren.
Stap 5: een eerste gesprek
Na de koppeling test je met een eenvoudige vraag. Vraag je agent: geef me de content gaps voor mijn belangrijkste prompts, gesorteerd op zoekvolume. De agent roept listContentGapPrompts en getContentGapRecommendations aan, en je krijgt een lijst met prompts waar je zichtbaarheid ontbreekt, plus een aanbeveling per prompt.
Een tweede test op de crawlerkant: welke pagina's pakt ChatGPTBot het vaakst deze maand? De agent gebruikt getCrawlerTrend en getTopCrawlerPages, en je ziet welke pagina's de crawler ophaalt en hoe dat over tijd beweegt. Dat is de laag die de meeste trackers niet hebben: niet of je genoemd wordt, maar welke pagina de AI-engine daadwerkelijk ophaalt en of dat leidt tot een citatie.
Een derde test op publicatie: maak een concept voor de grootste content gap en leg het in de review inbox. De agent gebruikt createContent en listContentSlots, en je reviewt het concept in Promptwatch voordat het naar je CMS gaat. Pas daarna roep je acceptContentSlot en publishContentLive aan. Je blijft de menselijke controle.
Veelgemaakte fouten
De key in een publieke repo zetten is de eerste fout. De tweede is een schrijf-key delen met een agent die alleen hoeft te lezen, waardoor de agent prompts kan aanmaken of content kan publiceren zonder jouw controle. De derde is verwachten dat de MCP-server oude data teruggeeft: de read-tools leveren live data binnen je planlimieten, geen historische export buiten je abonnement.
Een vierde fout is de server willen self-hosten. Promptwatch is gehost op https://server.promptwatch.com/mcp. Er is geen binary om lokaal te draaien, en dat is geen nadeel. De uptime, de OAuth-flow en de tool-schema's worden door Promptwatch onderhouden. Jij onderhoudt alleen je key en je config.
Waar je daarna heen gaat
Zodra de koppeling staat, is de volgende stap een terugkerend ritueel. Elke week vraag je je agent om de zichtbaarheidstrend, de topcrawlerpagina's en de content gaps op te halen, en om een rapport te maken via createReport. Elke maand laat je de agent de grootste content gaps als concepten in de review inbox leggen, en review je die zelf. Dat ritueel is de hele GEO-lus: meten, diagnosticeren, publiceren. Promptwatch is de server die die lus in één gesprek mogelijk maakt.
Wie de technische fundering erbij wil, koppelt ook SEO MCP voor GSC, GA4 en indexering, of DispatchSEO voor fixes als pull requests. Die servers vullen Promptwatch aan. Ze vervangen het niet, want de citatie-, crawler- en bezoekerslaag zit alleen in Promptwatch.