Deine Vocatim-Aufnahmen in KI-Apps auf deinem Mac nutzen

Zuerst in Vocatim

Öffne auf deinem Mac Einstellungen → Daten & Geräte → KI-Apps auf diesem Mac und schalte die Funktion ein. Lies den Bildschirm, der erklärt, was die KI-App sehen kann, und klicke dann auf Einschalten. Folge danach den Schritten für deine KI-App.

Claude Desktop

1. Klicke auf In Claude Desktop installieren und speichere Vocatim.mcpb an einem beliebigen Ort, zum Beispiel im Ordner „Downloads“. Sobald die Datei gespeichert ist, kopiert Vocatim den Vocatim-Schlüssel.
2. Öffne Vocatim.mcpb. Claude Desktop zeigt die Vocatim-Erweiterung an und fragt, ob sie installiert werden soll.
3. Wenn Claude Desktop nach dem Vocatim-Schlüssel fragt, füge ihn ein. Lass das Feld Programm vocatim-mcp unverändert.
4. Frag in einem neuen Chat zum Beispiel: „Was haben wir in meiner letzten Aufnahme in Vocatim beschlossen?“ Claude bittet dich möglicherweise, das Vocatim-Tool zu erlauben.

Möchtest du die Konfiguration lieber selbst bearbeiten? Klicke auf Konfiguration für Claude Desktop kopieren. Öffne in Claude Desktop das Menü Claude in der macOS-Menüleiste (nicht die Einstellungen im Claude-Fenster) und wähle Settings… → Developer → Edit Config. Enthält die Datei noch kein "mcpServers", ersetze ihren Inhalt durch das vollständige Beispiel unten. Sind darin schon Server eingetragen, füge nur den Eintrag "vocatim" innerhalb von "mcpServers" ein, mit einem Komma zwischen ihm und dem Eintrag davor. Speichere die Datei, beende Claude Desktop vollständig und öffne es wieder.

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

ChatGPT und Codex

1. Klicke auf Konfiguration für ChatGPT und Codex kopieren.
2. Öffne die Datei ~/.codex/config.toml in einem Texteditor oder erstelle sie, falls es sie noch nicht gibt. ~/.codex ist ein versteckter Ordner in deinem Benutzerordner: Wähle im Finder Gehe zu → Gehe zum Ordner … und gib ~/.codex ein.
3. Hat die Datei keinen Abschnitt [mcp_servers.vocatim], füge die Konfiguration in einer neuen Zeile am Ende ein. Hat sie schon einen, aus einer früheren Konfiguration, ersetze diesen ganzen Abschnitt durch den neuen. Der Abschnitt darf nicht zweimal in der Datei stehen.
4. Speichere die Datei und starte ChatGPT oder Codex neu.
5. Frag in einem neuen Chat zum Beispiel: „Was haben wir in meiner letzten Aufnahme in Vocatim beschlossen?“ In ChatGPT nutzt du Vocatim in einer Codex-Unterhaltung, nicht in einem normalen Chat.

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

codex mcp list zeigt den Vocatim-Schlüssel in der Spalte Args. Mit dem Schlüssel können nur Apps auf diesem Mac Vocatim lesen, und nur, solange Vocatim geöffnet ist. Gib diese Ausgabe nicht weiter; falls doch, nutze „Schlüssel zurücksetzen“ in Vocatim.

VS Code, Cursor und LM Studio

1. Klicke auf In VS Code installieren, Zu Cursor hinzufügen oder Zu LM Studio hinzufügen. Vocatim öffnet diese App mit der Vocatim-Konfiguration.
2. Bestätige in der App, dass du Vocatim hinzufügen möchtest.
3. Für VS Code kopiert Vocatim den Vocatim-Schlüssel: Wenn VS Code nach dem Vocatim-Schlüssel fragt, füge ihn ein. Cursor und LM Studio erhalten den Schlüssel mit der Konfiguration und speichern ihn in ihren eigenen Einstellungen.
4. Frag im KI-Chat der App zum Beispiel: „Was haben wir in meiner letzten Aufnahme in Vocatim beschlossen?“

