Anslut din agent

Version: Den här guiden beskriver den stabila versionen Parrot Scribe 1.0.8. Den offentliga betaversionen 1.1.0 har andra reglage och vissa funktioner är ännu inte klara. Läs Installation av betaversionen och skillnader innan du följer stegen i betaversionen.

Kräver Parrot Scribe Pro. Åtkomst till MCP-servern ingår i Parrot Scribe Pro. Befintliga licenser omfattar redan Pro.

Anslut ChatGPT, Claude eller Cursor från Parrot Scribe. Dessa steg kräver Parrot Scribe 1.0.2 eller senare. Att behålla anslutningen efter att en AI-app startar om kräver Parrot Scribe 1.0.5. Parrot Scribe 1.0.1 använder Inställningar > MCP och en klienttoken. Uppdatera innan du följer skrivbordsstegen nedan.

Parrot Scribes katalog (på engelska) är avsedd för Claude Code och Codex CLI. Den installerar inte de tre skrivbordsraderna. Parrot Scribe skapar dessa anslutningar på denna Mac.

Gemensam installation

1. Installera Parrot Scribe på /Applications/Parrot Scribe.app och låt appen vara igång.
2. Öppna den AI-skrivbordsapp du vill ansluta och låt den vara igång.
3. Öppna Inställningar > AI-appar i Parrot Scribe.
4. Aktivera Tillåt AI-appar. Detta kräver Pro.
5. Välj Anslut på önskad apps rad. En redan konfigurerad rad visar först Hantera…. Öppna den och välj sedan Anslut.

Anslut godkänner skrivbordsappen på denna Mac. Den förblir ansluten medan du använder den, även efter att du avslutar och öppnar ChatGPT, Claude eller Cursor igen. När appen återansluter visar dess rad Ansluten medan den arbetar och Konfigurerad · Inaktiv mellan förfrågningar, utan Hantera… > Anslut. Välj Anslut igen bara efter Koppla från, eller efter 90 dagar utan användning. Skrivbordsappen måste köras första gången du väljer Anslut. I Parrot Scribe 1.0.4 och tidigare upphör godkännandet när AI-appen avslutas.

Varje rad behåller sin egen status:

Appen lagrar autentiseringsuppgiften och startar sin signerade shim med ett profil-ID. Kopiera inte en token till skrivbordsappen, en skalprofil eller ett chattmeddelande. En moln- eller mobilsession når inte denna Mac genom att installera ett insticksprogram.

ChatGPT Desktop

Välj Anslut på ChatGPT-raden. Parrot Scribe öppnar ett lokalt insticksprogram som innehåller anslutningen och färdigheten listening. Slutför installationen i ChatGPT, starta sedan en ny lokal uppgift och välj listening.

En webb-, mobil- eller molnuppgift får inte tillgång till denna Mac. Använd en lokal uppgift.

Version 1.0.6 rättade den tidigare felaktiga statusen Konfigurerad · Inte ansluten efter att Parrot Scribe startar om. Om du uppgraderar från 1.0.5 eller tidigare ska du avsluta och öppna den anslutna AI-appen en gång för att läsa in den uppdaterade hjälparen.

Claude Desktop

Välj Anslut på Claude-raden. Parrot Scribe installerar ett lokalt Claude-tillägg för anslutningen. Claude kan visa en röd varning för ett ogranskat tillägg. Varningen hör till Claude. Att installera tillägget tar inte bort den.

När tillägget är installerat väljer du Lägg till lyssningsfärdighet… på Claude-raden. Knappen öppnar Claude så att du kan granska och lägga till färdigheten. På denna Mac kan öppning av enbart färdighetsfilen lämna över den till ChatGPT i stället.

Tillägget och lyssningsfärdigheten förblir separata. Ersätt inte tillägget med ett kombinerat Claude-insticksprogram. Det kan ta bort Claudes chattanslutning.

Om du väljer Koppla från och sedan Anslut igen kan Claude fortfarande ha det tidigare tillägget installerat. Om Claude erbjuder Uninstall i stället för installation väljer du Uninstall och sedan Install.

