MCP-Server

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.

Beginnen Sie für ChatGPT, Claude und Cursor mit KI-Agent verbinden. Diese Anleitung verwendet "Einstellungen > KI-Apps". Zuhören und Zusammenfassen erläutert den Ablauf nach dem Verbinden.

Für 1.1.0-beta.1: Verwenden Sie die Beta-Einrichtung. Die Zugriffsstufen heißen Simple und Trusted. Der verwaltete Desktop-Helfer prüft die signierte App über einen privaten Unix-Socket. Manuelle Clients verwenden einen getrennten authentifizierten Loopback-Transport. Das Live-Journal fasst 1.024 bestätigte Sätze. "Simple" verweigert destruktive Werkzeuge, anstatt wie die stabile App bei jedem Aufruf nachzufragen. Die unten beschriebenen Transport-, Zugriffs- und Seitengrößen-Voreinstellungen der stabilen Version sind nicht der Vertrag der Beta.

Was ist MCP?

Das Model Context Protocol (MCP), Dokumentation auf Englisch ermöglicht KI-Assistenten den Zugriff auf externe Werkzeuge und Daten über eine strukturierte Schnittstelle. Parrot Scribe enthält den lokalen Server und den signierten Verbindungshelfer. Ihr Agent benötigt weiterhin eine Verbindung und einen Client-Token. Das Plugin ergänzt auf unterstützten Hosts Anweisungen zum Zuhören und Zusammenfassen.

So funktioniert es

Der MCP-Server läuft innerhalb von Parrot Scribe als Teil eines einzigen Prozesses. Sie müssen keinen getrennten Server verwalten.

• Integriert: Der Server gehört zu Parrot Scribe selbst. Externe Pakete oder Abhängigkeiten sind nicht erforderlich.
• Unix-Domain-Socket: Die Kommunikation verwendet einen lokalen Unix-Socket mit Zugriff nur für den Eigentümer.
• Verbindungsbrücke: Das mitgelieferte parrotscribe-mcp-shim verbindet stdio-MCP-Hosts mit dem lokalen Socket.
• Token-Authentifizierung: Clients müssen beim Verbindungsaufbau einen gültigen Token vorlegen.
• Standardmäßig aus: Der MCP-Listener ist deaktiviert, bis Sie ihn ausdrücklich einschalten. Im ausgeschalteten Zustand wird kein MCP-Socket bereitgestellt.

Protokollversionen

Version 1.0.1 unterstützt Anfragen für 2026-07-28 mit Protokollmetadaten je Anfrage und server/discover zusätzlich zum Initialisierungs-Handshake 2024-11-05 aus 1.0.0. Beide verwenden dieselbe lokale stdio-Verbindung. Die moderne Erkennung meldet 2026-07-28. Ältere Hosts können weiterhin den Initialisierungs-Handshake verwenden. Serverunterstützung bedeutet nicht, dass jeder Host das moderne Protokoll auswählt. Beide Wege behalten Client-Authentifizierung, Berechtigungen und die Voraussetzung einer laufenden Parrot-Scribe-App bei.

MCP-Server aktivieren

Öffnen Sie für ChatGPT, Claude und Cursor zuerst die gewählte Desktop-KI-App und lassen Sie sie laufen. Öffnen Sie in Parrot Scribe Einstellungen > KI-Apps, aktivieren Sie KI-Apps erlauben und wählen Sie Verbinden in der entsprechenden Zeile. Parrot Scribe 1.0.2 verwaltet diese Zugangsdaten. Erstellen Sie für diese drei Apps keinen zusätzlichen Token.

"Verbinden" erlaubt dieser Desktop-App den Zugriff auf diesem Mac. Die Verbindung bleibt während der Nutzung bestehen, auch wenn Sie ChatGPT, Claude oder Cursor beenden und erneut öffnen. Wählen Sie Verwalten... > Verbinden nach Trennen oder nach 90 Tagen ohne Nutzung erneut. Das Beibehalten der Freigabe nach einem Neustart setzt Parrot Scribe 1.0.5 voraus. In früheren Versionen endet die Freigabe beim Beenden der KI-App.