Andere Apps: Cursor, LM Studio, JetBrains AI Assistant und Junie

1. Klicke auf Konfiguration für andere Apps kopieren.
2. Öffne die MCP-Einstellungen der App: in Cursor die Datei ~/.cursor/mcp.json, in LM Studio die eigene mcp.json, in JetBrains AI Assistant Settings → Tools → AI Assistant → MCP und Add, in Junie die Datei ~/.junie/mcp/mcp.json.
3. Steht dort noch kein "mcpServers", füge die ganze Konfiguration ein. Sind schon Server eingetragen, füge nur den Eintrag "vocatim" innerhalb von "mcpServers" hinzu oder ersetze damit den alten Eintrag "vocatim". Der Eintrag darf dort nicht zweimal stehen.
4. Speichere und starte die App dann neu.

Zed

1. Klicke auf Konfiguration für Zed kopieren.
2. Führe in Zed zed: open settings file aus.
3. Setze den Teil "context_servers" in die äußeren geschweiften Klammern dieser Datei. Steht "context_servers" schon dort, füge darin nur den Eintrag "vocatim" hinzu oder ersetze damit den alten Eintrag "vocatim". Der Eintrag darf dort nicht zweimal stehen.
4. Speichere die Datei und starte Zed dann neu.

Vocatim im Terminal (Befehlszeile)

Du kannst deine Aufnahmen auch im Terminal auf diesem Mac lesen, mit denselben vier Nur-Lese-Werkzeugen, die KI-Apps bekommen: Liste, Suche, Transkript und Zusammenfassung. Die Befehlszeile verwendet denselben Schalter und denselben Vocatim-Schlüssel wie deine KI-Apps und funktioniert nur, solange Vocatim geöffnet und der Schalter eingeschaltet ist.

1. Kopiere diesen Befehl und füge ihn in ein Terminal-Fenster ein, aber drücke noch nicht die Return-Taste:

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

2. Klicke in Vocatim auf CLI-Befehl kopieren. Vocatim kopiert eine Zeile: einen Alias namens vocatim für zsh, die Standard-Shell unter macOS.
3. Geh zurück ins Terminal und drücke die Return-Taste. Der Befehl hängt die kopierte Zeile ans Ende von ~/.zshrc an, der Datei, die zsh bei jedem neuen Terminal-Fenster liest. Er fügt nur eine Zeile hinzu, die mit alias vocatim= beginnt, sodass nichts anderes aus der Zwischenablage in die Datei gelangt.
4. Öffne ein neues Terminal-Fenster und gib vocatim list ein. Der Alias funktioniert in den Fenstern, die du nach Schritt 3 öffnest.

Die vier Befehle:

• vocatim list zeigt deine 20 neuesten Aufnahmen, eine pro Zeile: ID, Datum und Uhrzeit, Länge und Titel. vocatim list --limit 50 zeigt bis zu 50.
• vocatim search Budget findet Aufnahmen, deren Titel, Transkript, Zusammenfassung, Notizen oder eine Übersetzung „Budget“ enthalten. Setze Suchbegriffe mit Leerzeichen in Anführungszeichen: vocatim search "wöchentlicher Rückblick". Angezeigt werden bis zu 10 Treffer, mit --limit 20 bis zu 20.
• vocatim transcript <id> gibt das ganze Transkript einer Aufnahme aus. Die ID steht in der ersten Spalte von vocatim list und vocatim search.
• vocatim summary <id> gibt ihre Zusammenfassung aus.

Hänge --json an einen beliebigen Befehl an, um JSON für deine eigenen Skripte zu bekommen. vocatim help listet die Befehle auf.

Dein Schlüssel. Die vocatim-Zeile in ~/.zshrc enthält deinen Vocatim-Schlüssel. Wenn du diese Zeile direkt ins Terminal einfügst, bleibt der Schlüssel auch im Verlauf des Terminals. Mit dem Schlüssel können nur Apps auf diesem Mac Vocatim lesen, und nur, solange Vocatim geöffnet ist. Gib die Zeile und die Datei nicht weiter; falls doch, nutze „Schlüssel zurücksetzen“ in Vocatim.

