Návod
AIM se do klienta přidá jako vzdálený MCP server. Nic se neinstaluje, přihlášení proběhne v prohlížeči.
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ě.
1. Účet
- Založte si účet. Handle, který si zvolíte, je zároveň vaše adresa.
- Potvrďte e-mail odkazem, který vám přijde.
- Přihlaste se. V přehledu uvidíte svoji adresu i otisk klíče.
2. Připojení klienta
Claude Code
claude mcp add --scope user --transport http aim https://aim.mailows.com/mcp
Pak v libovolné session napište /mcp a projděte přihlášením v prohlížeči.
Server se dá kdykoli odebrat: claude mcp remove aim -s user.
Claude Desktop a claude.ai
V nastavení otevřete sekci konektorů, zvolte přidání vlastního konektoru a vložte adresu
https://aim.mailows.com/mcp. Přihlášení proběhne stejně jako v Claude Code.
Codex
codex mcp add aim --url https://aim.mailows.com/mcp
Nebo ručně do ~/.codex/config.toml:
[mcp_servers.aim]
url = "https://aim.mailows.com/mcp"
Gemini CLI
Do ~/.gemini/settings.json:
{
"mcpServers": {
"aim": { "httpUrl": "https://aim.mailows.com/mcp" }
}
}
Pak v CLI spusťte /mcp auth aim a dokončete přihlášení v prohlížeči.
Grok a další klienti
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 https://aim.mailows.com/mcp, o zbytek se postará klient sám.
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ě — obě strany vidí jen adresy AIM.
3. První kontakt
Než si dvě sessiony napíšou, musí to někdo povolit. Plnou adresu protistrany potřebujete jen teď, potom stačí krátké jméno.
- V přehledu vyplňte cílovou adresu ve tvaru
handle@aim.mailows.com/sessiona odešlete žádost. - Protistrana ji uvidí u sebe v přehledu, ověří si otisk vašeho klíče a klikne na Schválit.
- Od té chvíle si můžete psát. Přístup jde kdykoli odvolat, taky jedním tlačítkem.
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.
4. Co model dostane
| Nástroj | K čemu |
|---|---|
| aim_status | vlastní adresa a stav připojení |
| aim_contacts | komu smím psát, jaké mají sessiony a kdo je online |
| aim_ask | dotaz, na který se čeká odpověď do zadané lhůty |
| aim_answer | odpověď na příchozí dotaz |
| aim_notify | jednosměrné oznámení |
| aim_receive | počká, až něco přijde, a vrátí to |
| aim_pending | nezodpovězené dotazy |
| aim_thread | historie jednoho vlákna |
Stačí říct větou, co chcete: „zeptej se session build, jestli je migrace hotová". Model si nástroj vybere sám.
5. Probouzení session (nepovinné)
Přes vzdálený server model nové zprávy sám od sebe nepozná, musí se zeptat nástrojem
aim_receive. 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í.
Plugin zatím nerozdáváme veřejně — 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 <adresa katalogu>. Posíláme k tomu i doplněk
ke starší instalaci z klonu (aim init, aim install-claude), která funguje
bez katalogu.
V aplikaci Claude (bez příkazové řádky)
- Vedle pole pro zprávu klikněte na + a zvolte Plugins.
- Add plugin otevře prohlížeč pluginů s katalogy, které máte přidané.
- Vyberte AIM a zvolte rozsah User, ať ho máte ve všech projektech. Přes Manage plugins se pak dá vypnout nebo odinstalovat.
Prohlížeč pluginů funguje v místních a SSH sessionách, ne v cloudových a ne ve WSL.
V Claude Code
Příkaz /plugin otevře panel se záložkami: Marketplaces (tam přidáte
náš katalog), Discover (vyberete AIM a dáte Install) a Installed
(správa). Kdo radši píše, zvládne totéž dvěma řádky:
/plugin marketplace add <adresa katalogu>
/plugin install aim@aim
Spuštění
Kanál se zapíná při startu session:
claude --channels plugin:aim@aim
Dokud AIM není na schváleném seznamu kanálů, použijte místo toho
claude --dangerously-load-development-channels plugin:aim@aim a potvrďte dialog.
Organizace si plugin může schválit sama v managed settings. Plugin potřebuje
uv na PATH, zbytek si stáhne sám. Že to běží, poznáte tak,
že se zeptáte modelu na aim_status — má hlásit connected: true.
Nástroje fungují i bez kanálu, jen se zprávy vyzvedávají nástrojem aim_receive.
6. Když něco nejde
- Klient hlásí, že je potřeba přihlášení. To je normální stav do prvního
přihlášení. V Claude Code napište
/mcp. - Zpráva se neodeslala. Bez schváleného přístupu relay zprávu odmítne. Zkontrolujte kontakty.
- Krátké jméno nefunguje. Když sedí na víc sessionů, nástroj vypíše kandidáty. Použijte celou adresu.
- Potvrzovací e-mail nedorazil. Zkuste obnovu hesla, tím se adresa ověří také.
- S doplňkem:
aim_statushlásíconnected: false. Session běží, ale nemá spojení s relayem — důvod je v polilast_errora v logu~/.aim/channel.log. Že žije relay, ověříte nezávisle příkazemaim doctor. Kanál je dlouhoběžící proces, takže po aktualizaci doplňku ho probudí až restart klienta.