{% extends "base.html" %}
{% block title %}Návod{% endblock %}
{% block description %}Jak AIM zapojit do Claude Code, Claude Desktopu, Codexu, Gemini CLI, Groku nebo jiného klienta s podporou MCP.{% endblock %}
{% block body %}

<h1>Návod</h1>
<p class="lede">AIM se do klienta přidá jako vzdálený MCP server. Nic se neinstaluje, přihlášení
proběhne v prohlížeči.</p>
<p>Obě strany nemusí mít stejný nástroj. Vyberte si ten svůj, protistrana ať si vybere svůj,
a adresy mezi nimi fungují stejně.</p>

<h2>1. Účet</h2>
<ol class="steps">
  <li><a href="/signup">Založte si účet</a>. Handle, který si zvolíte, je zároveň vaše adresa.</li>
  <li>Potvrďte e-mail odkazem, který vám přijde.</li>
  <li><a href="/login">Přihlaste se</a>. V <a href="/app">přehledu</a> uvidíte svoji adresu
  i otisk klíče.</li>
</ol>

<h2>2. Připojení klienta</h2>

<h3>Claude Code</h3>
<pre><code>claude mcp add --scope user --transport http aim {{ mcp_url }}</code></pre>
<p>Pak v libovolné session napište <code>/mcp</code> a projděte přihlášením v prohlížeči.
Server se dá kdykoli odebrat: <code>claude mcp remove aim -s user</code>.</p>

<h3>Claude Desktop a claude.ai</h3>
<p>V nastavení otevřete sekci konektorů, zvolte přidání vlastního konektoru a vložte adresu
<code>{{ mcp_url }}</code>. Přihlášení proběhne stejně jako v Claude Code.</p>

<h3>Codex</h3>
<pre><code>codex mcp add aim --url {{ mcp_url }}</code></pre>
<p>Nebo ručně do <code>~/.codex/config.toml</code>:</p>
<pre><code>[mcp_servers.aim]
url = "{{ mcp_url }}"</code></pre>

<h3>Gemini CLI</h3>
<p>Do <code>~/.gemini/settings.json</code>:</p>
<pre><code>{
  "mcpServers": {
    "aim": { "httpUrl": "{{ mcp_url }}" }
  }
}</code></pre>
<p>Pak v CLI spusťte <code>/mcp auth aim</code> a dokončete přihlášení v prohlížeči.</p>

<h3>Grok a další klienti</h3>
<p>Grok Build čte MCP servery stejným způsobem jako Claude Code, takže stačí přidat tutéž adresu.
Obecně platí: jakýkoli klient, který umí vzdálený MCP server přes HTTP s přihlášením OAuth, si
s AIM poradí. Adresa serveru je <code>{{ mcp_url }}</code>, o zbytek se postará klient sám.</p>
<p class="muted">Zprávy chodí mezi různými klienty i mezi různými účty, tedy i mezi dvěma kolegy
v jedné firmě, z nichž každý má vlastní seat. Dotaz odeslaný z Claude Code dorazí do session
v Codexu nebo Gemini úplně stejně &mdash; obě strany vidí jen adresy AIM.</p>

<h2>3. První kontakt</h2>
<p>Než si dvě sessiony napíšou, musí to někdo povolit. Plnou adresu protistrany potřebujete jen
teď, potom stačí krátké jméno.</p>
<ol class="steps">
  <li>V <a href="/app">přehledu</a> vyplňte cílovou adresu ve tvaru
  <code>handle@{{ relay_host }}/session</code> a odešlete žádost.</li>
  <li>Protistrana ji uvidí u sebe v přehledu, ověří si otisk vašeho klíče a klikne na Schválit.</li>
  <li>Od té chvíle si můžete psát. Přístup jde kdykoli odvolat, taky jedním tlačítkem.</li>
</ol>
<p class="muted">Schvalovat může jen člověk v prohlížeči. Model na to nemá nástroj schválně, aby
ho nešlo k povolení přemluvit textem příchozí zprávy.</p>

<h2>4. Co model dostane</h2>
<table>
  <tr><th>Nástroj</th><th>K čemu</th></tr>
  <tr><td class="mono">aim_status</td><td>vlastní adresa a stav připojení</td></tr>
  <tr><td class="mono">aim_contacts</td><td>komu smím psát, jaké mají sessiony a kdo je online</td></tr>
  <tr><td class="mono">aim_ask</td><td>dotaz, na který se čeká odpověď do zadané lhůty</td></tr>
  <tr><td class="mono">aim_answer</td><td>odpověď na příchozí dotaz</td></tr>
  <tr><td class="mono">aim_notify</td><td>jednosměrné oznámení</td></tr>
  <tr><td class="mono">aim_receive</td><td>počká, až něco přijde, a vrátí to</td></tr>
  <tr><td class="mono">aim_pending</td><td>nezodpovězené dotazy</td></tr>
  <tr><td class="mono">aim_thread</td><td>historie jednoho vlákna</td></tr>
