JÁ² AkademieJÁ² 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 menu „Konektory")
  2. Klikni „Vytvořit klíč" → zadej název (např. Claude Desktop / Claude Code)
  3. Akademie vygeneruje dlouhý klíč (JWT, začíná eyJ…)
  4. Zkopíruj universal prompt — celý paste — klíč se zobrazí jen 1×, pak už ho nikde nevyčteš

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://app.ja2.academy/api/mcp",
        "--header",
        "Authorization: Bearer <tvuj-klic>"
      ]
    }
  }
}

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

Jednodušší cesta (novější Claude Desktop): Nastavení → Konektory → Přidat vlastní konektor → URL https://app.ja2.academy/api/mcp + tvůj klíč jako Bearer token. Bez editace configu.

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://app.ja2.academy/api/mcp \
  --header "Authorization: Bearer <tvuj-klic>"

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áš projektů/prostorů, 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_project (action list → get) → vrátit ti návrh na míru tvého prostoru/projektu a tvého ideálního klienta.

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?