Cowork är ett separat värdprogram. Dessa skrivbordssteg konfigurerar inte Cowork.

Cursor

Välj Anslut på Cursor-raden. Parrot Scribe installerar ett lokalt insticksprogram i ~/.cursor/plugins/local/parrot och öppnar Cursors överlämning för anslutningen. De äldre Cursor-kommandona läggs inte till.

Slutför överlämningen i Cursor, starta sedan en ny chatt och be den använda färdigheten listening. En anslutning läser inte i sig in färdigheten i en befintlig chatt.

Kontrollera anslutningen

1. Kontrollera att raden visar Ansluten eller Konfigurerad · Inaktiv efter att skrivbordsappen har återanslutit.
2. Be den anropa get_status utan att starta inspelning.
3. Be den anropa list_sessions med limit: 2. En tom array sessions är giltig för ett tomt bibliotek. Kontrollera unavailableSessionCount innan du behandlar resultatet som fullständig täckning.
4. Välj en session du vill dela innan du ber om en sammanfattning. Se Lyssna och sammanfatta.

Om installationen säger att den inte kunde förbereda anslutningen kontrollerar du först att den valda AI-skrivbordsappen redan körs och försöker sedan med Anslut igen. Om raden stannar på Konfigurerad · Inte ansluten medan appen är öppen kan godkännandet ha upphört efter 90 dagar utan användning. Välj Hantera… > Anslut. Om Anslut fortsätter be dig öppna en app som redan är öppen väljer du Koppla från på raden och sedan Anslut. Om verktyg saknas slutför du överlämningen i appen och startar en ny uppgift eller chatt. Låt Parrot Scribe vara igång med Pro och Tillåt AI-appar aktiverat.

Andra lokala värdprogram

Claude Code, Codex CLI och andra lokala stdio-värdprogram är inte rader i AI-appar. Använd en token per värdprogram från Inställningar > AI-appar > Avancerat. Kopiera token när den visas. Den visas bara en gång.

Shimmen läser PARROTSCRIBE_MCP_TOKEN från sin miljö. Parrot Scribe nekar --token och --token=.... Håll token borta från kommandoradsargument, projektfiler, skalprofiler och chattmeddelanden.

Den signerade shimmen finns här:

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

Om ett värdprogram redan har en Parrot Scribe-anslutning behåller du en aktiverad anslutning. Låt inte två verktygsuppsättningar vara aktiva samtidigt.

Claude Code

Installera katalogen och insticksprogrammet:

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

Insticksprogram 0.4.0 innehåller anslutningen för Claude Code. Ange denna klients token i insticksprogrammets fält Parrot Scribe client token. Skapa token under Avancerat. Claude Code lagrar den i sitt autentiseringslager och lämnar den till shimmen. Använd en aktuell Claude Code-version med stöd för userConfig.

Lägg inte till en andra manuell anslutning efter att du har installerat insticksprogrammet. Starta en ny session och använd /parrot:listen eller /parrot:recap.

Codex CLI

Lägg till katalogen, installera insticksprogrammet och starta en ny session:

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

Tillhandahåll en separat token i Codex-värdprogrammets miljö. Insticksprogrammet vidarebefordrar PARROTSCRIBE_MCP_TOKEN. Detta är inte ChatGPT-raden ovan. En manuell anslutning använder:

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

Behåll en aktiverad anslutning. Återanvänd inte denna token för ett annat värdprogram.

Värdprogram som behöver miljömappning

Använd samma shim och en separat token. Om värdprogrammet inte skickar PARROTSCRIBE_MCP_TOKEN till shimmen använder du nyckelringsstartaren nedan.

Grok Build, i ~/.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, i ~/.gemini/settings.json:

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

OpenCode, under mcp i ~/.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}"
      }
    }
  }
}

Dessa värdprogram får MCP-verktyg. De får inte skrivbordets listening-färdighet eller /parrot:listen om du inte läser in lyssningskontraktet (på engelska) som instruktioner.

