# Připojení MCP serveru IUSTORIA

> Jak připojit MCP server IUSTORIA ke Claude, Claude Code, ChatGPT, Cursor, VS Code, Gemini CLI a dalším klientům: adresa, postup krok za krokem.

- Canonical URL: https://www.iustoria.cz/ai-asistenti/pripojeni/
- Markdown URL: https://www.iustoria.cz/ai-asistenti/pripojeni/index.md
- Language: cs
- Content type: mcp
- Modified: 2026-10-01

## Stručně

- MCP server IUSTORIA připojíte jako vzdálený server MCP s adresou https://www.iustoria.cz/mcp, přenosem Streamable HTTP a bez přihlášení. V Claude ho přidáte v Customize → Connectors jako vlastní konektor, v Claude Code příkazem claude mcp add, v ChatGPT v režimu pro vývojáře, v Cursoru, VS Code a Gemini CLI zápisem do konfigurace. Server je bezplatný, bezstavový a podporuje verze protokolu 2025-11-25, 2025-06-18, 2025-03-26 a 2024-11-05. Postupy vycházejí z oficiální dokumentace klientů ke dni 1. 10. 2026.

## Content

## Co budete potřebovat

|   |   |
| --- | --- |
| Adresa serveru | `https://www.iustoria.cz/mcp` |
| Přenos | Streamable HTTP, JSON-RPC 2.0; server je bezstavový, nepoužívá relace (`Mcp-Session-Id`) ani proud SSE |
| Přihlášení | žádné: bez OAuth, bez klíče, bez registrace |
| Verze protokolu | `2025-06-18`, `2025-11-25`, `2025-03-26`, `2024-11-05`; klient, který žádá neznámou verzi, dostane `2025-06-18` |
| Schopnosti | `tools`, `prompts` a `resources` (formuláře vzorů a poptávky jako aplikace MCP) |
| Název v klientech | IUSTORIA – průvodci a právní kalkulačky (`serverInfo.name`: `iustoria`), s ikonou kanceláře |
| Registr MCP serverů | [`cz.iustoria/pruvodci`](https://registry.modelcontextprotocol.io/v0.1/servers?search=cz.iustoria/pruvodci) |

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](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp), [Use connectors to extend Claude’s capabilities](https://support.claude.com/en/articles/11176164-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](https://support.claude.com/en/articles/11176164-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.

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

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

Soubor .mcp.json v kořeni projektu:

```text
{
  "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](https://code.claude.com/docs/en/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)](https://developers.openai.com/api/docs/guides/developer-mode), [Connect from ChatGPT (OpenAI)](https://developers.openai.com/plugins/deploy/connect-chatgpt), [Developer mode and MCP apps in ChatGPT (nápověda OpenAI)](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt).

### Cursor

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

```text
{
  "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)](https://cursor.com/docs/context/mcp).

### 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:

```text
{
  "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](https://code.visualstudio.com/docs/agent-customization/mcp-servers).

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

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

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

Podle oficiální dokumentace: [MCP servers with the Gemini CLI](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md).

### 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](https://docs.mistral.ai/le-chat/knowledge-integrations/connectors/mcp-connectors)
- 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](https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-existing-server-to-agent)
- Windsurf (Devin Desktop): do `mcp_config.json` zapište `{"mcpServers":{"iustoria":{"serverUrl":"https://www.iustoria.cz/mcp"}}}`. [Dokumentace](https://docs.devin.ai/desktop/cascade/mcp)
- 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](https://lmstudio.ai/docs/app/mcp)

## 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`.

```text
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)](https://platform.claude.com/docs/en/agents-and-tools/mcp-connector).

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

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

Podle oficiální dokumentace: [Connectors and MCP servers (OpenAI)](https://developers.openai.com/api/docs/guides/tools-connectors-mcp).

## 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ů:

```text
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`](https://www.iustoria.cz/ai-asistenti/nastroje/promlceni/)):

```text
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](https://modelcontextprotocol.io/docs/tools/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](https://www.iustoria.cz/mcp/README.md) (`rel="service-desc"`).

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

| Situace | Co server vrátí |
| --- | --- |
| `POST` se zprávou JSON-RPC | 200 a odpověď `application/json`; dávka nejvýš 20 zpráv |
| Jen notifikace (třeba `notifications/initialized`) | 202 bez těla |
| `GET` od klienta MCP | 405: server neposílá zprávy sám od sebe a proud SSE nenabízí |
| Adresa otevřená v prohlížeči | 303 na tuto dokumentaci |
| Cizí hlavička `Origin` | 403 a chyba −32000; požadavky ze stránek jiných webů server nepřijímá |
| Nepodporovaná verze v hlavičce `MCP-Protocol-Version` | 400 a chyba −32600 se seznamem podporovaných verzí |
| Neznámý nástroj nebo neznámý parametr | chyba −32602 s polem `error.data.chyby` |
| Neznámá metoda | chyba −32601 |

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](https://modelcontextprotocol.io/specification/versioning). Chybové zprávy nesou kontakt na podporu v poli `error.data.podpora`.

## Časté otázky

### Jaká je adresa MCP serveru IUSTORIA?

https://www.iustoria.cz/mcp. Přenos je Streamable HTTP (JSON-RPC 2.0), přihlášení ani klíč nejsou potřeba.

### Potřebuji placený tarif Claude nebo ChatGPT?

V Claude ne: vlastní konektor jde přidat ve všech tarifech, ve Free jeden. V ChatGPT jsou vlastní MCP servery dostupné jen v režimu pro vývojáře v placených tarifech; který tarif co umí, uvádí OpenAI na dvou místech různě (viz oddíl ChatGPT).

### Proč server v prohlížeči nic neukáže?

Adresa serveru není webová stránka. Prohlížeč server přesměruje sem na dokumentaci (kód 303); klient MCP posílá zprávy JSON-RPC metodou POST.

### Podporuje server revizi protokolu 2026-07-28?

Ne. Server podporuje verze 2025-11-25, 2025-06-18, 2025-03-26 a 2024-11-05. Klient, který pošle novější revizi, 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 ověřím, že připojení funguje?

Nechte si od modelu vypsat nástroje serveru, nebo pošlete metodou POST zprávu tools/list (příklad s curl je na této stránce). Odpověď obsahuje všechny nástroje, které server právě nabízí.