Gebruik je Vocatim-opnamen in AI-apps op je Mac

Eerst in Vocatim

Open op je Mac Instellingen → Gegevens en apparaten → AI-apps op deze Mac en zet het aan. Lees het scherm dat uitlegt wat de AI-app kan zien en klik daarna op Aanzetten. Volg dan de stappen voor je AI-app.

Claude Desktop

1. Klik op Installeren in Claude Desktop en sla Vocatim.mcpb op waar je maar wilt, bijvoorbeeld in Downloads. Zodra het bestand is opgeslagen, kopieert Vocatim de Vocatim-sleutel.
2. Open Vocatim.mcpb. Claude Desktop toont de Vocatim-extensie en vraagt of je die wilt installeren.
3. Plak de sleutel als Claude Desktop om de Vocatim-sleutel vraagt. Laat het veld Programma vocatim-mcp zoals het is.
4. Vraag in een nieuwe chat bijvoorbeeld: “Wat hebben we in mijn laatste opname in Vocatim besloten?” Claude vraagt je misschien om de Vocatim-tool toe te staan.

Bewerk je de configuratie liever zelf? Klik op Configuratie voor Claude Desktop kopiëren. Open in Claude Desktop het menu Claude in de menubalk van macOS (niet de instellingen in het venster van Claude) en kies Settings… → Developer → Edit Config. Staat er in het bestand nog geen "mcpServers", vervang de inhoud dan door het volledige voorbeeld hieronder. Staan er al servers in, plak dan alleen het item "vocatim" binnen "mcpServers", met een komma tussen dit item en het item ervoor. Sla het bestand op, sluit Claude Desktop helemaal af en open het opnieuw.

{
  "mcpServers": {
    "vocatim": { … paste from Vocatim … }
  }
}

ChatGPT en Codex

1. Klik op Configuratie voor ChatGPT en Codex kopiëren.
2. Open het bestand ~/.codex/config.toml in een teksteditor, of maak het aan als het er nog niet is. ~/.codex is een verborgen map in je thuismap: kies in de Finder Ga → Ga naar map… en typ ~/.codex.
3. Heeft het bestand geen sectie [mcp_servers.vocatim], plak de configuratie dan op een nieuwe regel aan het einde. Heeft het er al een, van een eerdere configuratie, vervang dan die hele sectie door de nieuwe. De sectie mag niet twee keer in het bestand staan.
4. Sla het bestand op en start ChatGPT of Codex opnieuw.
5. Vraag in een nieuwe chat bijvoorbeeld: “Wat hebben we in mijn laatste opname in Vocatim besloten?” Gebruik Vocatim in ChatGPT in een Codex-gesprek, niet in een gewone chat.

[mcp_servers.vocatim]
command = "/Applications/Vocatim.app/Contents/MacOS/vocatim-mcp"
args = ["--port", "…", "--token", "…"]

codex mcp list toont de Vocatim-sleutel in de kolom Args. Met de sleutel kunnen alleen apps op deze Mac Vocatim lezen, en alleen zolang Vocatim open is. Deel die uitvoer niet; heb je dat toch gedaan, gebruik dan “Sleutel opnieuw instellen” in Vocatim.

VS Code, Cursor en LM Studio

1. Klik op Installeren in VS Code, Toevoegen aan Cursor of Toevoegen aan LM Studio. Vocatim opent die app met de Vocatim-configuratie.
2. Bevestig in de app dat je Vocatim wilt toevoegen.
3. Bij VS Code kopieert Vocatim de Vocatim-sleutel: plak de sleutel als VS Code om de Vocatim-sleutel vraagt. Cursor en LM Studio krijgen de sleutel met de configuratie mee en bewaren hem in hun eigen instellingen.
4. Vraag in de AI-chat van de app bijvoorbeeld: “Wat hebben we in mijn laatste opname in Vocatim besloten?”

Andere apps: Cursor, LM Studio, JetBrains AI Assistant en Junie

1. Klik op Configuratie voor andere apps kopiëren.
2. Open de MCP-instellingen van de app: in Cursor het bestand ~/.cursor/mcp.json, in LM Studio zijn eigen mcp.json, in JetBrains AI Assistant Settings → Tools → AI Assistant → MCP en Add, in Junie het bestand ~/.junie/mcp/mcp.json.
3. Staat er nog geen "mcpServers", plak dan de hele configuratie. Staan er al servers, voeg dan alleen het item "vocatim" toe binnen "mcpServers", of vervang het oude item "vocatim" erdoor. Het item mag er niet twee keer in staan.
4. Sla op en start de app daarna opnieuw.

Zed

