Připojení MCP serveru IUSTORIA

Co budete potřebovat

Postupy níže vycházejí z oficiální dokumentace každého klienta ke dni 1. 10. 2026. Názvy položek nastavení jsou anglicky, jak je klienti zobrazují. Když se v novější verzi klienta položka jmenuje jinak, platí dál totéž: přidat vzdálený server MCP s adresou https://www.iustoria.cz/mcp bez ověřování.

Aplikace pro uživatele

Claude (web a Claude Desktop)

Vlastní konektor přidáte jednou na webu claude.ai nebo v aplikaci Claude Desktop. Funguje ve všech tarifech; tarif Free má jeden vlastní konektor.

1. Otevřete Customize → Connectors (přímo na adrese claude.ai/customize/connectors).
2. Klikněte na + a zvolte Add custom connector.
3. Zadejte název, třeba IUSTORIA, a adresu https://www.iustoria.cz/mcp. Advanced settings (OAuth) nevyplňujte, server přihlášení nepotřebuje.
4. Potvrďte tlačítkem Add.
5. V konverzaci klikněte na + vlevo dole (nebo napište /), najeďte na Connectors a konektor zapněte. Při prvním volání nástroje se Claude zeptá, jestli ho smí použít.

• V tarifech Team a Enterprise přidává vlastní konektory jen vlastník organizace: Organization settings → Connectors → Add → Custom → Web. Členové ho pak v Customize → Connectors připojí tlačítkem Connect.
• Claude se k serveru připojuje ze serverů Anthropic, ne z vašeho počítače.

Podle oficiální dokumentace: Get started with custom connectors using remote MCP, Use connectors to extend Claude’s capabilities.

Claude v mobilu (iOS a Android)

Konektor přidaný na webu nebo v Claude Desktop je k dispozici i v mobilní aplikaci Claude po přihlášení k témuž účtu. Přidávání konektorů přímo v mobilu je podle Anthropic v betě; hlavní cestou zůstává web a Claude Desktop.

Podle oficiální dokumentace: Use connectors to extend Claude’s capabilities.

Claude Code

V terminálu jedním příkazem. Bez volby --scope platí server jen pro aktuální projekt; --scope user ho zpřístupní ve všech projektech, --scope project ho zapíše do souboru .mcp.json pro celý tým.

claude mcp add --transport http iustoria https://www.iustoria.cz/mcp

claude mcp add --transport http --scope user iustoria https://www.iustoria.cz/mcp

Soubor .mcp.json v kořeni projektu:

{
  "mcpServers": {
    "iustoria": {
      "type": "http",
      "url": "https://www.iustoria.cz/mcp"
    }
  }
}

• Stav připojení ukáže claude mcp list nebo příkaz /mcp v konverzaci.
• Kdo je v Claude Code přihlášený účtem claude.ai, uvidí v /mcp i konektory přidané na webu.

Podle oficiální dokumentace: Connect Claude Code to tools via MCP.

ChatGPT

ChatGPT připojuje vlastní MCP servery v režimu pro vývojáře (Developer mode), a to jen na webu, ne v mobilní aplikaci. Postup podle vývojářské dokumentace OpenAI:

1. V ChatGPT na webu otevřete Settings → Security and login a zapněte Developer mode.
2. Otevřete Plugins (chatgpt.com/plugins) a klikněte na +.
3. Zadejte název a popis, do pole Connection adresu https://www.iustoria.cz/mcp. Ověřování (OAuth) nenastavujte, server přihlášení nepotřebuje.
4. Připojení vytvořte a zkontrolujte seznam nalezených nástrojů.
5. V konverzaci zvolte v nabídce + položku Developer mode a vyberte připojení IUSTORIA.

• Dostupnost podle tarifu uvádí OpenAI na dvou místech různě. Vývojářská dokumentace jmenuje tarify Plus, Pro, Business, Enterprise a Education. Nápověda ChatGPT uvádí u tarifu Pro jen nástroje, které čtou, a plnou podporu v betě pro Business, Enterprise a Edu, kde připojení zakládá správce (Workspace settings → Apps → Create).
• Všechny nástroje serveru kromě poptavka_odeslat mají anotaci readOnlyHint, takže je ChatGPT bere jako nástroje, které jen čtou.
• Názvy položek nastavení ChatGPT se mezi verzemi mění; adresa serveru a volba bez ověřování zůstávají stejné.

Podle oficiální dokumentace: Developer mode (OpenAI), Connect from ChatGPT (OpenAI), Developer mode and MCP apps in ChatGPT (nápověda OpenAI).

Cursor

Do souboru .cursor/mcp.json v projektu, nebo do ~/.cursor/mcp.json pro všechny projekty, přidejte:

{
  "mcpServers": {
    "iustoria": {
      "url": "https://www.iustoria.cz/mcp"
    }
  }
}

