KI-Agent verbinden

Version: Diese Anleitung beschreibt die stabile Version Parrot Scribe 1.0.8. Die öffentliche Beta von 1.1.0 hat andere Bedienelemente und einige noch nicht fertige Funktionen. Lesen Sie Beta installieren und Unterschiede beachten, bevor Sie diese Schritte auf die Beta übertragen.

Erfordert Parrot Scribe Pro. Der MCP-Server gehört zu Parrot Scribe Pro. Bestehende Lizenzen enthalten Pro bereits.

Verbinden Sie ChatGPT, Claude oder Cursor aus Parrot Scribe heraus. Diese Schritte setzen Parrot Scribe 1.0.2 oder neuer voraus. Das Beibehalten der Verbindung nach einem Neustart der KI-App benötigt Parrot Scribe 1.0.5. Parrot Scribe 1.0.1 verwendet Einstellungen > MCP und einen Client-Token. Aktualisieren Sie die App, bevor Sie die folgenden Desktop-Schritte ausführen.

Der Parrot-Scribe-Katalog, auf Englisch ist für Claude Code und die Codex CLI bestimmt. Er installiert nicht die drei Desktop-Zeilen. Parrot Scribe erstellt diese Verbindungen auf diesem Mac.

Gemeinsame Einrichtung

1. Installieren Sie Parrot Scribe unter /Applications/Parrot Scribe.app und lassen Sie es laufen.
2. Öffnen Sie die gewünschte Desktop-KI-App und lassen Sie sie laufen.
3. Öffnen Sie in Parrot Scribe Einstellungen > KI-Apps.
4. Aktivieren Sie KI-Apps erlauben. Dafür ist Pro erforderlich.
5. Wählen Sie Verbinden in der entsprechenden App-Zeile. Eine bereits eingerichtete Zeile zeigt zuerst Verwalten.... Öffnen Sie es und wählen Sie anschließend Verbinden.

"Verbinden" gibt dieser Desktop-App auf diesem Mac Zugriff. Die Verbindung bleibt während der Nutzung bestehen, auch wenn Sie ChatGPT, Claude oder Cursor beenden und erneut öffnen. Beim Wiederverbinden zeigt die Zeile während der Arbeit Verbunden und zwischen Anfragen Eingerichtet · Inaktiv, ohne dass Verwalten... > Verbinden nötig ist. Wählen Sie Verbinden erst nach Trennen oder nach 90 Tagen ohne Nutzung erneut. Beim ersten Verbinden muss die Desktop-App laufen. In Parrot Scribe 1.0.4 und früher endet die Freigabe beim Beenden der KI-App.

Jede Zeile hat ihren eigenen Status:

Die App speichert den Zugangswert der Verbindung und startet ihren signierten Helfer mit einer Profil-ID. Kopieren Sie keinen Token in die Desktop-App, ein Shell-Profil oder eine Chatnachricht. Eine Cloud- oder mobile Sitzung erhält durch die Installation eines Plugins keinen Zugriff auf diesen Mac.

ChatGPT Desktop

Wählen Sie Verbinden in der ChatGPT-Zeile. Parrot Scribe öffnet ein lokales Plugin mit Verbindung und Zuhör-Skill. Schließen Sie die Installation in ChatGPT ab, starten Sie eine neue lokale Aufgabe und wählen Sie listening.

Eine Web-, mobile oder Cloud-Aufgabe erhält keinen Zugriff auf diesen Mac. Verwenden Sie eine lokale Aufgabe.

Version 1.0.6 korrigiert den früheren veralteten Status Eingerichtet · Nicht verbunden nach einem Neustart von Parrot Scribe. Wenn Sie von 1.0.5 oder älter aktualisieren, beenden und öffnen Sie die verbundene KI-App einmal, damit sie den aktualisierten Helfer lädt.

Claude Desktop

Wählen Sie Verbinden in der Claude-Zeile. Parrot Scribe installiert eine lokale Claude-Erweiterung für die Verbindung. Claude kann eine rote Warnung vor einer ungeprüften Erweiterung anzeigen. Diese Warnung stammt von Claude. Die Installation der Erweiterung entfernt sie nicht.