1. Klik op Configuratie voor Zed kopiëren.
2. Voer in Zed zed: open settings file uit.
3. Zet het deel "context_servers" binnen de buitenste accolades van dat bestand. Staat "context_servers" er al, voeg daarbinnen dan alleen het item "vocatim" toe, of vervang het oude item "vocatim" erdoor. Het item mag er niet twee keer in staan.
4. Sla het bestand op en start Zed daarna opnieuw.

Vocatim in Terminal (opdrachtregel)

Je kunt je opnamen ook in Terminal op deze Mac lezen, met dezelfde vier alleen-lezen-tools die AI-apps krijgen: lijst, zoeken, transcriptie en samenvatting. De opdrachtregel gebruikt dezelfde schakelaar en dezelfde Vocatim-sleutel als je AI-apps, en werkt alleen zolang Vocatim open is en de schakelaar aan staat.

1. Kopieer deze opdracht en plak hem in een Terminal-venster, maar druk nog niet op Return:

   printf '\n%s\n' "$(pbpaste | grep -m 1 '^alias vocatim=')" >> ~/.zshrc

2. Klik in Vocatim op CLI-opdracht kopiëren. Vocatim kopieert één regel: een alias met de naam vocatim voor zsh, de standaardshell van macOS.
3. Ga terug naar Terminal en druk op Return. De opdracht zet de gekopieerde regel aan het einde van ~/.zshrc, het bestand dat zsh leest telkens als je een Terminal-venster opent. Hij voegt alleen een regel toe die begint met alias vocatim=, dus verder komt er niets van het klembord in het bestand.
4. Open een nieuw Terminal-venster en typ vocatim list. De alias werkt in de vensters die je na stap 3 opent.

De vier opdrachten:

• vocatim list toont je 20 nieuwste opnamen, één per regel: id, datum en tijd, lengte en titel. vocatim list --limit 50 toont er tot 50.
• vocatim search budget vindt opnamen waarvan de titel, transcriptie, samenvatting, notities of een vertaling “budget” bevat. Zet een zoekopdracht met spaties tussen aanhalingstekens: vocatim search "wekelijkse evaluatie". Je ziet tot 10 resultaten, of tot 20 met --limit 20.
• vocatim transcript <id> geeft de volledige transcriptie van één opname weer. De id staat in de eerste kolom van vocatim list en vocatim search.
• vocatim summary <id> geeft de samenvatting ervan weer.

Voeg --json aan elke opdracht toe om JSON voor je eigen scripts te krijgen. vocatim help toont de opdrachten.

Je sleutel. De vocatim-regel in ~/.zshrc bevat je Vocatim-sleutel. Plak je die regel in Terminal zelf, dan blijft de sleutel ook in de geschiedenis van Terminal staan. Met de sleutel kunnen alleen apps op deze Mac Vocatim lezen, en alleen zolang Vocatim open is. Deel de regel en het bestand niet; heb je dat toch gedaan, gebruik dan “Sleutel opnieuw instellen” in Vocatim.

Na “Sleutel opnieuw instellen”, of als Vocatim “De configuratie is gewijzigd: stel je AI-apps opnieuw in.” meldt, werkt de oude regel niet meer. Herhaal stap 1 tot en met 4. De nieuwste vocatim-regel in ~/.zshrc telt; de oudere kun je verwijderen.

Na een opdracht toont AI-apps op deze Mac in Instellingen van Vocatim vocatim-cli, zoals daar ook de naam van een AI-app staat.

De opdrachtregel praat alleen met Vocatim op deze Mac en toont alles in je Terminal-venster. Geef je de uitvoer door, bijvoorbeeld aan een online AI-dienst, dan komt hij daar terecht.

Om hem te verwijderen wis je elke vocatim-regel uit ~/.zshrc; als je stap 1 tot en met 4 hebt herhaald, kunnen het er meer zijn. De opdrachtregel werkt ook niet meer als je de schakelaar in Vocatim uitzet of “Sleutel opnieuw instellen” gebruikt.

Als het niet werkt: meldingen van de opdrachtregel van Vocatim beginnen met vocatim-mcp:.

• vocatim-mcp: Vocatim is not open on this Mac, or AI app access is turned off in Vocatim Settings. (Vocatim is niet open op deze Mac, of toegang van AI-apps staat uit in Instellingen van Vocatim): open Vocatim en controleer de schakelaar. Herhaal na “Sleutel opnieuw instellen” of “De configuratie is gewijzigd” stap 1 tot en met 4. De regel erboven, als die er is, geeft de technische oorzaak, bijvoorbeeld vocatim-mcp: connect: Connection refused.
• zsh: command not found: vocatim: open een nieuw Terminal-venster. Zie je de melding dan nog steeds, controleer dan of ~/.zshrc een regel heeft die begint met alias vocatim=; zo niet, herhaal dan stap 1 tot en met 4. Controleer ook of echo $SHELL /bin/zsh toont.
• zsh: no such file or directory met een pad naar vocatim-mcp: de regel wijst naar een plek waar Vocatim niet meer staat, bijvoorbeeld nadat je de app hebt verplaatst. Herhaal stap 1 tot en met 4.
• vocatim-mcp: Too many requests, try again in a moment. (te veel verzoeken, probeer het zo opnieuw): wacht even en voer de opdracht opnieuw uit.
• vocatim zonder opdracht, bijvoorbeeld vocatim of vocatim --json, wacht en toont niets: druk op Control-C en typ dan een opdracht zoals vocatim list.

