Analyseer je SurveyLane-resultaten met AI.
Een gehoste, alleen‑lezen MCP-endpoint waarmee Claude (of een andere MCP‑client) de enquêtes en antwoorden in je SurveyLane-account kan lezen — zodat het open antwoorden samenvat, toetst welke verschillen significant zijn, de kerndrivers vindt, segmenten vergelijkt en bevindingen uitschrijft. Geen SDK's, geen lijmwerk.
01Snel starten
In drie stappen van niets tot chatten met je enquêtedata.
Genereer een token
Open Instellingen → API access en klik op Genereer. Kopieer de waarde meteen — hij wordt alleen bij het aanmaken getoond.
Koppel je client
Voeg de endpoint en de Bearer-header toe aan Claude Code, Claude Desktop of Cursor — één CLI-commando of een klein stukje JSON.
Vraag in gewone taal
Het model bepaalt zelf welke tools het aanroept. Jij beschrijft wat je wilt weten, niet welke query er moet draaien.
02Installeren
Plak de endpoint in elke MCP‑client. HTTP-transport, Bearer-auth, geen SDK.
Voeg de server toe met één CLI-aanroep. Positionele argumenten komen vóór de flags, anders wordt de URL opgeslokt door --header.
claude mcp add surveylane https://mcp.surveylane.app \ --transport http \ --header "Authorization: Bearer slk_..."
Controleer met claude mcp list — je zou surveylane tussen je andere servers moeten zien staan.
03Authenticatie & privacy
Elke aanvraag behalve GET /health moet een Bearer-token meesturen. Tokens zijn persoonlijk, alleen‑lezen en worden eenmalig bij het aanmaken getoond.
Alleen‑lezen door ontwerp
De AI kan je enquêtes, resultaten en antwoorden opvragen en analyseren — aanmaken, bewerken of verwijderen kan het niet. Veilig om mee te geven aan elke MCP-client waaraan je inzage wilt geven.
- list_surveys, get_survey
- get_results, get_open_text, get_funnel
- get_responses, whoami
Privacy van respondenten
Bij anonieme enquêtes worden namen en e-mailadressen van respondenten nooit teruggegeven — alleen geaggregeerde en geanonimiseerde antwoorden. Bij niet-anonieme enquêtes wordt de keuze gerespecteerd die je op de enquête hebt gemaakt.
- isAnonymous wordt server-side afgedwongen
- aggregatie-tools tonen nooit PII
- alleen binnen je eigen account
Tokens zijn per‑gebruiker en in te trekken
Elke tool-query blijft binnen je eigen data en kan geen andere accounts zien. Trek een gelekt token in via Instellingen → API access — dat werkt direct.
04Tools · 22
Alles wat de AI kan aanroepen. Allemaal alleen‑lezen. Elke tool geeft kale bouwstenen terug (aantallen, verdelingen, ruwe tekst) — het model doet de interpretatie.
whoami
list_surveys
get_survey (survey_id)
get_results (survey_id, only_complete, filter, segment_by)
get_open_text (question_id, limit, offset)
get_responses (survey_id, only_complete, limit, offset, include_pii, question_ids)
get_funnel (survey_id)
get_crosstab (question_a, question_b)
get_group_summary (survey_id)
get_data_quality (survey_id)
compare_surveys (survey_a, survey_b)
test_significance (survey_id, question_id, group_question_id, group_a, group_b)
get_correlation_matrix (survey_id, group_id)
key_drivers (survey_id, target)
scale_reliability (survey_id)
query_cohort (survey_id, where, aggregate)
get_weighted_results (survey_id, weight_question_id, target_shares)
compute_index (survey_id, items, normalize, segment_by)
auto_insights (survey_id, top_n)
get_verbatims (question_id, link_question_id, min_score, max_score, limit)
response_timeline (survey_id, bucket)
report_bundle (survey_id, driver_target)
05Prompts
Server‑gehoste prompt-sjablonen die de AI rechtstreeks aanroept. In Claude Code: /mcp__surveylane__<name>. Eén klik geeft je een volledige begeleide analyse, in plaats van dat je zelf de juiste vragen moet stellen.
analyze_survey
Analyze a survey
Run a full analysis of a survey's results and write a report with findings and recommendations.
06Voorbeeldprompts
Echte vragen die je in je AI-client kunt plakken — van een snelle samenvatting tot significantietoetsen, kerndriver-analyse, cohorten, weging en voor/na-vergelijkingen. Het model bepaalt welke tools het aanroept en koppelt ze aan elkaar; jij blijft in gewone taal.
Aanmelden interventieperiode voor het laatst een antwoord?”
07Van data naar een gepolijst rapport
Vraag je AI om een volledige analyse en die leest de cijfers rechtstreeks uit de MCP-tools — een klein script maakt er vervolgens een gehuisstijld, directieklaar PDF van. Hier zie je de workflow en een voorbeeld.
- 1Vraag het in gewone taal
“Voer een volledige analyse uit en schrijf een vertrouwelijk rapport op groepsniveau met bevindingen en aanbevelingen.”
- 2De AI roept de tools aan
Hij koppelt
report_bundle,key_drivers,compute_index,test_significanceen meer aan elkaar — allemaal alleen-lezen, allemaal beperkt tot je eigen account. - 3Een script rendert de PDF
Geef de teruggegeven cijfers aan een klein ReportLab- (of HTML‑naar‑PDF-)script met je eigen kleuren en logo. Draai het opnieuw zodra de data verandert.
Tools achter het voorbeeld: report_bundle, key_drivers, get_correlation_matrix, test_significance, compute_index, get_weighted_results, query_cohort, response_timeline.
22% zit meer dan 8 uur per dag en doet nooit aan mobiliteit — een concreet cohort voor de interventie. Beweging en voeding hebben het meeste effect.
08Rate limits
Per‑gebruiker, een schuivend venster van 60‑seconden. Bij het bereiken van de limiet krijg je een nette tool-fout met een retry_after_seconds-hint — geen HTTP 429 — zodat je AI-client kan terugschakelen zonder het gesprek te breken.
Geteld over al je tokens samen, dus meer tokens aanmaken kan het budget niet vergroten. Alle tools zijn pure database-leesacties.
Alleen‑lezen in deze versie. De scope-kolom bestaat zodat schrijftools later achter een expliciete upgrade toegevoegd kunnen worden.
Backoff-hints, geen HTTP 429
De MCP SDK kent geen retry-semantiek op transport‑niveau. AI-clients lezen de fouttekst WEL — de geweigerde response bevat een precieze retry_after_seconds.
09FAQ
report_bundle, key_drivers, compute_index …); een klein script maakt er vervolgens een gehuisstijld PDF van. Zie de sectie Rapporten voor een uitgewerkt voorbeeld.