Nach „Schlüssel zurücksetzen“ oder wenn Vocatim „Die Konfiguration hat sich geändert: Richte deine KI-Apps erneut ein.“ meldet, funktioniert die alte Zeile nicht mehr. Wiederhole die Schritte 1 bis 4. Es zählt die neueste vocatim-Zeile in ~/.zshrc; die älteren kannst du löschen.

Nach einem Befehl zeigt KI-Apps auf diesem Mac in den Einstellungen von Vocatim vocatim-cli an, so wie dort auch der Name einer KI-App steht.

Die Befehlszeile verbindet sich nur mit Vocatim auf diesem Mac und gibt alles in deinem Terminal-Fenster aus. Wenn du ihre Ausgabe weitergibst, zum Beispiel an einen KI-Onlinedienst, landet sie dort.

Zum Entfernen lösche jede vocatim-Zeile aus ~/.zshrc; nachdem du die Schritte 1 bis 4 wiederholt hast, können es mehrere sein. Die Befehlszeile funktioniert auch nicht mehr, wenn du den Schalter in Vocatim ausschaltest oder „Schlüssel zurücksetzen“ nutzt.

Wenn es nicht funktioniert: Meldungen der Befehlszeile von Vocatim beginnen mit vocatim-mcp:.

• vocatim-mcp: Vocatim is not open on this Mac, or AI app access is turned off in Vocatim Settings. (Vocatim ist auf diesem Mac nicht geöffnet, oder der Zugriff von KI-Apps ist in den Einstellungen von Vocatim ausgeschaltet): Öffne Vocatim und prüfe den Schalter. Wiederhole nach „Schlüssel zurücksetzen“ oder „Die Konfiguration hat sich geändert“ die Schritte 1 bis 4. Die Zeile darüber, falls vorhanden, nennt den technischen Grund, zum Beispiel vocatim-mcp: connect: Connection refused.
• zsh: command not found: vocatim: Öffne ein neues Terminal-Fenster. Erscheint die Meldung weiterhin, prüfe, ob ~/.zshrc eine Zeile enthält, die mit alias vocatim= beginnt; falls nicht, wiederhole die Schritte 1 bis 4. Prüfe auch, ob echo $SHELL /bin/zsh anzeigt.
• zsh: no such file or directory mit einem Pfad zu vocatim-mcp: Die Zeile zeigt auf einen Ort, an dem Vocatim nicht mehr liegt, zum Beispiel nachdem du die App verschoben hast. Wiederhole die Schritte 1 bis 4.
• vocatim-mcp: Too many requests, try again in a moment. (zu viele Anfragen, versuche es gleich noch einmal): Warte einen Moment und führe den Befehl erneut aus.
• vocatim ohne Befehl, zum Beispiel vocatim oder vocatim --json, wartet und zeigt nichts an: Drücke Control-C und gib dann einen Befehl wie vocatim list ein.

Für Skripte: Die Daten gehen an die Standardausgabe, vollständig und nur, wenn der Befehl erfolgreich ist; Meldungen gehen an die Standardfehlerausgabe. Mit --json ist jede Antwort von Vocatim eine Zeile JSON, daher gibt transcript für jede Seite eines langen Transkripts eine Zeile aus: Lies die Ausgabe Zeile für Zeile, nicht als ein einziges JSON-Dokument. Exit-Codes: 0 fertig, 1 anderer Fehler, 2 falscher Befehl oder falsche Option, 3 Vocatim ist nicht geöffnet oder der Zugriff ist aus, 4 zu viele Anfragen.

Was deinen Mac verlässt

Der Zugriff von KI-Apps auf deine Aufnahmen ist standardmäßig aus. Du schaltest ihn selbst in den Einstellungen von Vocatim ein, nur wenn du dich entscheidest, deine Transkripte mit KI-Apps auf diesem Mac zu teilen.

