JÁ2 Akademie/ docs

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

{
  "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:

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:

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?