Nyckelringsstartare för andra värdprogram

Använd detta när ett värdprogram inte kan föra in token i shimmens miljö. Skapa en generell lösenordspost i Nyckelhanterare för värdprogrammet. Spara token som lösenord. Återanvänd inte ett annat värdprograms token.

Spara skriptet på en absolut sökväg, till exempel /Users/you/.local/bin/parrotscribe-mcp-keychain. Ersätt /Users/you med din kontosökväg. Skriptet innehåller ingen 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" "$@"

Kör chmod 700 /Users/you/.local/bin/parrotscribe-mcp-keychain. Peka värdprogrammets kommando mot skriptet och skicka bara nyckelringspostens namn:

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

Använd inte denna startare för raderna ChatGPT, Claude eller Cursor. Dessa rader hanterar autentiseringsuppgiften.

Underhåll

• För att koppla från ChatGPT, Claude eller Cursor väljer du Koppla från på dess rad. Andra appar förblir konfigurerade.
• För att byta token för ett annat värdprogram återkallar du den under Avancerat, utfärdar en ersättare, uppdaterar hemlighetskällan och startar om värdprogrammet.
• För en äldre --token-konfiguration tar du bort token från kommandot eller konfigurationen. Använd Avancerat eller nyckelringsstartaren och starta sedan om värdprogrammet. Återkalla en token som har exponerats i ett kommando, en logg eller en kopierad fil.
• Starta om värdprogrammet efter en ändring av token eller konfiguration.

Verktygsargument och åtkomstkontroller finns i MCP-server. Arbetsflödet beskrivs i Lyssna och sammanfatta.

Betaversion 1.1.0

Betaversionens Inställningar > AI-appar visar Codex, Claude och Cursor. Öppna AI-appen först, välj Anslut på dess rad och slutför överlämningen där. Använd radens Hantera…-reglage för att återansluta, ändra åtkomst eller koppla från appen. Varje rad har sin egen nya autentiseringsuppgift. Befintliga 1.0.x-godkännanden ger inte åtkomst till betaversionen.

Välj Enkel för läsning, inspelningskontroll och ändringar av talarnamn. Enkel kan inte radera sessioner eller ta bort/glömma talare. Betrodd tillåter dessutom dessa destruktiva verktyg utan en ny fråga. Att bevilja den åtkomsten kräver bekräftelse. AI-värdprogrammets egna behörighetsfrågor gäller fortfarande. Att koppla från raden eller återkalla en manuell token tar bort klientens åtkomst.

För ett kommandoradsvärdprogram öppnar du Avancerat, anger ett klientnamn och väljer Skapa token. Använd den genererade konfigurationen med en separat token för det värdprogrammet. Token visas bara en gång och hör hemma i PARROTSCRIBE_MCP_TOKEN, inte i kommandoradsargument. Behåll en aktiverad anslutning per värdprogram. Befintliga katalogkonfigurationer som använder kompatibilitetssökvägen parrotscribe-mcp-shim kan använda en ny betatoken. Det signerade paketet exponerar även parrotscribe-mcp.

Cursor behöver för närvarande Reload i sina MCP-inställningar efter att Parrot Scribe startar om. En konfigurerad rad bevisar inte ensam att ett AI-värdprogram har återanslutit. Be det anropa get_status och göra en avsedd läsning. Godkännande av återanslutning och återkallelse med varje verkligt värdprogram är separata kontroller från installationen av dess konfiguration.

Betaversionens hanterade skrivbordshjälpare använder en privat Unix-socket. Den verifierar den anslutna appens användare och kodsigneringsidentitet innan den läser den hanterade autentiseringsuppgiften i nyckelringen. Manuella anslutningar med miljötoken använder en separat 127.0.0.1-transport med en utmaning mot en ändpunktshemlighet innan token skickas. Inspelning och lagring förblir lokala, men ett molnbaserat AI-värdprogram kan skicka hämtat transkriptinnehåll till sin leverantör. Se Betaversionens lagringsgränser.