MCP-server

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.

Börja med Anslut din agent för ChatGPT, Claude och Cursor. Guiden använder Inställningar > AI-appar. Lyssna och sammanfatta förklarar arbetsflödet när apparna är anslutna.

För 1.1.0-beta.1: Följ Anslutningar i betaversionen. Åtkomstnivåerna är Enkel och Betrodd. Den hanterade skrivbordshjälparen verifierar den signerade appen över en privat Unix-socket, medan manuella klienter använder en separat autentiserad loopback-transport. Livejournalen rymmer 1 024 bekräftade meningar. Enkel nekar destruktiva verktyg i stället för att visa den stabila appens bekräftelse per anrop. Den stabila versionens transport, åtkomst och sidindelningsstandarder nedan är inte betaversionens kontrakt.

Vad är MCP?

Model Context Protocol (MCP) (dokumentation på engelska) låter AI-assistenter använda externa verktyg och data genom ett strukturerat gränssnitt. Parrot Scribe innehåller den lokala servern och en signerad anslutningsshim. Din agent behöver fortfarande en anslutning och en klienttoken. Insticksprogrammet lägger till instruktioner för lyssning och sammanfattning där det stöds.

Så fungerar det

MCP-servern körs i Parrot Scribe som en enda process. Det finns ingen separat server att hantera.

• Inbyggd: Servern är en del av Parrot Scribe. Inga externa paket eller beroenden behövs.
• Unix-domänsocket: Kommunikationen använder en lokal Unix-socket som bara ägaren kan komma åt.
• Shim-brygga: Medföljande parrotscribe-mcp-shim kopplar MCP-värdprogram med stdio till den lokala socketen.
• Tokenautentisering: Klienter måste visa upp en giltig token vid handskakningen.
• Avstängd som standard: MCP-lyssnaren är inaktiverad tills du uttryckligen slår på den. När den är av exponeras ingen MCP-socket.

Protokollversioner

Version 1.0.1 stöder 2026-07-28-förfrågningar med protokollmetadata per förfrågan och server/discover, jämte handskakningen 2024-11-05 från 1.0.0. Båda använder samma lokala stdio-anslutning. Modern upptäckt annonserar 2026-07-28, medan äldre värdprogram fortfarande kan använda initieringshandskakningen. Serverstöd innebär inte att varje värdprogram väljer det moderna protokollet. Båda vägarna behåller klientautentisering, behörigheter och kravet att Parrot Scribe körs.

Aktivera MCP-servern

För ChatGPT, Claude och Cursor öppnar du först den valda AI-skrivbordsappen och låter den vara igång. Öppna Inställningar > AI-appar i Parrot Scribe, aktivera Tillåt AI-appar och välj Anslut på appens rad. Parrot Scribe 1.0.2 hanterar autentiseringsuppgiften. Skapa inte en separat token för dessa tre appar.

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. Välj Hantera… > Anslut igen efter Koppla från, eller efter 90 dagar utan användning. För att anslutningen ska finnas kvar efter en omstart krävs Parrot Scribe 1.0.5. I tidigare versioner upphör godkännandet när AI-appen avslutas.

För ett annat lokalt värdprogram aktiverar du Tillåt AI-appar, öppnar Avancerat och skapar en token för det värdprogrammet. Kopiera den när den visas. Den visas bara en gång.

Lyssnaren förblir avstängd tills du aktiverar Tillåt AI-appar. När den är av exponeras ingen MCP-socket.

Ställ in AI-värdprogram

Följ Anslut din agent. En molnbaserad agent når inte denna lokala socket bara genom att installera ett insticksprogram.

Exempel på första användningen

Detta är en illustrativ genomgång för Parrot Scribe 1.0.1, inte en inspelning av en testad skrivbordssession. Värdprogrammets gränssnitt och tillgängliga instruktioner kan skilja sig. Följ dess installationsguide först.