Voor scripts: de gegevens gaan naar de standaarduitvoer, volledig en alleen als de opdracht lukt; meldingen gaan naar de standaardfoutuitvoer. Met --json is elk antwoord van Vocatim één regel JSON, dus transcript geeft één regel voor elke pagina van een lange transcriptie: lees de uitvoer regel voor regel, niet als één JSON-document. Exitcodes: 0 klaar, 1 een andere fout, 2 verkeerde opdracht of optie, 3 Vocatim is niet open of de toegang staat uit, 4 te veel verzoeken.

Wat je Mac verlaat

Toegang van AI-apps tot je opnamen staat standaard uit. Je zet die zelf aan in Instellingen van Vocatim, alleen als je besluit je transcripties te delen met AI-apps op deze Mac.

Vocatim verstuurt zelf niets. Als de AI-app een onlinemodel gebruikt, zoals Claude Desktop, ChatGPT en Codex doorgaans doen, wordt wat hij uit Vocatim leest naar dat bedrijf (Anthropic of OpenAI) gestuurd, onder jouw account daar, alsof je het in de chat had geplakt.

Toegang stoppen

Zet de schakelaar in Vocatim uit. Sleutel opnieuw instellen maakt elke sleutel die je hebt gekopieerd en elke configuratie die je hebt geplakt onbruikbaar. Wil je weer verbinding maken, stel de AI-app dan opnieuw in. Voor de extensie in Claude Desktop klik je in Vocatim opnieuw op Installeren in Claude Desktop, sla je het bestand op en open je het: Vocatim kopieert de nieuwe sleutel zodra het bestand is opgeslagen. Plak die als Claude Desktop erom vraagt, of in het veld Vocatim-sleutel van de Vocatim-extensie in Claude Desktop. Voor Cursor en LM Studio klik je opnieuw op Toevoegen aan Cursor of Toevoegen aan LM Studio. Heb je een configuratie geplakt, kopieer de configuratie dan opnieuw en plak die over het oude item of de oude sectie heen. Sluit de AI-app daarna helemaal af (het venster sluiten is niet genoeg) en open hem opnieuw: tot dan blijft hij de oude sleutel gebruiken. Je kunt Vocatim ook uit de AI-app verwijderen: de Vocatim-extensie in Claude Desktop, het item "vocatim" in de configuratie van Claude Desktop, in de MCP-instellingen van een andere app of in het instellingenbestand van Zed, of de sectie [mcp_servers.vocatim] in ~/.codex/config.toml.

Als het niet werkt

• “Vocatim is niet open op deze Mac, of toegang van AI-apps staat uit in Instellingen van Vocatim.”: open Vocatim en controleer de schakelaar. Stel na “Sleutel opnieuw instellen” de AI-app opnieuw in, sluit hem daarna helemaal af (het venster sluiten is niet genoeg) en open hem opnieuw.
• Vocatim meldt “De configuratie is gewijzigd: stel je AI-apps opnieuw in.”: stel elke AI-app opnieuw in zoals hierboven, over het oude item of de oude sectie heen, en start hem opnieuw.
• Vocatim meldt “De app is niet geopend. Is hij op deze Mac geïnstalleerd?”: installeer die app op deze Mac. Voor Cursor en LM Studio kun je ook Configuratie voor andere apps kopiëren gebruiken.
• ChatGPT of Codex werkt niet meer, of meldt een fout in config.toml, nadat je de configuratie een tweede keer hebt geplakt: het bestand bevat twee secties [mcp_servers.vocatim]. Laat alleen de nieuwste staan.
• Codex meldt dat er geen Vocatim-tool is: begin een nieuw gesprek in een project waarvan de map op deze Mac staat (een project dat vanaf een andere computer is gesynchroniseerd, heeft hier misschien geen map).
• Je hebt de AI-app vóór Vocatim geopend: start de AI-app opnieuw terwijl Vocatim open is.
• Er ontbreekt een opname: opnamen in de prullenmand en voorbeeldopnamen worden niet getoond, en een nieuwe opname verschijnt pas zodra de transcriptie ervan klaar is of is gestopt. Een opname die niet volledig is getranscribeerd, staat wel in de lijst, maar de transcriptie en de samenvatting ervan zijn pas beschikbaar als de opname volledig is getranscribeerd.