• Cursor se před použitím nástroje MCP ve výchozím nastavení ptá na souhlas.

Podle oficiální dokumentace: Model Context Protocol (Cursor).

Visual Studio Code (GitHub Copilot)

V paletě příkazů spusťte MCP: Add Server, zvolte HTTP a zadejte adresu serveru. Nebo zapište server přímo do souboru .mcp.json v kořeni projektu:

{
  "mcpServers": {
    "iustoria": {
      "type": "http",
      "url": "https://www.iustoria.cz/mcp"
    }
  }
}

• Nástroje serveru pak uvidíte v okně chatu pod tlačítkem Configure Tools. Starší soubor .vscode/mcp.json používá místo mcpServers klíč servers se stejným obsahem.
• V organizaci může MCP servery povolovat nebo zakazovat správce přes pravidla GitHub Copilot.

Podle oficiální dokumentace: Add and manage MCP servers in VS Code.

Gemini CLI

Příkazem v terminálu, nebo zápisem do ~/.gemini/settings.json (pro projekt .gemini/settings.json). Pro Streamable HTTP patří adresa do klíče httpUrl; klíč url znamená starší přenos SSE.

gemini mcp add --transport http iustoria https://www.iustoria.cz/mcp

{
  "mcpServers": {
    "iustoria": {
      "httpUrl": "https://www.iustoria.cz/mcp"
    }
  }
}

Podle oficiální dokumentace: MCP servers with the Gemini CLI.

Další aplikace

• Mistral Le Chat: Connectors → + Add Connector → Custom MCP Connector, zadejte název a Server URL; ověřování Le Chat rozpozná sám. Konektory přidává správce účtu. Dokumentace Mistral
• Microsoft Copilot Studio: v agentovi Tools → Add a tool → New tool → Model Context Protocol, vyplňte název, popis a Server URL, Authentication nastavte na None a potvrďte Create a Add to agent. Dokumentace Microsoft
• Windsurf (Devin Desktop): do mcp_config.json zapište {"mcpServers":{"iustoria":{"serverUrl":"https://www.iustoria.cz/mcp"}}}. Dokumentace
• LM Studio (od verze 0.3.17): na kartě Program zvolte Install → Edit mcp.json a zapište {"mcpServers":{"iustoria":{"url":"https://www.iustoria.cz/mcp"}}}. Dokumentace LM Studio

Volání z vlastní aplikace přes API

Claude API (MCP connector)

Ve volání Messages API server uvedete v mcp_servers a jeho nástroje zpřístupníte v tools položkou mcp_toolset. Funkce je v betě, proto hlavička anthropic-beta.

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: mcp-client-2025-11-20" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 4096,
    "mcp_servers": [{"type": "url", "url": "https://www.iustoria.cz/mcp", "name": "iustoria"}],
    "tools": [{"type": "mcp_toolset", "mcp_server_name": "iustoria"}],
    "messages": [{"role": "user", "content": "Kdy se promlčí faktura splatná 31. 5. 2024?"}]
  }'

Podle oficiální dokumentace: MCP connector (Claude API).

OpenAI Responses API

Server přidáte jako nástroj typu mcp. Bez require_approval: "never" požádá API před každým voláním o souhlas.

{
  "type": "mcp",
  "server_label": "iustoria",
  "server_url": "https://www.iustoria.cz/mcp",
  "require_approval": "never"
}

Podle oficiální dokumentace: Connectors and MCP servers (OpenAI).

Jiný klient a ruční zkouška

Jiný klient

Klientovi zadejte adresu https://www.iustoria.cz/mcp a přenos Streamable HTTP; přihlášení není. Server je bezstavový, stačí poslat zprávu JSON-RPC metodou POST. Seznam nástrojů:

curl -s https://www.iustoria.cz/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Volání nástroje (tentýž vstup jako první příklad na stránce promlceni):

curl -s https://www.iustoria.cz/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"promlceni","arguments":{"typ":"splatnost","splatnost":"2024-05-31"}}}'

Šablony dotazů vrátí prompts/list, text šablony prompts/get s názvem šablony. Pro interaktivní zkoušku se hodí nástroj MCP Inspector s přenosem Streamable HTTP.

Adresa serveru otevřená v prohlížeči přesměruje na dokumentaci. Každá odpověď serveru na ni odkazuje hlavičkou Link (rel="service-doc") a na popis pro stroje /mcp/README.md (rel="service-desc").

Odpovědi serveru a řešení potíží

Revizi protokolu 2026-07-28 server nepodporuje. Klient, který ji pošle, dostane chybu 400 se seznamem podporovaných verzí; klient, který umí i starší revize, se připojí inicializací (initialize) s některou z nich. Jak klient a server verzi vyjednávají, popisuje specifikace MCP. Chybové zprávy nesou kontakt na podporu v poli error.data.podpora.

Časté otázky