1. Kontrollera anslutningen. Be: "Kontrollera Parrot Scribes status. Starta inte inspelning." Agenten anropar get_status och rapporterar tillståndet som returneras.
2. Välj en session. Be: "Visa högst två senaste Parrot Scribe-sessioner." Agenten anropar list_sessions med limit: 2, läser arrayen sessions och kontrollerar hasMore och unavailableSessionCount. Den ska inte påstå att två rader är hela ditt bibliotek.
3. Läs före sammanfattning. Välj en session du vill dela och be: "Sammanfatta den här sessionen. Skilj på beslut, olösta frågor och föreslagna uppföljningar." Agenten läser read_transcript, följer varje nödvändig sida och rapporterar saknad täckning.
4. Behåll uttryckliga åtgärder. Granska sammanfattningen och godkänn en viss uppföljning som du vill få utförd. En begäran som sägs i inspelningen förblir ett förslag tills du godkänner den direkt i chatten.

För att prova lyssning under en inspelning läser du in lyssningsinstruktionerna och ber: "Anslut bara till aktuell inspelning. Markera obesvarade frågor, men starta ingen ny inspelning." Ett värdprogram med nödvändigt stöd binder till aktivt sessionId och väntar på nya transkriptposter. Om det inte kan förbli aktivt och ta emot din styrning bör du använda läsning vid behov i stället. Se Lyssna och sammanfatta.

Inspelning och transkribering stannar lokalt. Transkriptinnehåll som du delar med en molnbaserad agent kan skickas till agentens leverantör.

Åtkomstmodell

Parrot Scribe tillämpar kontroller på två nivåer:

• Klientens åtkomstnivå (ställs in per klient i Inställningar):

  • Inaktiverad: Ingen verktygsåtkomst.
  • Aktiverad: Standard när en klient autentiseras med giltig token. Status- och funktionsverktyg tillåts. Destruktiva verktyg frågar alltid.
  • Betrodd: Status-, funktions- och destruktiva verktyg tillåts utan frågor.

• Verktygsklass:

Statusverktyg

Skrivskyddad status behöver inget godkännande per anrop för klienter med Aktiverad eller Betrodd åtkomst. Inaktiverade klienter har ingen verktygsåtkomst.

Funktionsverktyg

Tillåtna för klienter i läget Aktiverad eller Betrodd.

Biblioteksfrågor

Biblioteket och MCP använder samma indexerade sökning över hela biblioteket. Frågor kan matcha transkripttext, sessions-ID:n, titlar, kommentarer och talaridentiteter. Resultatgränser begränsar antalet returnerade rader, inte vilka sessioner som söks igenom.

I version 1.0.1 returnerar list_sessions och search_sessions samma JSON-objekt i structuredContent och det första textinnehållsblocket. Arrayen sessions innehåller sessions-ID:n, tidsstämplar, längd, talarmetadata och flaggor för ljud och aktivt tillstånd. Tomma resultat innehåller sessions: []. Samma objekt på toppnivå innehåller totalCount, hasMore och unavailableSessionCount. Använd limit och offset för att begära en sida. När hasMore är sant ökar du offset med antalet returnerade sessioner.

Version 1.0.0 lägger sessionsrader bara i text och antal i structuredContent. Klienter som tolkar dess textarray eller sökrader bör övergå till den nya arrayen sessions.

unavailableSessionCount anger hur många lagrade sessioner som inte kunde genomsökas. Ett tomt resultat bevisar inte att all biblioteksdata var läsbar. Biblioteksfrågor är otillgängliga tills krypteringsinställning och initiering är klara. Se Fel vid biblioteksåterställning.

Läs långa transkript

read_transcript kräver sessionId och tar valfria limit och sinceSegment. Använd ett begränsat limit när ett värdprogram begränsar verktygsresultatens storlek. Läs fältet transcript och behåll omgivande fält returnedCount, totalCount, hasMore och nextSinceSegment. Om hasMore är sant använder du nextSinceSegment som nästa förfrågans sinceSegment. Läsningen är komplett först när hasMore är falskt.

Om limit utelämnas returneras för närvarande alla matchande segment. Sidindelning finns i 1.0.0. Värdprogrammet måste begära den och bevara fortsättningsinformationen.

Destruktiva verktyg

För klienter med Aktiverad åtkomst visas en fråga vid varje anrop. Betrodda klienter kan köra dessa utan frågor.

Argument för liveprenumeration

live_transcript tar valfria argument sessionId, sinceSequence, epoch och waitSeconds. Bind till den aktiva sessionen från get_status och skicka sedan tillbaka båda markörvärdena från varje svar. En förfrågan som har hunnit ikapp och matchar session och epok kan vänta upp till 20 sekunder på tal eller ett tillståndsbyte.

