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. Advanced settings → OAuth Client ID: vložte client ID níže. Pole OAuth Client Secret nechte prázdné.
4. Klikněte na Add a poté Connect — budete přesměrováni na fluotest.com k přihlášení a schválení přístupu.

OAuth Client ID

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

Client secret není potřeba — konektor je registrovaný jako veřejný OAuth klient a flow chrání PKCE. Konektory v ChatGPT používají stejnou adresu serveru i client ID.

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 aktuálně nabízí dva nástroje:

• create_quiz: Vytvoří koncept kvízu ve vašem vlastnictví: název, volitelný popis a seznam otázek — yes_no (s body za „yes“), multiple_choice / multi_select (s body za jednotlivé možnosti) nebo open pro nebodovaný text. Vrátí ID kvízu a odkaz do dashboardu; kvíz zůstane nepublikovaný, dokud ho nepublikujete.
• get_results: Přijme ID kvízu 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ě.

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í.