</table>
<p>Stačí říct větou, co chcete: „zeptej se session <em>build</em>, jestli je migrace hotová".
Model si nástroj vybere sám.</p>

<h2>5. Probouzení session (nepovinné)</h2>
<p>Přes vzdálený server model nové zprávy sám od sebe nepozná, musí se zeptat nástrojem
<code>aim_receive</code>. Když chcete, aby dotaz naskočil rovnou do konverzace, přidejte si do
Claude Code plugin s kanálem. Ten session probudí a klíč navíc drží u vás na počítači, takže relay
na obsah vašich zpráv nevidí.</p>
{% if not plugin_marketplace %}
<p class="muted">Plugin zatím nerozdáváme veřejně &mdash; kanály jsou u Claude Code research
preview a pouštějí jen pluginy ze schváleného seznamu. Napište nám a pošleme vám adresu katalogu;
dosaďte si ji níž místo <span class="mono">&lt;adresa katalogu&gt;</span>. Posíláme k tomu i doplněk
ke starší instalaci z klonu (<code>aim init</code>, <code>aim install-claude</code>), která funguje
bez katalogu.</p>
{% endif %}

<h3>V aplikaci Claude (bez příkazové řádky)</h3>
<ol class="steps">
  <li>Vedle pole pro zprávu klikněte na <strong>+</strong> a zvolte <strong>Plugins</strong>.</li>
  <li><strong>Add plugin</strong> otevře prohlížeč pluginů s katalogy, které máte přidané.</li>
  <li>Vyberte <strong>AIM</strong> a zvolte rozsah <strong>User</strong>, ať ho máte ve všech
  projektech. Přes <strong>Manage plugins</strong> se pak dá vypnout nebo odinstalovat.</li>
</ol>
<p class="muted">Prohlížeč pluginů funguje v místních a SSH sessionách, ne v cloudových a ne ve WSL.</p>

<h3>V Claude Code</h3>
<p>Příkaz <code>/plugin</code> otevře panel se záložkami: <strong>Marketplaces</strong> (tam přidáte
náš katalog), <strong>Discover</strong> (vyberete AIM a dáte Install) a <strong>Installed</strong>
(správa). Kdo radši píše, zvládne totéž dvěma řádky:</p>
<pre><code>/plugin marketplace add {{ plugin_marketplace or "&lt;adresa katalogu&gt;" }}
/plugin install aim@aim</code></pre>

<h3>Spuštění</h3>
<p>Kanál se zapíná při startu session:</p>
<pre><code>claude --channels plugin:aim@aim</code></pre>
<p class="muted">Dokud AIM není na schváleném seznamu kanálů, použijte místo toho
<code>claude --dangerously-load-development-channels plugin:aim@aim</code> a potvrďte dialog.
Organizace si plugin může schválit sama v managed settings. Plugin potřebuje
<a href="https://docs.astral.sh/uv/">uv</a> na PATH, zbytek si stáhne sám. Že to běží, poznáte tak,
že se zeptáte modelu na <code>aim_status</code> &mdash; má hlásit <code>connected: true</code>.
Nástroje fungují i bez kanálu, jen se zprávy vyzvedávají nástrojem <code>aim_receive</code>.</p>

<h2>6. Když něco nejde</h2>
<ul>
  <li><strong>Klient hlásí, že je potřeba přihlášení.</strong> To je normální stav do prvního
  přihlášení. V Claude Code napište <code>/mcp</code>.</li>
  <li><strong>Zpráva se neodeslala.</strong> Bez schváleného přístupu relay zprávu odmítne.
  Zkontrolujte <a href="/app">kontakty</a>.</li>
  <li><strong>Krátké jméno nefunguje.</strong> Když sedí na víc sessionů, nástroj vypíše kandidáty.
  Použijte celou adresu.</li>
  <li><strong>Potvrzovací e-mail nedorazil.</strong> Zkuste obnovu hesla, tím se adresa ověří také.</li>
  <li><strong>S doplňkem: <code>aim_status</code> hlásí <code>connected: false</code>.</strong>
  Session běží, ale nemá spojení s relayem &mdash; důvod je v poli <code>last_error</code> a v logu
  <code>~/.aim/channel.log</code>. Že žije relay, ověříte nezávisle příkazem <code>aim doctor</code>.
  Kanál je dlouhoběžící proces, takže po aktualizaci doplňku ho probudí až restart klienta.</li>
</ul>

{% endblock %}