Kryteria kwalifikacji plików MCP na Dysku

Serwer Model Context Protocol (MCP) Dysku Google egzekwuje kontrolę dostępu i reguły kwalifikacji, aby określić, z którymi plikami i folderami agenty AI mogą wchodzić w interakcje.

Po wywołaniu narzędzi serwer MCP ocenia użytkownika wysyłającego żądanie i konkretne elementy, aby zapobiec nieautoryzowanemu dostępowi i przestrzegać zasad bezpieczeństwa.

Wymagania

W przypadku agentów AI i aplikacji korzystających z serwera MCP Dysku Google pliki muszą przejść serię kontroli bezpieczeństwa, zasad i możliwości. Serwer MCP ocenia reguły zapobiegania utracie danych (DLP) w Google Workspace, ale tylko zasady, które wymuszają ustawienia zarządzania prawami do informacji (IRM), ograniczają dostępność.

Aby plik lub folder mógł być używany przez serwer MCP, musi spełniać te kryteria:

  • Dostępność usługi: usługa Dysk Google musi być włączona dla organizacji użytkownika w konsoli administracyjnej Google Workspace.
  • Sprawdzanie listy ACL: użytkownik wysyłający żądanie musi mieć co najmniej uprawnienia do odczytu (reader) pliku lub folderu.
  • Ograniczenia na poziomie elementu:
    • Zarządzanie prawami do informacji (IRM): jeśli element ma ustawienia IRM uniemożliwiające pobieranie, kopiowanie i wklejanie lub drukowanie (w tym ustawienia wymuszane przez zasady DLP skonfigurowane przez administratora), agenty AI nie mogą uzyskać do niego dostępu.
    • CAA (dostęp zależny od kontekstu): oceniany przy użyciu funkcji capabilities.canDownload pliku. Jeśli zasady dostępu zależnego od kontekstu blokują dostęp w kontekście klienta (lub jeśli podczas operacji offline lub w tle brakuje danych kontekstowych), element nie kwalifikuje się do wyświetlenia. Jeśli kontekst klienta spełnia wymagania CAA, element pozostaje odpowiedni.
    • Szyfrowanie po stronie klienta: treści zaszyfrowane po stronie klienta nie mogą być analizowane przez agentów AI i nie kwalifikują się do wykorzystania.
  • Specjalne typy produktów:
    • Foldery i skróty: metadane folderów i skrótów są kwalifikowane. Jednak pliki zagnieżdżone w folderach lub pliki docelowe, do których odwołują się skróty, muszą niezależnie przejść wszystkie weryfikacje.
  • Niepożądane stany produktów:
    • Spam i złośliwe oprogramowanie: elementy oznaczone jako spam lub złośliwe oprogramowanie nie kwalifikują się do wyświetlania.

Działanie serwera MCP w przypadku nieodpowiednich elementów

Jeśli agent AI spróbuje uzyskać dostęp do niekwalifikującego się elementu, zachowanie serwera zależy od typu operacji, jak opisano w sekcjach poniżej.

Operacje na pojedynczych plikach

W przypadku operacji dotyczących pojedynczego pliku lub folderu (takich jak odczytywanie zawartości, pobieranie, aktualizowanie metadanych lub pobieranie uprawnień) serwer zwraca komunikat o błędzie podobny do tego:

Nie można pobrać metadanych elementu <item id>, ponieważ nie można go używać w kontekstach generatywnej AI.

Operacje na wielu plikach i listach

W przypadku operacji, które pobierają listy lub wyszukują wiele plików (np. wyszukiwanie plików lub wyświetlanie listy ostatnich plików), serwer odfiltrowuje niekwalifikujące się elementy z wyników wyszukiwania lub list plików. Może to powodować rozbieżności, gdy użytkownik może wyświetlić lub edytować plik w interfejsie internetowym Dysku Google, ale agent AI nie może go znaleźć ani zobaczyć.