MCP-server

De MCP-server draait op één URL:

https://fluotest.com/api/mcp

Hij gebruikt het Streamable HTTP-transport. Elk verzoek moet geauthenticeerd zijn — niet-geauthenticeerde verzoeken krijgen een 401-antwoord dat MCP-clients vertelt waar de OAuth-flow begint.

Er zijn twee manieren om te authenticeren. Beide handelen als jouw gebruikersaccount: de assistent kan alleen zien en aanmaken wat jij kunt.

• OAuth 2.1 (aanbevolen): Ondersteund door Claude's custom connectors en andere MCP-clients met OAuth-ondersteuning. Je logt in bij FluoTest in de browser en keurt toegang goed op een toestemmingsscherm — geen sleutels kopiëren, en je houdt controle over wat er verbonden is.
• API-sleutel: Voor MCP-clients met eigen headers (zoals Claude Code) of je eigen scripts. Genereer een sleutel in Instellingen → Beveiliging → API-sleutels en stuur die mee als "Authorization: Bearer fluo_…" — behandel hem als een wachtwoord.

Volledige API-referentie: sleutels, headers & curl-voorbeelden →

Ga in Claude naar Settings → Connectors → Add custom connector en vul in:

1. Name: FluoTest
2. Remote MCP server URL: https://fluotest.com/api/mcp
3. Advanced settings → OAuth Client ID: plak het client ID hieronder. Laat het veld OAuth Client Secret leeg.
4. Klik op Add en daarna Connect — je wordt naar fluotest.com gestuurd om in te loggen en toegang goed te keuren.

OAuth Client ID

76a0fe41-98d3-47b5-8cbf-bf9c00eebc2b

Een client secret is niet nodig — de connector is geregistreerd als publieke OAuth-client en de flow is beveiligd met PKCE. ChatGPT-connectors gebruiken dezelfde server-URL en hetzelfde client ID.

Voor clients waar de OAuth-flow niet beschikbaar is:

1. Open in FluoTest Instellingen → Beveiliging → API-sleutels.
2. Voer een naam in (bijv. "Claude Code") en klik op Sleutel genereren.
3. Kopieer de fluo_…-sleutel direct — deze wordt maar één keer getoond.
4. Voeg hem toe aan je MCP-client als Authorization-header.

Generieke MCP-configuratie (voor clients met mcp.json):

{
  "mcpServers": {
    "fluotest": {
      "type": "http",
      "url": "https://fluotest.com/api/mcp",
      "headers": {
        "Authorization": "Bearer fluo_YOUR_API_KEY"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add --transport http fluotest https://fluotest.com/api/mcp \
  --header "Authorization: Bearer fluo_YOUR_API_KEY"

Volledige API-referentie: sleutels, headers & curl-voorbeelden →

De server biedt momenteel twee tools:

• create_quiz: Maakt een conceptquiz aan in jouw account: een titel, een optionele beschrijving en een lijst met vragen — yes_no (met punten voor "yes"), multiple_choice / multi_select (met een score per optie) of open voor niet-gescoorde tekst. Geeft het quiz-ID en een dashboardlink terug; de quiz blijft ongepubliceerd tot jij hem publiceert.
• get_results: Neemt een quiz-ID en geeft het aantal inzendingen, het aantal gediskwalificeerden, het gemiddelde / laagste / hoogste scorepercentage terug en — als de quiz scoreniveaus heeft — hoeveel respondenten in elk niveau vielen.

Voorbeeld create_quiz-argumenten

{
  "title": "Marketing readiness check",
  "description": "Score how ready a business is to run paid ads.",
  "questions": [
    { "text": "Do you have a documented strategy?", "type": "yes_no", "points": 2 },
    {
      "text": "How often do you review results?",
      "type": "multiple_choice",
      "options": [
        { "label": "Monthly", "score": 3 },
        { "label": "Yearly", "score": 1 },
        { "label": "Never", "score": 0 }
      ]
    },
    { "text": "Anything else we should know?", "type": "open" }
  ]
}

MCP-clients ontdekken deze automatisch via het 401-antwoord van de server en het discovery-document — je hebt ze alleen nodig als een client expliciet om endpoints vraagt. Probeer eerst de OIDC discovery-URL; die lost de rest op.