Wählen Sie nach der Installation Zuhör-Skill hinzufügen... in der Claude-Zeile. Diese Schaltfläche öffnet Claude, damit Sie den Skill prüfen und hinzufügen können. Wenn Sie die Skill-Datei selbst öffnen, kann sie auf diesem Mac stattdessen an ChatGPT übergeben werden.

Erweiterung und Zuhör-Skill bleiben getrennt. Ersetzen Sie die Erweiterung nicht durch ein kombiniertes Claude-Plugin. Dadurch kann die Chat-Verbindung von Claude verloren gehen.

Wenn Sie erst Trennen und anschließend wieder Verbinden wählen, ist die frühere Erweiterung möglicherweise noch in Claude installiert. Bietet Claude Uninstall anstelle einer Installation an, wählen Sie Uninstall und anschließend Install.

Cowork ist ein getrennter Host. Diese Desktop-Schritte richten Cowork nicht ein.

Cursor

Wählen Sie Verbinden in der Cursor-Zeile. Parrot Scribe installiert ein lokales Plugin unter ~/.cursor/plugins/local/parrot und öffnet die Verbindungsübergabe in Cursor. Die älteren Cursor-Befehle werden nicht hinzugefügt.

Schließen Sie die Übergabe in Cursor ab, starten Sie einen neuen Chat und bitten Sie ihn, den Zuhör-Skill zu verwenden. Das Verbinden allein lädt diesen Skill nicht in einen bereits bestehenden Chat.

Verbindung prüfen

1. Prüfen Sie, ob die Zeile nach dem Wiederverbinden der Desktop-App Verbunden oder Eingerichtet · Inaktiv anzeigt.
2. Bitten Sie sie, get_status aufzurufen, ohne eine Aufnahme zu starten.
3. Bitten Sie um list_sessions mit limit: 2. Ein leeres Array sessions ist bei einer leeren Bibliothek gültig. Prüfen Sie unavailableSessionCount, bevor Sie das Ergebnis als vollständig behandeln.
4. Wählen Sie eine Sitzung, die Sie teilen möchten, bevor Sie um eine Zusammenfassung bitten. Siehe Zuhören und Zusammenfassen.

Wenn die Einrichtung meldet, dass sie die Verbindung nicht vorbereiten konnte, prüfen Sie zuerst, ob die gewählte Desktop-KI-App bereits läuft, und wählen Sie Verbinden erneut. Bleibt die Zeile trotz geöffneter App auf Eingerichtet · Nicht verbunden, kann die Freigabe nach 90 Tagen ohne Nutzung abgelaufen sein. Wählen Sie Verwalten... > Verbinden. Fordert "Verbinden" Sie wiederholt auf, eine bereits geöffnete App zu starten, wählen Sie in dieser Zeile Trennen und danach Verbinden. Fehlen Werkzeuge, schließen Sie die Übergabe in der App ab und starten Sie eine neue Aufgabe oder einen neuen Chat. Parrot Scribe muss mit Pro und aktiviertem KI-Apps erlauben weiterlaufen.

Andere lokale Hosts

Claude Code, die Codex CLI und andere lokale stdio-Hosts sind keine Zeilen in "KI-Apps". Verwenden Sie einen eigenen Token je Host aus Einstellungen > KI-Apps > Erweitert. Kopieren Sie ihn bei der Anzeige. Er wird nur einmal angezeigt.

Der Helfer liest PARROTSCRIBE_MCP_TOKEN aus seiner Umgebung. Parrot Scribe verweigert --token und --token=.... Tokens gehören nicht in Befehlsargumente, Projektdateien, Shell-Profile oder Chatnachrichten.

Der signierte Helfer liegt hier:

/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim

Hat ein Host bereits eine Parrot-Scribe-Verbindung, behalten Sie eine aktivierte Verbindung. Lassen Sie nicht zwei Werkzeugsätze gleichzeitig aktiv.

Claude Code

Installieren Sie Katalog und Plugin:

/plugin marketplace add 3jct-com/parrotscribe-plugins
/plugin install parrot@parrotscribe-plugins

