Skrivebeskyttet tilgang

Hva en skrivebeskyttet tilkobling kan gjøre

• Den har tillatelsen read:email, og eventuelt search:email, som ikke gir noe ekstra.
• Den kan liste, lese og søke i meldinger, laste ned vedlegg og liste innbokser og mapper.
• Den kan ikke sende, svare, lage utkast, flytte, flagge, markere som lest, slette, planlegge eller lage automatiseringer.

Slik velger du den

• Når du kobler til en AI-klient, viser samtykkeskjermen tilgangsnivåer. Velg Skrivebeskyttet («Les og søk i e-posten din. Kan ikke sende, endre eller slette noe.») eller åpne Tilpass tillatelser og gi bare lesetilgang. Du kan også begrense tilkoblingen til noen av innboksene dine.
• ChatGPT åpner denne skjermen på Full tilgang, fordi ChatGPT ikke kan komme tilbake og be om mer tilgang senere. Velg Skrivebeskyttet før du klikker Gi tilgang.
• API-nøkler du lager i dashbordet kan begrenses til de samme tillatelsene.

Slik håndheves grensene

• Hvert verktøykall sjekkes mot tilkoblingens tillatelser før vi kontakter e-postserveren din. Et kall utenfor tillatelsene avvises med insufficient_scope.
• På IMAP-postbokser åpner en skrivebeskyttet tilkobling hver mappe med EXAMINE, den skrivebeskyttede formen av SELECT. Da avviser e-postleverandøren selv enhver endring av flagg, flytting eller sletting i den økten, uansett hva vår kode gjør.
• Meldinger hentes med BODY.PEEK, så det å lese en melding markerer den aldri som lest. Det gjelder alle tilkoblinger, ikke bare skrivebeskyttede.
• Leseverktøyet endrer aldri postboksen din. Det gamle valget mark_as_read er fjernet; å markere som lest er en egen handling som krever tillatelsen manage:folders.
• AI-klienter som logger inn med OAuth ser hele verktøylisten, slik at de kan be deg om mer tilgang. Disse kallene feiler likevel til du gir tilgangen.

Hva som skjer når du kobler til

• Vi åpner en TLS-tilkobling, sjekker serverens sertifikat, logger inn én gang for å kontrollere passordet eller app-passordet ditt, og logger ut.
• Ingenting lastes ned, kopieres eller indekseres. Meldinger hentes fra leverandøren din bare når et verktøy ber om dem.
• Bakgrunnsarbeid kjører bare for automatiseringer og planlagte utsendelser, og begge krever skrivetillatelser som en skrivebeskyttet tilkobling ikke har.
• Hvis du aldri vil sende fra adressen, velger du Avanserte innstillinger → Tilkoblingstype → Kun motta (IMAP) når du kobler den til. Ingen SMTP-server settes opp eller kontaktes.

Søk i store postbokser

• På IMAP-postbokser kjøres søket på leverandørens server med IMAP SEARCH. Vi laster bare ned den siden med treff som ble bedt om, opptil 100 meldinger, og AI-en blar videre gjennom resten.
• Søket dekker innboksen med mindre en mappe er oppgitt, fordi det er tregt å søke i alle mapper på en stor konto.
• Hvert søk har en grense på 30 sekunder. I en postboks med titusenvis av meldinger bør du snevre inn et bredt søk etter avsender, emne eller dato.

Sjekk selv

mcpemails er åpen kildekode. Disse filene implementerer og tester det denne siden beskriver:

• imap-read-only.ts EXAMINE for skrivebeskyttede tilkoblinger
• imap-read-only.test.ts Tester for EXAMINE, blant annet at leverandøren avviser en flaggendring
• scopes.ts Listen over tillatelser
• argument-aliases.ts Fjerningen av mark_as_read fra leseverktøyet
• imap-client.ts IMAP-klienten: hver henting av innhold bruker BODY.PEEK