Resultatet finns i structuredContent och som JSON i textinnehållsblocket. Det innehåller sessionId när det finns, state, epoch, sinceSequence, gap, sessionChanged, minPollIntervalSeconds, schema och text. TOON-schemat beskriver textraderna. Bevara detta hölje. Att bara hämta text kastar bort kontinuitets- och sessionsinformation.

Om sessionen inte matchar är sessionChanged sant och ingen transkripttext returneras. Vid en lucka inom samma session använder du read_transcript för att hämta sparad evidens innan du fortsätter från den returnerade markören. Start av pollningar ska skiljas åt med minst minPollIntervalSeconds, för närvarande 3 sekunder. Status- och liveverktyg tillåter vardera 30 förfrågningar per minut och klient, så snabba dubbla pollningsloopar stöds inte.

Ett uttryckligt stopp kan innehålla bundet sessionId. Om det inte matchar misslyckas anropet utan att inspelningen stoppas. Utelämnat ID behåller den allmänna stoppfunktionen. Lyssningsinsticksprogrammet avgränsar alltid sina stopp. En historisk eller tillfällig sammanfattning behöver bara läsverktyg och ska inte stoppa inspelning.

Parrot Scribe 1.0.1 annonserar dessa sessionsbundna lyssningsargument. Det gör inte transkripttext till behöriga instruktioner. Värdprogrammet måste hålla talade uppföljningsförslag åtskilda från direkta användarkommandon och tillämpa sin egen godkännandepolicy för verktyg.

Leverans av ändringar och granskningslogg

Parrot Scribe returnerar svar från ett ändrande verktyg först när åtgärden har nått slutlig framgång eller slutligt fel. Det returnerar inte ett accepterat eller fortfarande pågående resultat.

Innan domänarbetet startar sparar Parrot Scribe varaktigt en granskningspost started med endast ett åtgärds-ID, verktygsnamn och utfall. När domänarbetet väl har startat fortsätter det till ett slutligt resultat även om MCP-anroparen kopplas från. En frånkopplad anropare kanske inte får resultatet, men frånkoppling avbryter eller återställer inte åtgärden.

När åtgärden är klar lägger Parrot Scribe till en korrelerad granskningspost succeeded eller failed. Om appen kraschar efter att started har sparats men innan en slutpost har sparats betyder den ensamma started att utfallet är okänt. Den påstår inte att ändringen misslyckades. Granskningsspåret är ingen varaktig jobbkö och ger inte automatisk återställning, nytt försök eller pollning.

Tokenlivscykel

• För ChatGPT, Claude och Cursor använder du Anslut under Inställningar > AI-appar. Parrot Scribe lagrar autentiseringsuppgiften och skickar ett profil-ID till shimmen.
• För ett annat värdprogram utfärdar du en token från Avancerat. Skicka den till shimmen som PARROTSCRIBE_MCP_TOKEN. Använd inte --token.
• Serverns valideringsposter lagrar tokenhashar. Hanterad skrivbordsinstallation lagrar även den användbara autentiseringsuppgiften i datorns skyddade, icke-synkroniserande nyckelring så att den signerade shimmen kan autentisera. Den genererade värdkonfigurationen innehåller bara profil-ID:t.
• Återkallelse av en token tar omedelbart bort klientens åtkomst och kopplar från aktiva sessioner för denna token.

Säkerhetsmodell

Fyra lager skyddar dina data:

1. Transport: Lokal Unix-socket med åtkomst enbart för ägaren.
2. Autentisering: Token krävs vid anslutningshandskakningen.
3. Behörighetskontroll: Åtkomstnivåer per klient och frågor vid destruktiva åtgärder.
4. Frekvenskontroller: Begränsningar per klient och skydd mot massåtkomst minskar automatiserat missbruk.

Användningsfall

• Mötesbevakning: AI följer ett livesamtal och visar relevant sammanhang.
• Uppföljningsstöd: AI upptäcker åtaganden och förbereder uppföljande uppgifter.
• Sessionssammanfattning: AI skapar strukturerade sammanfattningar efter inspelningar.
• Researchassistent: AI söker efter mönster i tidigare transkript.

För hela arbetsflödet med inspelning, granskning, återfinnande och valfri AI, läs Arbetsflöde för mötesanteckningar.

Läs mer

• Dokumentation för Model Context Protocol (på engelska)