---
title: Připojení Claude Desktop / Code
order: 3
description: Krok-za-krokem návod jak připojit MCP server k tvému Claude klientovi.
---
# Připojení Claude

Akademie podporuje **Claude Desktop** i **Claude Code (CLI)**. Pro oba je proces:

1. Vygenerovat MCP klíč v `/konektory`
2. Zkopírovat **universal prompt** (Akademie ti ho vygeneruje)
3. Vložit ho do Claude — Claude se sám napojí

Universal prompt funguje pro oba klienty — detekuje, kde běží, a postupuje podle toho.

---

## 1) Vygeneruj MCP klíč

Po přihlášení v akademii:

1. Jdi na `/konektory` (v sidebaru „Konektory")
2. Klikni **„Vytvořit klíč"** → zadej název (např. `Claude Desktop` / `Claude Code`)
3. Akademie vygeneruje token `ak2_xxxxx...` (32 base64url znaků)
4. **Zkopíruj universal prompt** — celý paste — token se zobrazí jen 1×, nikde se neuloží

---

## 2a) Claude Desktop

Akademie ti dá universal prompt. Stačí ho **přilepit** do Claude Desktop — Claude tě sám provede konfigurací. Pod kapotou se přidá tohle do `claude_desktop_config.json`:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "ja2-akademie": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://akademie.davidkirs.cz/api/mcp",
        "--header",
        "Authorization: Bearer ak2_xxxxx"
      ]
    }
  }
}
```

> `mcp-remote` je Anthropic adapter — překládá lokální stdio MCP na HTTP JSON-RPC. Žádná manuální instalace, `npx` to stáhne sám.

Po uložení **restartuj Claude Desktop**. V status baru (vlevo dole) se objeví ikona pro `ja2-akademie`.

---

## 2b) Claude Code (CLI)

Z universal promptu zkopíruj příkaz a spusť ho v terminálu:

```bash
claude mcp add --transport http ja2-akademie \
  https://akademie.davidkirs.cz/api/mcp \
  --header "Authorization: Bearer ak2_xxxxx"
```

Pak v Claude Code session by se měl `ja2-akademie` objevit v dostupných MCP serverech. Můžeš si ověřit:

```bash
claude mcp list
```

---

## 3) Ověření

Po připojení napiš Claude:

> *„Ahoj, kdo jsem?"*

Claude by měl zavolat `ja2_bootstrap` a vrátit ti shrnutí — tvoje jméno, kolik máš značek, projektů, atd. Pokud je kontext prázdný (čerstvý účet), Claude tě tím sám provede.

Další ověřovací prompt:

> *„Pomoz mi s landing page pro projekt X."*

Claude by měl zavolat `ja2_list_projects` → `ja2_get_project(id)` → vrátit ti návrh **na míru tvého brandu + soul clienta**.

---

## Audit log

Každé MCP volání se loguje do `mcp_audit_log` — v `/konektory` vidíš posledních 10 volání: tool name, status, durace. Pokud Claude nějaký tool nezavolal nebo dostal error, uvidíš to tam.

---

## Co dál?

- [Příklady použití](/docs/examples) — typické prompty + tool flows
- [Časté problémy](/docs/troubleshoot) — connection timeout, Bearer invalid, …