Vocatim selbst sendet nichts. Wenn die KI-App ein Online-Modell nutzt, wie es Claude Desktop, ChatGPT und Codex normalerweise tun, wird das, was sie aus Vocatim liest, an dieses Unternehmen (Anthropic oder OpenAI) gesendet, unter deinem Konto dort, so als hättest du es in den Chat eingefügt.

Zugriff beenden

Deaktiviere den Schalter in Vocatim. Schlüssel zurücksetzen macht jeden Schlüssel, den du kopiert hast, und jede Konfiguration, die du eingefügt hast, unbrauchbar. Um die Verbindung wiederherzustellen, richte die KI-App erneut ein. Für die Erweiterung in Claude Desktop klickst du in Vocatim erneut auf In Claude Desktop installieren, speicherst die Datei und öffnest sie: Vocatim kopiert den neuen Schlüssel, sobald die Datei gespeichert ist. Füge ihn ein, wenn Claude Desktop danach fragt, oder trage ihn in das Feld Vocatim-Schlüssel der Vocatim-Erweiterung in Claude Desktop ein. Für Cursor und LM Studio klickst du erneut auf Zu Cursor hinzufügen oder Zu LM Studio hinzufügen. Bei einer eingefügten Konfiguration kopierst du die Konfiguration erneut und fügst sie anstelle des alten Eintrags oder Abschnitts ein. Beende die KI-App dann vollständig (das Fenster zu schließen reicht nicht) und öffne sie wieder: Bis dahin verwendet sie weiter den alten Schlüssel. Du kannst Vocatim auch aus der KI-App entfernen: die Vocatim-Erweiterung in Claude Desktop; den Eintrag "vocatim" in der Konfiguration von Claude Desktop, in den MCP-Einstellungen einer anderen App oder in der Einstellungsdatei von Zed; oder den Abschnitt [mcp_servers.vocatim] in ~/.codex/config.toml.

Wenn es nicht funktioniert

• „Vocatim ist auf diesem Mac nicht geöffnet, oder der Zugriff von KI-Apps ist in den Einstellungen von Vocatim ausgeschaltet.“: Öffne Vocatim und prüfe den Schalter. Richte die KI-App nach „Schlüssel zurücksetzen“ erneut ein, beende sie dann vollständig (das Fenster zu schließen reicht nicht) und öffne sie wieder.
• Vocatim meldet „Die Konfiguration hat sich geändert: Richte deine KI-Apps erneut ein.“: Richte jede KI-App wie oben beschrieben erneut ein, anstelle des alten Eintrags oder Abschnitts, und starte sie neu.
• Vocatim meldet „Die App wurde nicht geöffnet. Ist sie auf diesem Mac installiert?“: Installiere diese App auf diesem Mac. Für Cursor und LM Studio kannst du auch Konfiguration für andere Apps kopieren verwenden.
• ChatGPT oder Codex funktioniert nicht mehr oder meldet einen Fehler in config.toml, nachdem du die Konfiguration ein zweites Mal eingefügt hast: Die Datei enthält zwei Abschnitte [mcp_servers.vocatim]. Behalte nur den neuesten.
• Codex meldet, dass es kein Vocatim-Tool gibt: Beginne eine neue Unterhaltung in einem Projekt, dessen Ordner auf diesem Mac liegt (ein Projekt, das von einem anderen Computer synchronisiert wurde, hat hier eventuell keinen Ordner).
• Du hast die KI-App vor Vocatim geöffnet: Starte die KI-App neu, während Vocatim geöffnet ist.
• Eine Aufnahme fehlt: Aufnahmen im Papierkorb und Beispielaufnahmen werden nicht angezeigt, und eine neue Aufnahme erscheint erst, wenn ihre Transkription fertig ist oder gestoppt wurde. Eine Aufnahme, die nicht vollständig transkribiert ist, wird aufgelistet, aber ihr Transkript und ihre Zusammenfassung sind erst verfügbar, wenn sie vollständig transkribiert ist.