Aktivieren Sie für einen anderen lokalen Host KI-Apps erlauben, öffnen Sie Erweitert und erstellen Sie einen eigenen Token für diesen Host. Kopieren Sie ihn bei der Anzeige. Er wird nur einmal angezeigt.

Der Listener bleibt ausgeschaltet, bis Sie KI-Apps erlauben aktivieren. Ist er ausgeschaltet, wird kein MCP-Socket bereitgestellt.

KI-Hosts einrichten

Folgen Sie KI-Agent verbinden. Ein in der Cloud gehosteter Agent erreicht diesen lokalen Socket nicht allein durch die Installation eines Plugins.

Beispiel für die erste Verwendung

Dies ist ein erläuterndes Beispiel für Parrot Scribe 1.0.1, keine Aufzeichnung einer geprüften Desktop-Sitzung. Oberfläche und verfügbare Anweisungen Ihres Hosts können abweichen. Schließen Sie zuerst dessen Einrichtung ab.

1. Verbindung prüfen. Bitten Sie: "Prüfe den Status von Parrot Scribe. Starte keine Aufnahme." Der Agent ruft get_status auf und meldet den zurückgegebenen Zustand.
2. Sitzung wählen. Bitten Sie: "Zeige bis zu zwei aktuelle Parrot-Scribe-Sitzungen." Der Agent ruft list_sessions mit limit: 2 auf, liest das Array sessions und prüft hasMore sowie unavailableSessionCount. Er darf zwei Zeilen nicht als Ihre gesamte Bibliothek darstellen.
3. Vor dem Zusammenfassen lesen. Wählen Sie eine Sitzung, deren Inhalte Sie teilen möchten, und bitten Sie: "Fasse diese Sitzung zusammen. Trenne Entscheidungen, offene Fragen und vorgeschlagene Folgeaufgaben." Der Agent liest read_transcript, ruft alle benötigten Seiten ab und weist auf fehlende Abdeckung hin.
4. Aktionen ausdrücklich freigeben. Prüfen Sie die Zusammenfassung und erlauben Sie einzelne gewünschte Folgeaktionen. Eine in der Aufnahme gesprochene Bitte bleibt ein Vorschlag, bis Sie sie direkt im Chat freigeben.

Um während einer Aufnahme zuzuhören, laden Sie die Zuhöranweisungen und bitten Sie: "Verbinde dich nur mit der aktuellen Aufnahme. Markiere unbeantwortete Fragen; starte keine weitere Aufnahme." Ein geeigneter Host bindet sich an die aktive sessionId und wartet auf neue Transkripteinträge. Kann er nicht aktiv bleiben und währenddessen Ihre Anweisungen entgegennehmen, verwenden Sie stattdessen einzelne Abrufe bei Bedarf. Siehe Zuhören und Zusammenfassen.

Aufnahme und Transkription bleiben lokal. Transkriptinhalte, die Sie mit einem cloudbasierten Agenten teilen, können an dessen Anbieter gesendet werden.

Zugriffsmodell

Parrot Scribe steuert den Zugriff auf zwei Ebenen:

• Client-Zugriffsstufe, je Client in den Einstellungen:

  • Disabled: Kein Werkzeugzugriff.
  • Enabled: Standard nach erfolgreicher Authentifizierung mit gültigem Token. Status- und operative Werkzeuge sind erlaubt. Destruktive Werkzeuge fragen immer nach.
  • Trusted: Status-, operative und destruktive Werkzeuge sind ohne Rückfrage erlaubt.

• Werkzeugklasse:

Statuswerkzeuge

Reine Statusabfragen benötigen für "Enabled"- oder "Trusted"-Clients keine Freigabe pro Aufruf. "Disabled"-Clients haben keinen Werkzeugzugriff.

Operative Werkzeuge

Für Clients im Modus "Enabled" oder "Trusted" erlaubt.

Bibliotheksabfragen

Mediathek und MCP verwenden dieselbe indexgestützte Suche über die gesamte Bibliothek. Abfragen können Transkripttext, Sitzungs-IDs, Titel, Kommentare und Sprecheridentitäten finden. Ergebnislimits begrenzen zurückgegebene Zeilen und nicht die durchsuchten Sitzungen.

