---
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 — klíč je dlouhý JWT (začíná `eyJ…`); když se část ztratí, podpis nesedí
- Klíč vypršel (má expiraci — v `/konektory` vidíš dokdy platí)

**Ř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://app.ja2.academy/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_me` a dostane prázdný kontext:

- Tvoje **Paměť zatím není vyplněná**. Jdi na stránku **Paměť** — uvidíš karty (Já, Byznys, Zákazník, Záměr…); každou můžeš rozkliknout a napsat rovnou, nebo ji nech naplnit rozhovorem
- Pohovoř si chvíli s Aijou (na `/angel`) — poznámkuje si, co je důležité
- Postřehy s nižší jistotou čekají na Paměti v sekci **„Ke schválení"** — schval, co se má zapsat
- Příští volání tool už vrátí data

---

## „Forbidden" u Studio tools

`ja2_workspace` vyžaduje permission **`akademie.workspace`**. Default ji nemá nikdo krom adminů (`*` wildcard).

**Řešení**:
- Pokud chceš Studio, kontaktuj admina akademie, ať ti permission přidá
- Pro běžnou práci stačí Paměť a 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 `/settings/github` → odpojit + znovu připojit s novým tokenem

---

## Auto-sync neproběhl

Pokud máš v `/settings/github` 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

---

## „Skryté před Aijou" — Studio file privacy

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

- Aija 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 `ja2@davidkirs.cz` nebo se ozvi přes `/podpora`
- **Pro vývojáře**: GitHub repo akademie má issues — `github.com/herter72/ja2-akademie/issues` (post-split standalone repo)

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