MCP server

MCP server Diaform prepojí vášho AI agenta s vašou spätnou väzbou. Po pripojení sa agenta môžete pýtať napríklad „Na čo sa zákazníci tento mesiac sťažovali?“ a on si načíta rozhovory, zhrnutia a reporty.

MCP (Model Context Protocol) je štandardný spôsob, ako sa AI agenti pripájajú k externým nástrojom. Server sprístupňuje rovnaké dáta ako REST API, je len na čítanie a používa rovnaký API kľúč.

Skôr než začnete#

Potrebujete plán Pro, Business alebo Enterprise a API kľúč. Kľúče vytvárajú vlastníci a administrátori v časti Nastavenia → Všeobecné → API kľúče. Viac v časti Prehľad API.

Nastavenie	Hodnota
URL servera	`https://diaform.io/api/mcp`
Transport	Streamable HTTP
Overenie	Hlavička `Authorization: Bearer dia_org_live_...`

Kľúč dáva agentovi prístup na čítanie ku všetkým projektom vo vašej organizácii. Pre každého agenta vytvorte samostatný kľúč, aby ste mohli jeden odvolať bez vplyvu na ostatné.

Pripojenie agenta#

Vyberte svojho agenta:

Spustite v termináli:

Shell

claude mcp add --transport http diaform https://diaform.io/api/mcp \
  --header "Authorization: Bearer $DIAFORM_API_KEY"

Potom v Claude Code spustite /mcp a skontrolujte, či je diaform pripojený.

Nástroje#

Agent vidí šesť nástrojov len na čítanie:

Nástroj	Čo robí	Argumenty
`list_projects`	Vypíše všetky projekty s ID, názvom a stavom	Žiadne
`get_project`	Vráti jeden projekt s otázkami a počtami rozhovorov	`project_id`
`list_conversations`	Vypíše rozhovory projektu s respondentom, sentimentom a AI zhrnutím	`project_id` a voliteľne `status`, `sentiment`, `created_after`, `created_before`, `search`, `limit`, `cursor`
`get_conversation`	Vráti jeden rozhovor so zhrnutím a celým prepisom	`conversation_id`
`list_reports`	Vypíše AI reporty projektu	`project_id` a voliteľne `status`, `limit`, `cursor`
`get_report`	Vráti jeden AI report s témami, problémami, ojedinelými hlasmi a citátmi	`report_id`

Každý nástroj vracia rovnaký JSON ako jeho REST endpoint. Jednotlivé polia sú opísané na stránkach Projekty, Rozhovory a Reporty. status a sentiment sú polia hodnôt (array), napríklad ["completed"].

Zoznamy vracajú najviac 100 položiek naraz. Keď má výsledok has_more: true, agent odovzdá next_cursor ako cursor a získa ďalšiu stránku.

Na čo sa opýtať#

„Vypíš moje projekty v aplikácii Diaform a povedz mi, ktorý má najviac odpovedí.“
„Prečítaj dokončené rozhovory za posledných 30 dní v projekte k onboardingu a zoskup sťažnosti podľa tém.“
„Nájdi rozhovory, v ktorých sa hovorí o cenách, a odcituj, čo ľudia povedali.“
„Zhrň posledný AI report a priprav správu do Slacku pre produktový tím.“
„Načítaj celý prepis najnegatívnejšieho rozhovoru z tohto týždňa.“

Chyby a limity#

Ak kľúč chýba alebo je odvolaný, alebo ak plán nemá prístup k API, pripojenie zlyhá s HTTP 401 alebo 403. Váš klient to zvyčajne zobrazí ako server, ktorý zlyhal alebo nie je autorizovaný.

Keď volanie nástroja zlyhá, napríklad pre nesprávne ID, agent dostane rovnaké error a code ako pri REST API a môže sa opraviť sám. Viac v časti Chyby.

Požiadavky cez MCP sa počítajú do rovnakého limitu ako REST API: 120 požiadaviek za minútu na každý kľúč.

Technické podrobnosti#

Ak si píšete vlastného klienta:

Správy JSON-RPC 2.0 posielajte cez POST https://diaform.io/api/mcp. Server na každú požiadavku odpovie jednou odpoveďou JSON, nie prúdom udalostí.
Server je bezstavový. Nevydáva žiadne ID relácie a GET aj DELETE vracajú 405.
Podporované verzie protokolu sú 2025-06-18, 2025-03-26 a 2024-11-05.
Implementuje initialize, ping, tools/list a tools/call. Neponúka žiadne zdroje ani prompty.

Shell

curl -X POST "https://diaform.io/api/mcp" \
  -H "Authorization: Bearer $DIAFORM_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "list_conversations",
      "arguments": {
        "project_id": "b8acb3ab-1f3d-4a7e-a846-b7f493f86b6d",
        "status": ["completed"],
        "limit": 10
      }
    }
  }'