MCP Integratie

Maak en beheer quizzen rechtstreeks vanuit elke MCP-compatibele AI-assistent of tool.

AI-AangedrevenEnd-to-End VersleuteldOpen Protocol

Wat is MCP?

Het Model Context Protocol (MCP) is een open standaard waarmee AI-assistenten kunnen communiceren met externe tools en diensten. Quiz biedt een MCP-endpoint waarmee AI-agents quizzen kunnen aanmaken, vragen kunnen toevoegen en bewerken, en de volledige quizlevenscyclus kunnen beheren — allemaal zonder uw AI-workflow te verlaten.

Beschikbare Tools

create_quiz

Maak een nieuwe quiz met vragen. Retourneert een admin-URL (met de encryptiesleutel en admin-token) plus een deelnemers-URL.

title(vereist) — De quiztitel

description(optioneel) — Quizbeschrijving

questions(vereist) — Array van vragen met text, options, correctIndex en optioneel timerOverride

timerSeconds(optioneel, standaard: 0) — Standaard timer per vraag in seconden (0 = geen timer)

expirationHours(optioneel, standaard: 0) — Uren tot de quiz verloopt (0 = geen verloop, 1–168)

get_quiz

Haal de volledige details van een quiz op, inclusief alle ontsleutelde vragen, deelnemers en status. Vereist de admin-URL.

adminUrl(vereist) — De admin-URL die bij het aanmaken van de quiz werd geretourneerd

add_question

Voeg een nieuwe vraag toe aan een bestaande quiz (moet in conceptstatus zijn). Vereist de admin-URL.

adminUrl(vereist) — De admin-URL die bij het aanmaken van de quiz werd geretourneerd

text(vereist) — De vraagtekst

options(vereist) — 2–4 antwoordopties

correctIndex(vereist) — 0-gebaseerde index van het juiste antwoord

timerOverride(optioneel) — Per-vraag timer override in seconden (5–120)

update_question

Werk een bestaande vraag bij in een quiz (moet in conceptstatus zijn). Vereist de admin-URL.

adminUrl(vereist) — De admin-URL die bij het aanmaken van de quiz werd geretourneerd

index(vereist) — 0-gebaseerde index van de vraag

text(vereist) — De vraagtekst

options(vereist) — 2–4 antwoordopties

correctIndex(vereist) — 0-gebaseerde index van het juiste antwoord

timerOverride(optioneel) — Per-vraag timer override in seconden (5–120)

remove_question

Verwijder een vraag uit een quiz (moet in conceptstatus zijn). Resterende vragen worden opnieuw geïndexeerd. Vereist de admin-URL.

adminUrl(vereist) — De admin-URL die bij het aanmaken van de quiz werd geretourneerd

index(vereist) — 0-gebaseerde index van de vraag

delete_quiz

Verwijder een quiz en alle bijbehorende gegevens permanent. Dit kan niet ongedaan worden gemaakt. Vereist de admin-URL.

adminUrl(vereist) — De admin-URL die bij het aanmaken van de quiz werd geretourneerd

Over de Admin-URL

Wanneer u een quiz aanmaakt via MCP, ontvangt de AI-assistent de admin-URL die zowel de encryptiesleutel als het admin-token bevat. Deze URL wordt niet op de server opgeslagen — hij bestaat alleen in het gespreksgeheugen van de AI. Afhankelijk van welke tool u gebruikt, kan de admin-URL in uw gespreksgeschiedenis bewaard blijven. Maak alleen quizzen aan via vertrouwde tools en behandel de admin-URL als een wachtwoord.

Installatie-instructies

Streamable HTTP (aanbevolen)

Als uw MCP-client streamable HTTP ondersteunt, voeg dan de server-URL rechtstreeks toe aan uw MCP-configuratiebestand.

{
  "mcpServers": {
    "quiz": {
      "url": "https://quiz.switch-to.eu/api/mcp/mcp"
    }
  }
}

Stdio Bridge

Voor MCP-clients die alleen stdio-transport ondersteunen, gebruik de mcp-remote bridge om via HTTP te verbinden.

{
  "mcpServers": {
    "quiz": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://quiz.switch-to.eu/api/mcp/mcp"
      ]
    }
  }
}

Vereist mcp-remote (automatisch geïnstalleerd via npx) om stdio naar HTTP te bridgen.

Beveiligingsopmerking

Alle quizinhoud wordt versleuteld met AES-256-GCM vóór opslag — de server ziet nooit de platte tekst. Bij het aanmaken of beheren van quizzen via MCP gaan de encryptiesleutel en het admin-token via het MCP-protocol. Gebruik dit alleen met vertrouwde tools en deel deelname-links (geen admin-links) met deelnemers.