MCP server

MCP server Diaform propojí vašeho AI agenta s vaší zpětnou vazbou. Po připojení se agenta můžete ptát například „Na co si zákazníci tento měsíc stěžovali?“ a on si načte rozhovory, shrnutí a reporty.

MCP (Model Context Protocol) je standardní způsob, jak se AI agenti připojují k externím nástrojům. Server zpřístupňuje stejná data jako REST API, je jen pro čtení a používá stejný API klíč.

Než začnete#

Potřebujete tarif Pro, Business nebo Enterprise a API klíč. Klíče vytvářejí vlastníci a správci v části Nastavení → Obecné → API klíče. Viz Přehled API.

Nastavení	Hodnota
URL serveru	`https://diaform.io/api/mcp`
Transport	Streamable HTTP
Ověření	Hlavička `Authorization: Bearer dia_org_live_...`

Klíč dává agentovi přístup pro čtení ke všem projektům ve vaší organizaci. Pro každého agenta vytvořte samostatný klíč, abyste mohli jeden zneplatnit bez dopadu na ostatní.

Připojení agenta#

Vyberte svého agenta:

Spusťte v terminálu:

Shell

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

Pak v Claude Code spusťte /mcp a zkontrolujte, že je diaform připojený.

Nástroje#

Agent vidí šest nástrojů jen pro čtení:

Nástroj	Co dělá	Argumenty
`list_projects`	Vypíše všechny projekty s ID, názvem a stavem	Žádné
`get_project`	Vrátí jeden projekt s otázkami a počty rozhovorů	`project_id`
`list_conversations`	Vypíše rozhovory projektu s respondentem, sentimentem a shrnutím od AI	`project_id` a volitelně `status`, `sentiment`, `created_after`, `created_before`, `search`, `limit`, `cursor`
`get_conversation`	Vrátí jeden rozhovor se shrnutím a celým přepisem	`conversation_id`
`list_reports`	Vypíše AI reporty projektu	`project_id` a volitelně `status`, `limit`, `cursor`
`get_report`	Vrátí jeden AI report s tématy, problémy, ojedinělými hlasy a citacemi	`report_id`

Každý nástroj vrací stejný JSON jako jeho REST endpoint. Jednotlivá pole jsou popsaná na stránkách Projekty, Rozhovory a Reporty. status a sentiment jsou pole hodnot (array), například ["completed"].

Výpisy vracejí až 100 položek najednou. Když má výsledek has_more: true, agent předá next_cursor jako cursor a získá další stránku.

Na co se zeptat#

„Vypiš moje projekty v nástroji Diaform a řekni mi, který má nejvíc odpovědí.“
„Přečti dokončené rozhovory za posledních 30 dní v projektu k onboardingu a seskup stížnosti podle témat.“
„Najdi rozhovory, ve kterých se mluví o cenách, a ocituj, co lidé řekli.“
„Shrň poslední AI report a připrav zprávu do Slacku pro produktový tým.“
„Načti celý přepis nejnegativnějšího rozhovoru z tohoto týdne.“

Chyby a limity#

Když klíč chybí nebo je zneplatněný, nebo když tarif nemá přístup k API, připojení selže s HTTP 401 nebo 403. Váš klient to obvykle ukáže jako server, který selhal nebo není autorizovaný.

Když volání nástroje selže, například kvůli špatnému ID, agent dostane stejné error a code jako u REST API a může se opravit sám. Viz Chyby.

Požadavky přes MCP se počítají do stejného limitu jako REST API: 120 požadavků za minutu na každý klíč.

Technické podrobnosti#

Pokud si píšete vlastního klienta:

Zprávy JSON-RPC 2.0 posílejte pomocí POST https://diaform.io/api/mcp. Server na každý požadavek odpoví jednou odpovědí JSON, ne proudem událostí.
Server je bezstavový. Nevydává žádné ID relace a GET i DELETE vracejí 405.
Podporované verze protokolu jsou 2025-06-18, 2025-03-26 a 2024-11-05.
Implementuje initialize, ping, tools/list a tools/call. Nenabízí žádné 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
      }
    }
  }'