In Version 1.0.1 liefern list_sessions und search_sessions dasselbe JSON-Objekt in structuredContent und im ersten Text-Inhaltsblock. Sein Array sessions enthält Sitzungs-IDs, Zeitstempel, Dauer, Sprechermetadaten sowie Kennzeichen für Audio und aktiven Zustand. Leere Ergebnisse enthalten sessions: []. Dasselbe übergeordnete Objekt enthält totalCount, hasMore und unavailableSessionCount. Fordern Sie mit limit und offset eine Seite an. Bei hasMore: true erhöhen Sie offset um die Anzahl zurückgegebener Sitzungen.

Version 1.0.0 legt Sitzungszeilen nur im Text und Zähler in structuredContent ab. Clients, die dieses Textarray oder Suchzeilen auswerten, sollten auf das neue Array sessions wechseln.

unavailableSessionCount gibt an, wie viele gespeicherte Sitzungen nicht durchsucht werden konnten. Ein leeres Ergebnis beweist nicht, dass alle Bibliotheksdaten lesbar waren. Bibliotheksabfragen sind erst nach Verschlüsselungseinrichtung und Initialisierung verfügbar. Siehe Fehler bei der Bibliothekswiederherstellung.

Lange Transkripte lesen

read_transcript benötigt sessionId und akzeptiert optional limit sowie sinceSegment. Verwenden Sie ein begrenztes limit, wenn ein Host die Größe von Werkzeugantworten beschränkt. Lesen Sie transcript und behalten Sie die umgebenden Felder returnedCount, totalCount, hasMore und nextSinceSegment bei. Ist hasMore wahr, verwenden Sie nextSinceSegment als sinceSegment der nächsten Anfrage. Ein Abruf ist erst vollständig, wenn hasMore falsch ist.

Ohne limit werden derzeit alle passenden Segmente zurückgegeben. Seitenweiser Abruf ist in 1.0.0 verfügbar. Der Host muss ihn anfordern und die Fortsetzungsinformationen erhalten.

Destruktive Werkzeuge

Für "Enabled"-Clients fragt jeder Aufruf nach. "Trusted"-Clients können diese Werkzeuge ohne Rückfrage verwenden.

Argumente für Live-Abfragen

live_transcript akzeptiert optional sessionId, sinceSequence, epoch und waitSeconds. Binden Sie sich an die aktive Sitzung aus get_status und senden Sie anschließend beide Cursorwerte aus jeder Antwort zurück. Eine aufgeholte Anfrage mit passender Sitzung und Epoche kann bis zu 20 Sekunden auf Sprache oder eine Zustandsänderung warten.

Das Ergebnis steht in structuredContent und als JSON im Text-Inhaltsblock bereit. Es enthält gegebenenfalls sessionId sowie state, epoch, sinceSequence, gap, sessionChanged, minPollIntervalSeconds, schema und text. Das TOON-Schema beschreibt die Textzeilen. Behalten Sie diese Hülle bei. Wenn Sie nur text herauslösen, verlieren Sie Sitzungs- und Kontinuitätsinformationen.

Bei abweichender Sitzung ist sessionChanged wahr und es wird kein Transkripttext geliefert. Bei einer Lücke innerhalb derselben Sitzung lesen Sie zunächst read_transcript, um gespeicherte Nachweise nachzuholen, bevor Sie vom zurückgegebenen Cursor aus fortfahren. Zwischen Anfragestarts müssen mindestens minPollIntervalSeconds liegen, derzeit 3 Sekunden. Status- und Live-Werkzeuge erlauben jeweils 30 Anfragen pro Minute je Client. Schnelles paralleles Abfragen beider wird daher nicht unterstützt.

Ein ausdrücklicher Stopp kann die gebundene sessionId enthalten. Eine Abweichung schlägt fehl, ohne die Aufnahme zu beenden. Ohne ID bleibt die allgemeine Stoppfunktion erhalten. Das Zuhör-Plugin beschränkt seine Stopps immer auf die gebundene Sitzung. Eine historische oder zwischenzeitliche Zusammenfassung benötigt nur Lesewerkzeuge und sollte keine Aufnahme beenden.

