Documentatie
MCP & ChatGPT app
Verbind Claude, ChatGPT, Cursor of een andere MCP-client met de 72 tools van AutoPSEO voor Search Console, GA4, onderzoek en de content engine, via inloggen of een API-sleutel.
AutoPSEO draait één MCP-server (Model Context Protocol) op https://app.autopseo.com/mcp. Elke assistent die MCP via HTTP spreekt, kan verbinding maken, hetzij door in te loggen op je AutoPSEO-account, hetzij met een apk_live_-API-sleutel, en werkt vervolgens met dezelfde properties, rechten en hetzelfde abonnement als jij. De server registreert 72 tools in drie groepen: rapporten uit Search Console en GA4, onderzoeksdata en de content engine, waarmee je eigen AI artikelen voor je site kan schrijven.
Verbinden door in te loggen
Tools die MCP-inloggen ondersteunen, hebben geen sleutel nodig. Voeg het adres toe, log in bij AutoPSEO wanneer de tool daarom vraagt en keur de toegang goed; de tool bewaart en vernieuwt daarna zelf zijn toegang.
- Claude Code: voer
claude mcp add --transport http autopseo https://app.autopseo.com/mcpuit, typ vervolgens/mcp, kies autopseo en kies Authenticate. - Claude op het web of op desktop: Settings → Connectors → Add custom connector, plak
https://app.autopseo.com/mcp, kies daarna Connect en log in. - Cursor: voeg de server toe aan
~/.cursor/mcp.json(alle projecten) of.cursor/mcp.json(één project) en gebruik daarna de knop Connect die Cursor ernaast toont.
{ "mcpServers": { "autopseo": { "url": "https://app.autopseo.com/mcp" } } }
Elke tool die op deze manier is verbonden, verschijnt onder Signed-in tools op de pagina MCP & API, waar je met Sign out de toegang meteen intrekt. Een goede eerste vraag is: "List the Search Console properties on my account". Het antwoord bewijst dat de verbinding werkt en geeft de assistent de exacte propertynamen die de andere tools verwachten.
ChatGPT
ChatGPT maakt verbinding via de developer mode, en de pagina MCP & API loopt die stap voor stap door onder ChatGPT app. Kort gezegd: open in ChatGPT Settings → Apps & Connectors → Advanced settings en schakel Developer mode in (de app noemt ChatGPT Plus, Pro, Business, Enterprise en Edu), kies Create, geef de connector een naam, stel de MCP-server-URL in op https://app.autopseo.com/mcp en de authenticatie op OAuth, en log in bij AutoPSEO wanneer ChatGPT daarom vraagt. De connectors van ChatGPT bieden alleen OAuth of geen authenticatie, dus API-sleutels werken daar niet. Meer hierover staat op de ChatGPT-pagina.
Verbinden met een API-sleutel
Sleutels zijn bedoeld voor scripts, geplande taken en machines zonder browser. Geef op MCP & API → API keys de sleutel een naam en kies het bereik:
- Read only: data opvragen en rapporten uitvoeren; er kan niets worden toegevoegd, gewijzigd of verwijderd.
- Read & write: alles wat een leessleutel kan, plus tools die data wijzigen of onderzoekscredits verbruiken.
De volledige sleutel, apk_live_ gevolgd door 32 hexadecimale tekens, wordt één keer getoond; AutoPSEO bewaart alleen de SHA-256-hash. De sleutellijst toont wanneer elke sleutel is aangemaakt, wanneer die voor het laatst is gebruikt en hoeveel verzoeken ermee zijn gedaan, en met Revoke stop je een sleutel onmiddellijk. Je kunt maximaal 25 actieve sleutels hebben. Stuur de sleutel mee als Authorization: Bearer apk_live_... (een x-api-key-header werkt ook):
claude mcp add --transport http autopseo https://app.autopseo.com/mcp --header "Authorization: Bearer apk_live_..."
De pagina bevat ook voorbeelden voor de OpenAI Responses API, ruwe JSON-RPC met curl (de server gebruikt het Streamable HTTP transport) en de REST API op https://app.autopseo.com/v1, die de 19 tools voor Search Console en GA4 aanbiedt met dezelfde sleutels en een OpenAPI 3.1-document op /v1/openapi.json.
De tools
De pagina MCP & API toont altijd de actuele toolnamen; toen deze pagina werd geschreven waren het er 72.
Search Console en GA4 (19 tools)
list_properties, search_analytics, top_queries, top_pages, top_countries, compare_periods, content_decay, cannibalization, ctr_benchmark, page_poaching, rank_changes, new_lost_rankings, url_inspection, sitemaps, annotations, create_annotation, ga4_overview, ga4_breakdown en ga4_key_events. Ze kosten geen credits. Zonder opgegeven datums bestrijken ze de laatste 28 afgeronde dagen, vergeleken met de 28 daarvoor, en iedereen kan ze uitproberen op de demo-property sc-domain:demo.autopseo.app. Ondanks de naam hoort content_decay in deze groep thuis: het vindt pagina's die klikken verliezen.
Onderzoek (33 tools)
- Account en projecten:
whoami,create_project,get_project_context,update_project_context - Zoekwoorden:
research_keywords,get_keyword_metrics,get_ranked_keywords,get_domain_keyword_suggestions,save_keywords,list_saved_keywords - Domeinen, resultatenpagina's en links:
get_domain_overview,get_serp_results,find_serp_competitors,get_backlinks_overview,get_backlinks_profile - Rankingtracking:
create_rank_tracker,get_rank_tracker,add_rank_tracking_keywords,remove_rank_tracking_keywords,estimate_rank_tracker_cost,run_rank_tracker - Lokaal zoeken:
search_local_businesses,get_local_serp_results,get_local_rank_grid,get_business_profile,get_business_reviews,get_business_updates,get_google_business_questions,list_business_categories - Site-audits:
run_site_audit,get_audit_status,get_audit_issues,get_audit_pages
Veel van deze tools kopen data in bij DataForSEO en gebruiken je onderzoekscredits. Houd je verzoeken dus gericht en controleer vooraf bij grote batches.
Content engine (20 tools)
Hiermee laat je je eigen AI via dezelfde wachtrij werken als de schrijver van AutoPSEO: content_list_tasks, content_claim, content_get_brief, content_submit, content_publish, content_unpublish, content_get_page, content_report, content_find_pages, content_add_topics, content_decline, content_merge, content_cover, content_set_cover, content_get_translation, content_submit_translation, content_instructions, content_propose_value, content_submit_value en content_remove_path. De server biedt ook vijf prompts: write-articles, optimize-page, revise-draft, connect-repo en refresh-decayed.
Een typische sessie ziet er zo uit: je lijst de taken op, claimt er een (een claim houdt de taak twee uur vast), leest de brief, schrijft, dient in en herstelt wat de controles terugsturen, en publiceert alleen als jij dat zegt. Coverafbeeldingen en vertalingen hebben eigen tools. Op deze manier geschreven artikelen doorstaan dezelfde controles als die van AutoPSEO zelf en gebruiken niets van je artikelquotum, al leest de eerste aanroep voor een brief de actuele zoekresultaten uit op onderzoekscredits. De volledige werkwijze staat in Schrijven met je eigen AI.
Lees-, schrijf- en betaalde tools
Elke tool heeft een toegangsklasse. Read-tools kijken alleen mee (33 stuks), write-tools wijzigen je werkruimte (22) en paid-tools lezen alleen, maar kopen onderzoeksdata in (17). Een sleutel met alleen leesrechten kan uitsluitend read-tools aanroepen. Een teamlid met Read-toegang kan ook alleen read-tools aanroepen, ongeacht welke sleutel of welk account het gebruikt, en elk lid heeft alleen toegang tot de properties die in de uitnodiging zijn genoemd (Delen & teamtoegang).
Limieten en fouten
Aanroepen zijn begrensd op 60 per minuut per sleutel en 1,000 per uur per account, over al zijn sleutels samen. Bij overschrijding van een van beide limieten antwoordt de server met HTTP 429 en een Retry-After-header, en de meeste clients wachten en proberen het dan zelf opnieuw; de handshakes initialize en ping tellen niet mee. Zodra een proefperiode eindigt zonder abonnement, antwoorden de tools met "subscription required". De aanbieder van een assistent ontvangt je data alleen voor de verzoeken die je zelf doet; log een tool uit of trek de sleutel in om dat te stoppen. Meer voorbeelden staan op de Search Console MCP-pagina.