MCP Server

MCP server běží na jediné adrese:

https://fluotest.com/api/mcp

Používá transport Streamable HTTP. Každý požadavek musí být ověřený — neověřené požadavky dostanou odpověď 401, která MCP klientům řekne, kde zahájit OAuth flow.

Ověřit se lze dvěma způsoby. Oba jednají jako váš uživatelský účet: asistent vidí a vytváří jen to, co vy.

• OAuth 2.1 (doporučeno): Podporují ho vlastní konektory v Claude i další MCP klienti s podporou OAuth. Přihlásíte se do FluoTestu v prohlížeči a schválíte přístup na potvrzovací obrazovce — žádné kopírování klíčů a máte plnou kontrolu nad tím, co je připojené.
• API klíč: Pro MCP klienty s vlastními hlavičkami (např. Claude Code) nebo vlastní skripty. Vygenerujte klíč v Nastavení → Zabezpečení → API klíče a posílejte ho jako „Authorization: Bearer fluo_…“ — zacházejte s ním jako s heslem.

Kompletní API reference: klíče, hlavičky a ukázky curl →

V Claude otevřete Settings → Connectors → Add custom connector a vyplňte:

1. Name: FluoTest
2. Remote MCP server URL: https://fluotest.com/api/mcp
3. Klikněte na Add a poté Connect — budete přesměrováni na fluotest.com k přihlášení a schválení přístupu.

Není potřeba nic kopírovat — konektor se při prvním připojení automaticky zaregistruje jako veřejný OAuth klient (PKCE, bez client secret).

Pro klienty, kde OAuth flow není k dispozici:

1. Ve FluoTestu otevřete Nastavení → Zabezpečení → API klíče.
2. Zadejte název (např. „Claude Code“) a klikněte na Vygenerovat klíč.
3. Klíč fluo_… si hned zkopírujte — zobrazí se jen jednou.
4. Přidejte ho do svého MCP klienta jako hlavičku Authorization.

Obecná konfigurace MCP (pro klienty s 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"

Kompletní API reference: klíče, hlavičky a ukázky curl →

Server nabízí osm nástrojů, které pokrývají celý životní cyklus kvízu. Každý nástroj přijímá kvíz podle názvu, slugu nebo ID — asistent nikdy nepotřebuje, abyste vkládali UUID.

• list_quizzes: Vypíše vaše kvízy: název, ID, slug, stav koncept/publikováno, počet odeslání a datum vytvoření. Asistent tento nástroj volá jako první, aby podle názvu (např. „můj wellness kvíz“) našel ten správný kvíz.
• create_quiz: Vytvoří koncept kvízu ve vašem vlastnictví: název, volitelný popis a otázky — yes_no (s body za „yes“), multiple_choice / multi_select (s body za jednotlivé možnosti) nebo open pro nebodovaný text — buď jako jednoduchý seznam pro kvíz s jednou sekcí, nebo seskupené do pojmenovaných sekcí pro kvíz s více sekcemi. Volitelně také bodovací úrovně nebo systém vlastních výsledkových zpráv. Vrátí ID kvízu a odkaz do dashboardu; kvíz zůstane nepublikovaný, dokud ho nepublikujete.
• get_quiz_questions: Přijme kvíz podle názvu nebo ID a vrátí jeho otázky seskupené podle sekcí, v pořadí — název každé sekce a v ní text, typ, možnosti s body (nebo body za yes_no) a které otázky respondenta diskvalifikují. Hodí se pro kontrolu, na co se kvíz vlastně ptá, nebo jako krok před update_quiz.
• get_quiz_settings: Přijme kvíz podle názvu nebo ID a vrátí text uvítací a děkovací stránky, nastavení e-mailu s výsledky, UX přepínače (časový limit, limit odpovědí, oslavná animace, skrytí skóre, úvodní obrazovka, srovnání s ostatními) a které integrace jsou připojené — webhook, Brevo, Meta Pixel, GTM — jako true/false, nikdy skutečnou URL ani ID.
• update_quiz: Upraví existující kvíz: název, popis, otázky, bodovací úrovně, vlastní výsledkové zprávy, text uvítací/děkovací stránky, e-mail s výsledky a UX nastavení jako časový limit nebo skrytí skóre — všechna pole jsou volitelná, mění se jen to, co pošlete. Otázky lze upravit třemi způsoby (nejvýše jeden na jedno volání): nahradit celý jednoduchý seznam, nahradit celou strukturu sekcí novou sadou pojmenovaných sekcí, nebo použít cílené operace přidat/upravit/přesunout na jednotlivé otázky u kvízu s více sekcemi, aniž byste se dotkli zbytku. Úprava už publikovaného kvízu vyžaduje navíc confirm_edit_published: true — první pokus se odmítne a místo změny vám ukáže počet odeslání, aby asistent nemohl změnit živý kvíz bez vašeho vědomí.
• publish_quiz: Publikuje koncept kvízu podle názvu nebo ID a zpřístupní ho na jeho veřejné URL. Nikdy se to nestane automaticky — publikování je vždy samostatný, vědomý krok oddělený od create_quiz, který proběhne jen na vaše výslovné přání.
• get_results: Přijme kvíz podle názvu nebo ID a vrátí počet odeslání, počet diskvalifikovaných, průměrné / nejnižší / nejvyšší skóre v procentech a — pokud má kvíz nastavené bodovací úrovně — kolik respondentů spadlo do každé úrovně.
• delete_quiz: Trvale smaže kvíz i jeho odeslání, podle názvu nebo ID. První volání nic nesmaže — vrátí název kvízu a počet odeslání, abyste to mohli zkontrolovat před potvrzením; teprve druhé volání s confirm: true smazání skutečně provede.

Ukázkové argumenty create_quiz

{
  "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 klienti si tyto adresy zjistí automaticky z odpovědi 401 a discovery dokumentu — potřebujete je, jen pokud si klient vyžádá endpointy explicitně. Zkuste nejdřív OIDC discovery URL; z ní se dopočítají ostatní.