Návody
Používejte nahrávky z Vocatimu v aplikacích AI na svém Macu
Vocatim pro Mac může aplikaci AI na stejném Macu, například Claude Desktop, ChatGPT nebo Codex, povolit číst vaše nahrávky: zobrazit jejich seznam, prohledávat je a číst jejich přepisy, shrnutí, poznámky a překlady. Přístup je jen pro čtení: aplikace AI nemůže nic nahrát, změnit ani smazat a nikdy nedostane zvuk. Funkce je ve výchozím stavu vypnutá a po zapnutí funguje jen tehdy, když je Vocatim otevřený.
Nejdřív ve Vocatimu
Na Macu otevřete Nastavení → Data a zařízení → Aplikace AI na tomto Macu a funkci zapněte. Přečtěte si obrazovku, která vysvětluje, co aplikace AI vidí, a pak klikněte na Zapnout. Potom postupujte podle kroků pro svou aplikaci AI.

Claude Desktop
- Klikněte na Nainstalovat do Claude Desktop a uložte soubor Vocatim.mcpb, kam chcete, například do složky Stahování. Jakmile je soubor uložený, Vocatim zkopíruje klíč Vocatim.
- Otevřete soubor Vocatim.mcpb. Claude Desktop zobrazí rozšíření Vocatim a zeptá se, zda ho má nainstalovat.
- Až Claude Desktop požádá o klíč, vložte ho do pole Klíč Vocatim. Pole Program vocatim-mcp ponechte beze změny.
- V novém chatu se zeptejte například: „Co jsme rozhodli v mé poslední nahrávce ve Vocatimu?“ Claude vás může požádat o povolení nástroje Vocatim.
Chcete raději upravit konfiguraci sami? Klikněte na Zkopírovat konfiguraci pro Claude Desktop. V Claude Desktop otevřete nabídku Claude na řádku nabídek macOS (ne nastavení uvnitř okna Claude) a vyberte Settings… → Developer → Edit Config. Pokud soubor ještě neobsahuje "mcpServers", nahraďte jeho obsah celým příkladem níže. Pokud už nějaké servery obsahuje, vložte jen položku "vocatim" dovnitř "mcpServers", s čárkou mezi ní a předchozí položkou. Soubor uložte, Claude Desktop úplně ukončete a znovu ho otevřete.
{
"mcpServers": {
"vocatim": { … paste from Vocatim … }
}
}ChatGPT a Codex
- Klikněte na Zkopírovat konfiguraci pro ChatGPT a Codex.
- Otevřete soubor
~/.codex/config.tomlv textovém editoru, nebo ho vytvořte, pokud ještě neexistuje.~/.codexje skrytá složka ve vaší domovské složce: ve Finderu vyberte Otevřít → Otevřít složku… a zadejte~/.codex. - Pokud soubor nemá sekci
[mcp_servers.vocatim], vložte konfiguraci na nový řádek na konec souboru. Pokud ji už má z dřívější konfigurace, nahraďte celou tuto sekci novou. Soubor nesmí sekci obsahovat dvakrát. - Soubor uložte a restartujte ChatGPT nebo Codex.
- V novém chatu se zeptejte například: „Co jsme rozhodli v mé poslední nahrávce ve Vocatimu?“ V ChatGPT používejte Vocatim v konverzaci Codex, ne v běžném chatu.
[mcp_servers.vocatim]
command = "/Applications/Vocatim.app/Contents/MacOS/vocatim-mcp"
args = ["--port", "…", "--token", "…"]
codex mcp list zobrazuje klíč Vocatim ve sloupci Args. Klíč umožňuje číst Vocatim jen aplikacím na tomto Macu, a to jen tehdy, když je Vocatim otevřený. Tento výstup nesdílejte; pokud jste ho už sdíleli, použijte ve Vocatimu „Resetovat klíč“.
VS Code, Cursor a LM Studio
- Klikněte na Nainstalovat do VS Code, Přidat do Cursoru nebo Přidat do aplikace LM Studio. Vocatim otevře danou aplikaci s konfigurací pro Vocatim.
- V aplikaci potvrďte, že chcete Vocatim přidat.
- U VS Code Vocatim zkopíruje klíč Vocatim: až VS Code požádá o Klíč Vocatim, vložte ho. Cursor a LM Studio dostanou klíč spolu s konfigurací a uloží si ho do vlastních nastavení.
- V chatu s AI v dané aplikaci se zeptejte například: „Co jsme rozhodli v mé poslední nahrávce ve Vocatimu?“
Jiné aplikace: Cursor, LM Studio, JetBrains AI Assistant a Junie
- Klikněte na Zkopírovat konfiguraci pro jiné aplikace.
- Otevřete nastavení MCP dané aplikace: v Cursoru soubor
~/.cursor/mcp.json, v aplikaci LM Studio její soubormcp.json, v JetBrains AI Assistant Settings → Tools → AI Assistant → MCP a Add, v Junie soubor~/.junie/mcp/mcp.json. - Pokud tam ještě není
"mcpServers", vložte celou konfiguraci. Pokud už jsou tam nějaké servery, přidejte jen položku"vocatim"dovnitř"mcpServers", nebo jí nahraďte starou položku"vocatim". Položka tam nesmí být dvakrát. - Uložte a pak aplikaci restartujte.
Zed
- Klikněte na Zkopírovat konfiguraci pro Zed.
- V Zedu spusťte příkaz
zed: open settings file. - Vložte část
"context_servers"do vnějších složených závorek tohoto souboru. Pokud tam"context_servers"už je, přidejte do této části jen položku"vocatim", nebo jí nahraďte starou položku"vocatim". Položka tam nesmí být dvakrát. - Soubor uložte a pak Zed restartujte.
Vocatim v Terminálu (příkazový řádek)
Své nahrávky můžete číst i v Terminálu na tomto Macu, a to stejnými čtyřmi nástroji jen pro čtení, jaké dostávají aplikace AI: seznam, hledání, přepis a shrnutí. Příkazový řádek používá stejný přepínač a stejný klíč Vocatim jako vaše aplikace AI a funguje jen tehdy, když je Vocatim otevřený a přepínač zapnutý.
- Zkopírujte tento příkaz a vložte ho do okna Terminálu, ale zatím netiskněte klávesu Return:
printf '\n%s\n' "$(pbpaste | grep -m 1 '^alias vocatim=')" >> ~/.zshrc - Ve Vocatimu klikněte na Zkopírovat příkaz CLI. Vocatim zkopíruje jeden řádek: alias s názvem
vocatimpro zsh, výchozí shell v macOS. - Vraťte se do Terminálu a stiskněte Return. Příkaz přidá zkopírovaný řádek na konec souboru
~/.zshrc, který zsh čte při každém otevření okna Terminálu. Přidá jen řádek, který začínáalias vocatim=, takže nic jiného ze schránky se do souboru nedostane. - Otevřete nové okno Terminálu a napište
vocatim list. Alias funguje v oknech, která otevřete po kroku 3.
Čtyři příkazy:
vocatim listzobrazí vašich 20 nejnovějších nahrávek, jednu na řádek: ID, datum a čas, délku a název.vocatim list --limit 50jich zobrazí až 50.vocatim search rozpočetnajde nahrávky, jejichž název, přepis, shrnutí, poznámky nebo některý překlad obsahují „rozpočet“. Dotaz s mezerami dejte do uvozovek:vocatim search "týdenní přehled". Zobrazí až 10 výsledků, s--limit 20až 20.vocatim transcript <id>vypíše celý přepis jedné nahrávky. ID najdete v prvním sloupci výstupuvocatim listavocatim search.vocatim summary <id>vypíše její shrnutí.
Přidejte --json k libovolnému příkazu a dostanete JSON pro vlastní skripty. vocatim help vypíše seznam příkazů.
Váš klíč. Řádek vocatim v ~/.zshrc obsahuje váš klíč Vocatim. Pokud tento řádek vložíte přímo do Terminálu, klíč zůstane i v historii Terminálu. Klíč umožňuje číst Vocatim jen aplikacím na tomto Macu, a to jen tehdy, když je Vocatim otevřený. Řádek ani soubor nesdílejte; pokud jste je už sdíleli, použijte ve Vocatimu „Resetovat klíč“.
Po „Resetovat klíč“ nebo když Vocatim zobrazí „Konfigurace se změnila: nastavte aplikace AI znovu.“, starý řádek přestane fungovat. Zopakujte kroky 1 až 4. Platí nejnovější řádek vocatim v ~/.zshrc; starší můžete smazat.
Po příkazu se v Nastavení Vocatimu u položky Aplikace AI na tomto Macu zobrazí vocatim-cli, stejně jako se tam zobrazuje název aplikace AI.
Příkazový řádek komunikuje jen s Vocatimem na tomto Macu a výsledek vypisuje do vašeho okna Terminálu. Pokud jeho výstup předáte dál, například online službě AI, dostane se tam.
Chcete-li ho odstranit, smažte z ~/.zshrc všechny řádky vocatim; po zopakování kroků 1 až 4 jich tam může být víc. Přestane fungovat i po vypnutí přepínače ve Vocatimu nebo po „Resetovat klíč“.
Když to nefunguje: zprávy příkazového řádku Vocatim začínají vocatim-mcp:.
vocatim-mcp: Vocatim is not open on this Mac, or AI app access is turned off in Vocatim Settings.(Vocatim není na tomto Macu otevřený nebo je přístup aplikací AI vypnutý v Nastavení Vocatimu): otevřete Vocatim a zkontrolujte přepínač. Po „Resetovat klíč“ nebo „Konfigurace se změnila“ zopakujte kroky 1 až 4. Řádek nad touto zprávou, pokud tam je, uvádí technickou příčinu, napříkladvocatim-mcp: connect: Connection refused.zsh: command not found: vocatim: otevřete nové okno Terminálu. Pokud se zpráva zobrazuje dál, zkontrolujte, jestli~/.zshrcobsahuje řádek začínajícíalias vocatim=; pokud ne, zopakujte kroky 1 až 4. Zkontrolujte také, jestliecho $SHELLzobrazí/bin/zsh.zsh: no such file or directorys cestou kvocatim-mcp: řádek ukazuje na místo, kde už Vocatim není, například po přesunutí aplikace. Zopakujte kroky 1 až 4.vocatim-mcp: Too many requests, try again in a moment.(příliš mnoho požadavků, zkuste to za chvíli znovu): chvíli počkejte a spusťte příkaz znovu.vocatimbez příkazu, napříkladvocatimnebovocatim --json, čeká a nic nezobrazí: stiskněte Control-C a pak napište příkaz, napříkladvocatim list.
Pro skripty: data jdou na standardní výstup, celá a jen tehdy, když příkaz uspěje; zprávy jdou na standardní chybový výstup. S --json je každá odpověď Vocatimu jeden řádek JSON, takže transcript vypíše jeden řádek za každou stránku dlouhého přepisu: výstup čtěte řádek po řádku, ne jako jeden dokument JSON. Návratové kódy: 0 hotovo, 1 jiná chyba, 2 chybný příkaz nebo volba, 3 Vocatim není otevřený nebo je přístup vypnutý, 4 příliš mnoho požadavků.
Co opouští váš Mac
Přístup aplikací AI k vašim nahrávkám je ve výchozím stavu vypnutý. Zapínáte ho sami v Nastavení Vocatimu, jen pokud se rozhodnete sdílet své přepisy s aplikacemi AI na tomto Macu.
Samotný Vocatim nic neposílá. Pokud aplikace AI používá online model, jak to obvykle dělají Claude Desktop, ChatGPT a Codex, to, co z Vocatimu přečte, se posílá dané společnosti (Anthropic nebo OpenAI) pod vaším účtem u ní, jako byste to vložili do chatu.
Jak to zastavit
Vypněte přepínač ve Vocatimu. Tlačítko Resetovat klíč zneplatní každý klíč, který jste zkopírovali, i každou konfiguraci, kterou jste vložili. Chcete-li se opět připojit, nastavte aplikaci AI znovu. U rozšíření pro Claude Desktop klikněte ve Vocatimu znovu na Nainstalovat do Claude Desktop, uložte soubor a otevřete ho: jakmile je soubor uložený, Vocatim zkopíruje nový klíč. Vložte ho, až o něj Claude Desktop požádá, nebo do pole Klíč Vocatim rozšíření Vocatim v Claude Desktop. U Cursoru a aplikace LM Studio klikněte znovu na Přidat do Cursoru nebo Přidat do aplikace LM Studio. Pokud jste konfiguraci vkládali ručně, zkopírujte ji znovu a vložte ji místo staré položky nebo sekce. Potom aplikaci AI úplně ukončete (zavřít její okno nestačí) a znovu ji otevřete: do té doby používá starý klíč. Vocatim můžete z aplikace AI také odebrat: rozšíření Vocatim v Claude Desktop, položku "vocatim" v jeho konfiguraci, v nastavení MCP jiné aplikace nebo v souboru nastavení Zedu, nebo sekci [mcp_servers.vocatim] v souboru ~/.codex/config.toml.
Když to nefunguje
- „Vocatim není na tomto Macu otevřený nebo je přístup aplikací AI vypnutý v Nastavení Vocatimu.“: otevřete Vocatim a zkontrolujte přepínač. Po „Resetovat klíč“ aplikaci AI znovu nastavte, potom ji úplně ukončete (zavřít její okno nestačí) a znovu ji otevřete.
- Vocatim zobrazí „Konfigurace se změnila: nastavte aplikace AI znovu.“: znovu nastavte každou aplikaci AI jako výše, místo staré položky nebo sekce, a restartujte ji.
- Vocatim zobrazí „Aplikace se neotevřela. Je na tomto Macu nainstalovaná?“: nainstalujte tuto aplikaci na tento Mac. U Cursoru a aplikace LM Studio můžete také použít Zkopírovat konfiguraci pro jiné aplikace.
- ChatGPT nebo Codex přestane fungovat nebo hlásí chybu v
config.tomlpoté, co jste konfiguraci vložili podruhé: soubor obsahuje dvě sekce[mcp_servers.vocatim]. Ponechte jen tu nejnovější. - Codex hlásí, že žádný nástroj Vocatim nemá: začněte novou konverzaci v projektu, jehož složka je na tomto Macu (projekt synchronizovaný z jiného počítače tu složku mít nemusí).
- Aplikaci AI jste otevřeli dřív než Vocatim: restartujte aplikaci AI při otevřeném Vocatimu.
- Chybí nahrávka: nahrávky v koši a ukázkové nahrávky se nezobrazují a nová nahrávka se objeví teprve tehdy, když její přepis skončí nebo se zastaví. Nahrávka, která není úplně přepsaná, je v seznamu, ale její přepis a shrnutí nejsou dostupné, dokud nebude přepsaná celá.
Časté dotazy
Posílá Vocatim mé nahrávky společnosti, která stojí za aplikací AI?
Přístup aplikací AI k vašim nahrávkám je ve výchozím stavu vypnutý. Zapínáte ho sami v Nastavení Vocatimu, jen pokud se rozhodnete sdílet své přepisy s aplikacemi AI na tomto Macu. Samotný Vocatim nic neposílá. Aplikace AI čte z Vocatimu na vašem Macu, a pokud používá online model, posílá přečtený obsah svému poskytovateli pod vaším účtem.