Parrot Scribe 1.0.1 meldet diese sitzungsgebundenen Zuhörargumente. Dadurch wird Transkripttext nicht zu autorisierten Anweisungen. Der Host muss gesprochene Vorschläge für Folgeaufgaben von direkten Benutzerbefehlen trennen und seine eigenen Werkzeugfreigaben durchsetzen.

Ausführung von Änderungen und Sicherheitsprotokoll

Parrot Scribe liefert die Antwort auf ein änderndes Werkzeug erst, wenn der Vorgang endgültig erfolgreich oder fehlgeschlagen ist. Es liefert kein bloß angenommenes oder noch laufendes Ergebnis.

Vor Beginn der eigentlichen Arbeit speichert Parrot Scribe dauerhaft einen Audit-Eintrag started, der nur Vorgangs-ID, Werkzeugname und Ergebnis enthält. Sobald die eigentliche Arbeit begonnen hat, läuft sie bis zum endgültigen Ergebnis weiter, auch wenn der MCP-Aufrufer die Verbindung trennt. Dieser erhält das Ergebnis dann möglicherweise nicht. Eine Verbindungstrennung bricht den Vorgang aber weder ab noch macht sie ihn rückgängig.

Nach dem Abschluss ergänzt Parrot Scribe einen zugehörigen Eintrag succeeded oder failed. Stürzt die App nach dem Speichern von started, aber vor dem abschließenden Eintrag ab, bedeutet der einzelne started-Eintrag, dass das Ergebnis unbekannt ist. Er behauptet nicht, die Änderung sei fehlgeschlagen. Dieses Sicherheitsprotokoll ist keine dauerhafte Auftragswarteschlange und bietet weder automatische Wiederherstellung noch Wiederholungsversuche oder Statusabfragen.

Lebenszyklus von Tokens

• Verwenden Sie für ChatGPT, Claude und Cursor Verbinden unter Einstellungen > KI-Apps. Parrot Scribe speichert diese Zugangsdaten und übergibt dem Helfer eine Profil-ID.
• Stellen Sie für andere Hosts unter Erweitert jeweils einen eigenen Token aus. Übergeben Sie ihn als PARROTSCRIBE_MCP_TOKEN an den Helfer. Verwenden Sie nicht --token.
• Die Prüfdatensätze des Servers speichern Token-Hashes. Die verwaltete Desktop-Einrichtung speichert außerdem den verwendbaren Zugangswert im geschützten, nicht synchronisierenden Schlüsselbund dieses Macs, damit sich der signierte Helfer authentifizieren kann. Erzeugte Host-Konfiguration enthält nur die Profil-ID.
• Das Widerrufen eines Tokens entfernt den Client-Zugriff sofort und trennt aktive Sitzungen dieses Tokens.

Sicherheitsmodell

Vier Ebenen schützen Ihre Daten:

1. Transport: Lokaler Unix-Socket mit Zugriff nur für den Eigentümer.
2. Authentifizierung: Token beim Verbindungs-Handshake erforderlich.
3. Autorisierung: Zugriffsstufen je Client und Rückfragen vor destruktiven Aktionen.
4. Anfragelimits: Begrenzung je Client und Schutz vor Massenabrufen reduzieren automatisierten Missbrauch.

Anwendungsfälle

• Meeting-Begleitung: KI folgt einem laufenden Gespräch und nennt passenden Kontext.
• Aufgabenverfolgung: KI erkennt Zusagen und bereitet Folgeaufgaben vor.
• Sitzungszusammenfassung: KI erzeugt strukturierte Zusammenfassungen nach einer Aufnahme.
• Recherchehilfe: KI durchsucht ältere Transkripte nach Mustern.

Den gesamten Ablauf von Aufnahme über Prüfung und Suche bis zur optionalen KI-Nutzung beschreibt Meeting-Notizen erstellen.

Weitere Informationen

• Dokumentation des Model Context Protocol, auf Englisch