Plugin 0.4.0 enthält die Verbindung für Claude Code. Geben Sie den Token dieses Clients in die Plugin-Abfrage Parrot Scribe client token ein. Erstellen Sie diesen Token unter Erweitert. Claude Code speichert ihn in seinem Zugangsspeicher und übergibt ihn dem Helfer. Verwenden Sie eine aktuelle Claude-Code-Version mit Unterstützung für userConfig.

Fügen Sie nach der Plugin-Installation keine zweite manuelle Verbindung hinzu. Starten Sie eine neue Sitzung und verwenden Sie /parrot:listen oder /parrot:recap.

Codex CLI

Fügen Sie den Katalog hinzu, installieren Sie das Plugin und starten Sie eine neue Sitzung:

codex plugin marketplace add 3jct-com/parrotscribe-plugins

Stellen Sie in der Umgebung des Codex-Hosts einen eigenen Token bereit. Das Plugin leitet PARROTSCRIBE_MCP_TOKEN weiter. Das ist nicht die oben beschriebene ChatGPT-Zeile. Eine manuelle Verbindung verwendet:

[mcp_servers.parrotscribe]
command = "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim"
env_vars = ["PARROTSCRIBE_MCP_TOKEN"]

Behalten Sie eine aktivierte Verbindung. Verwenden Sie diesen Token nicht für einen weiteren Host.

Hosts mit erforderlicher Umgebungszuordnung

Verwenden Sie denselben Helfer und einen eigenen Token. Übernimmt der Host PARROTSCRIBE_MCP_TOKEN nicht in die Helferumgebung, verwenden Sie das unten beschriebene Schlüsselbund-Startskript.

Grok Build in ~/.grok/config.toml:

[mcp_servers.parrotscribe]
command = "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim"
env = { PARROTSCRIBE_MCP_TOKEN = "${PARROTSCRIBE_MCP_TOKEN}" }

Gemini CLI in ~/.gemini/settings.json:

{
  "mcpServers": {
    "parrotscribe": {
      "command": "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim",
      "env": {
        "PARROTSCRIBE_MCP_TOKEN": "$PARROTSCRIBE_MCP_TOKEN"
      }
    }
  }
}

OpenCode unter mcp in ~/.config/opencode/opencode.json:

{
  "mcp": {
    "parrotscribe": {
      "type": "local",
      "command": [
        "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim"
      ],
      "environment": {
        "PARROTSCRIBE_MCP_TOKEN": "{env:PARROTSCRIBE_MCP_TOKEN}"
      }
    }
  }
}

Diese Hosts erhalten MCP-Werkzeuge. Sie erhalten weder den Desktop-Zuhör-Skill noch /parrot:listen, sofern Sie nicht zusätzlich den englischen Zuhörvertrag als Anweisungen laden.

Schlüsselbund-Startskript für andere Hosts

Verwenden Sie dies, wenn ein Host den Token nicht in die Helferumgebung einsetzen kann. Erstellen Sie für diesen Host ein allgemeines Passwort in der Schlüsselbundverwaltung und speichern Sie den Token als Passwort. Verwenden Sie keinen Token eines anderen Hosts erneut.

Speichern Sie dieses Skript unter einem absoluten Pfad wie /Users/you/.local/bin/parrotscribe-mcp-keychain. Ersetzen Sie /Users/you durch den Pfad Ihres Benutzerkontos. Das Skript enthält keinen Token:

#!/bin/zsh
set -eu
: "${PARROTSCRIBE_MCP_KEYCHAIN_ITEM:?Set PARROTSCRIBE_MCP_KEYCHAIN_ITEM}"
PARROTSCRIBE_MCP_TOKEN=$(/usr/bin/security find-generic-password -w -s "$PARROTSCRIBE_MCP_KEYCHAIN_ITEM")
export PARROTSCRIBE_MCP_TOKEN
exec "/Applications/Parrot Scribe.app/Contents/MacOS/parrotscribe-mcp-shim" "$@"

Führen Sie chmod 700 /Users/you/.local/bin/parrotscribe-mcp-keychain aus. Richten Sie den Host-Befehl auf dieses Skript und übergeben Sie nur den Namen des Schlüsselbundeintrags:

