---
title: Časté problémy
order: 5
description: Co dělat, když něco neklape — Bearer invalid, connection timeout, tool empty.
---
# Časté problémy

---

## „Bearer token invalid" / 401

**Příčiny**:
- Token byl revoknutý v `/konektory` → ikona koš
- Tok ses pokoušel zkopírovat víc než 1× (token se zobrazí jen jednou při vygenerování — vytvoř nový)
- Špatně paste — chybí prefix `ak2_` nebo nějaké znaky se ztratily

**Řešení**:
1. Jdi do `/konektory`
2. Vygeneruj **nový** klíč
3. Aktualizuj config v Claude Desktop / Claude Code
4. Restart Claude

---

## „Connection timeout" / Claude ne připojí

**Příčiny**:
- Akademie není dostupná (zkus `curl https://akademie.davidkirs.cz/api/health`)
- `mcp-remote` adapter není nainstalovaný (npx by ho měl stáhnout sám při prvním spuštění)
- Firewall blokuje výchozí port

**Řešení**:
1. Ověř, že `/api/health` vrátí `{ "status": "ok" }`
2. V Claude Desktop logu (Help → View Logs) hledej `ja2-akademie` zmínky
3. V Claude Code `claude mcp list` musí ukázat `ja2-akademie` jako available

---

## „Tool returns empty"

Pokud Claude zavolá `ja2_get_personal_context` a dostane prázdné pole:

- Tvůj **strukturovaný kontext zatím není vyplněný**. Jdi do `/profil` → tab Strukturovaný → uvidíš všechny sloty + tlačítko „Doplnit s Angelem"
- Pohovoř si chvíli s Angelem (na `/angel`) — on si poznámkuje insighty
- V `/checkpoint` schválíš, co se má zapsat
- Příští volání tool už vrátí data

---

## „Forbidden" u Studio tools

`ja2_workspace_*` tooly vyžadují permission **`akademie.workspace`**. Default ji nemá nikdo krom adminů (`*` wildcard).

**Řešení**:
- Pokud chceš Studio, kontaktuj admina akademie (David), ať ti permission přidá
- Pro běžnou práci stačí strukturované sloty (osobní/expertní/značky/projekty) — Studio je pro tech-savvy power usery

---

## „Token vypršel" v GitHub sync

GitHub Personal Access Token má expiration (default 30/60/90 dní podle nastavení).

**Řešení**:
1. Jdi na [github.com/settings/tokens](https://github.com/settings/tokens)
2. Vytvoř nový token se scope `repo`
3. V `/profil/nastaveni` → odpojit + znovu připojit s novým tokenem

---

## Auto-sync neproběhl

Pokud máš v `/profil/nastaveni` zapnutý **Auto-sync**, ale GitHub repo nedostává commits:

- Auto-sync má **debounce 10 minut per user** — pokud editují víc souborů za sebou, sync proběhne jen 1× za 10 min (úspora GitHub rate limitu)
- Zkontroluj `last_synced` čas — pokud je starší než 10 min, něco selhalo
- Manual „Sync teď" tlačítko obejde debounce

---

## „Hidden from Angel" — Studio file privacy

Pokud máš v Studiu soubor s toggle **„Skryté"** (oranžová EyeOff ikona):

- Angel ho v system promptu nevidí
- Sync **přesto** ho do GitHub repu pushne (záloha)
- Pokud chceš úplně vyloučit z všeho, smaž ho ze Studio (mazání je hard delete v platformě, ale GitHub kopie zůstane — to je úmysl pro data safety)

---

## Něco jiného?

Pokud máš problém, který tady není:

- **Pro registrované uživatele**: napiš mail na `david@davidkirs.cz` nebo otevři ticket v `/podpora`
- **Pro vývojáře**: GitHub repo akademie má issues — `github.com/herter72/ja2-academy-platform/issues`

Když popíšeš situaci, přidej:
- Co jsi udělal (poslední kroky)
- Co Claude udělal (logs / response text)
- Status v `/konektory` audit logu