{
  "command": "/Users/you/.local/bin/parrotscribe-mcp-keychain",
  "env": {
    "PARROTSCRIBE_MCP_KEYCHAIN_ITEM": "Parrot Scribe MCP Host Name"
  }
}

Verwenden Sie dieses Startskript nicht für die ChatGPT-, Claude- oder Cursor-Zeilen. Diese verwalten ihre Zugangsdaten selbst.

Pflege

• Zum Trennen von ChatGPT, Claude oder Cursor wählen Sie Trennen in der jeweiligen Zeile. Andere Apps bleiben eingerichtet.
• Zum Wechseln eines Tokens für einen anderen Host widerrufen Sie ihn unter Erweitert, erstellen einen Ersatz, aktualisieren die Geheimnisquelle und starten den Host neu.
• Entfernen Sie bei einer alten --token-Einrichtung den Token aus Befehl oder Konfiguration. Verwenden Sie Erweitert oder das Schlüsselbund-Startskript und starten Sie den Host neu. Widerrufen Sie einen Token, der in einem Befehl, Protokoll oder einer kopierten Datei offengelegt wurde.
• Starten Sie den Host nach einer Token- oder Konfigurationsänderung neu.

Werkzeugargumente und Zugriffskontrollen stehen unter MCP-Server. Den Ablauf erklärt Zuhören und Zusammenfassen.

Beta von 1.1.0

Die Beta listet unter Einstellungen > KI-Apps die Apps Codex, Claude und Cursor. Öffnen Sie die KI-App zuerst, wählen Sie in ihrer Zeile Verbinden und schließen Sie die Übergabe dort ab. Über Verwalten... in der Zeile können Sie die App erneut verbinden, ihren Zugriff ändern oder sie trennen. Jede Zeile hat eigene neue Zugangsdaten. Bestehende Freigaben aus 1.0.x erlauben keinen Zugriff auf die Beta.

Wählen Sie Simple für Lesen, Aufnahmesteuerung und Änderungen von Sprechernamen. "Simple" darf keine Sitzungen löschen und keine Sprecher entfernen oder vergessen. Trusted erlaubt zusätzlich diese destruktiven Werkzeuge ohne weitere Rückfrage. Das Erteilen erfordert eine Bestätigung. Die eigenen Berechtigungsabfragen des KI-Hosts gelten weiterhin. Das Trennen der Zeile oder der Widerruf eines manuellen Tokens entfernt den Zugriff dieses Clients.

Öffnen Sie für einen Kommandozeilen-Host Advanced, geben Sie einen Clientnamen ein und wählen Sie Create Token. Verwenden Sie die erzeugte Konfiguration mit einem eigenen Token für diesen Host. Der Token wird nur einmal angezeigt und gehört in PARROTSCRIBE_MCP_TOKEN, nicht in Befehlsargumente. Behalten Sie eine aktivierte Verbindung je Host. Bestehende Katalogkonfigurationen mit dem Kompatibilitätspfad parrotscribe-mcp-shim können einen neuen Beta-Token verwenden. Das signierte Paket stellt außerdem parrotscribe-mcp bereit.

Cursor benötigt nach einem Neustart von Parrot Scribe derzeit Reload in seinen MCP-Einstellungen. Eine eingerichtete Zeile allein beweist keine erneute Verbindung des KI-Hosts. Bitten Sie ihn, get_status aufzurufen und einen beabsichtigten Lesezugriff auszuführen. Das Prüfen von Wiederverbindung und Widerruf mit jedem echten Host bleibt von der Installation seiner Konfiguration getrennt.

Der verwaltete Desktop-Helfer der Beta verwendet einen privaten Unix-Socket. Er prüft Benutzer und Codesignatur der verbundenen App, bevor er den verwalteten Schlüsselbund-Zugangswert liest. Manuelle Verbindungen mit Umgebungstoken verwenden einen getrennten Transport über 127.0.0.1, der vor dem Senden des Tokens einen Nachweis mit einem privaten Endpunktgeheimnis verlangt. Aufnahme und Speicherung bleiben lokal. Ein cloudbasierter KI-Host kann abgerufene Transkriptinhalte jedoch an seinen Anbieter senden. Siehe Speichergrenzen der Beta.