Przewodnik administratora: podłączenie Gmaila (MCP)

Ten przewodnik pokazuje, jak administrator organizacji podłącza Gmaila do AnyLawyer przez integrację MCP. Konfigurację wykonujesz raz dla całej organizacji, a potem każdy użytkownik łączy własną skrzynkę jednym kliknięciem. Większość pracy odbywa się w Google Cloud Console, gdzie włączasz dwa interfejsy API i tworzysz klienta OAuth, którego dane wklejasz w AnyLawyer.

Zobacz na wideo

Poniższe nagranie pokazuje całą konfigurację od początku do końca: włączenie Gmail API, utworzenie klienta OAuth z adresem przekierowania AnyLawyer oraz dodanie Gmaila w ustawieniach organizacji. Nagranie pokazuje też włączanie Gmail MCP API; ten krok nie jest już wymagany i możesz go pominąć.

Nagranie ma polskie napisy opisujące każdy krok. Jeśli wolisz czytać, poniżej znajdziesz te same kroki opisane po kolei.

Jak to działa?

Gmail jest podłączany przez integrację MCP w AnyLawyer. Logowanie odbywa się przez Google OAuth, a asystent czyta skrzynkę przez standardowe Gmail API.
Każda organizacja korzysta z własnego klienta OAuth Google. Na ekranie zgody użytkownicy zobaczą nazwę Waszej aplikacji, a dostęp do skrzynek pozostaje pod Waszą kontrolą.
Administrator konfiguruje integrację raz. Potem każdy użytkownik łączy swoją skrzynkę własnym kontem Google bezpośrednio z okna rozmowy.
Asystent może przeszukiwać wątki i czytać korespondencję. Narzędzia są tylko do odczytu: asystent nie tworzy wersji roboczych, nie wysyła, nie oznacza ani nie usuwa wiadomości.

Wymagane zakresy uprawnień, o które AnyLawyer prosi Google:

https://www.googleapis.com/auth/gmail.readonly
https://www.googleapis.com/auth/gmail.compose

Czego potrzebujesz?

Roli Administratora w organizacji AnyLawyer.
Konta Google z dostępem do Google Cloud Console.
Projektu Google Cloud. Może to być ten sam projekt, którego używacie do integracji Google Drive.

Nie widzisz pozycji „Integracje (MCP)" w ustawieniach organizacji? Funkcja musi być najpierw włączona dla Twojej organizacji przez zespół AnyLawyer. Skontaktuj się z nami.

Krok 1: Otwórz stronę integracji w AnyLawyer i skopiuj adres przekierowania

Zaloguj się do AnyLawyer jako administrator.
W menu bocznym rozwiń Administracja, wybierz Ustawienia organizacji, a następnie w sekcji Integracje kliknij Integracje (MCP).
W sekcji Dodaj serwer kliknij kafelek Gmail.
Nad instrukcją zobaczysz ramkę Adres przekierowania OAuth, np. https://anylawyer.com/api/mcp/callback.
Skopiuj ten adres. Będzie potrzebny w Kroku 4 i musi zostać wklejony w Google Cloud Console znak w znak (protokół https://, domena, ścieżka, bez ukośnika na końcu).

Zostaw tę kartę otwartą. Wrócisz do niej w Kroku 5.

Krok 2: Wybierz projekt w Google Cloud Console

Otwórz console.cloud.google.com i na górnym pasku wybierz projekt zapisany do Google Workspace Developer Preview Program.
Jeśli macie już projekt użyty do integracji Google Drive, możesz użyć tego samego. Klient OAuth dla Gmaila będzie osobnym wpisem w tym projekcie.
Jeśli nie masz projektu, utwórz go pod adresem console.cloud.google.com/projectcreate, a potem zapisz do programu Developer Preview.

Krok 3: Włącz Gmail API

W menu konsoli przejdź do APIs & Services → Library.
W polu wyszukiwania wpisz Gmail API i zatwierdź.
Otwórz kartę Gmail API i kliknij Enable. Po chwili przy przycisku pojawi się status API Enabled. Możesz też wejść bezpośrednio pod adres console.cloud.google.com/apis/library/gmail.googleapis.com.

Gmail MCP API nie jest potrzebne. Serwer MCP Google jest dostępny tylko w programie Developer Preview, dlatego AnyLawyer korzysta ze zwykłego Gmail API. Jeśli włączysz Gmail MCP API, nic się nie stanie, ale nie jest to wymagane.

Krok 4: Utwórz klienta OAuth typu Web application

W menu konsoli przejdź do APIs & Services → Credentials (console.cloud.google.com/apis/credentials).
Kliknij + Create credentials → OAuth client ID.
W polu Application type wybierz Web application.
W polu Name wpisz np. AnyLawyer Gmail MCP.
W sekcji Authorized redirect URIs kliknij + Add URI i wklej adres skopiowany w Kroku 1, np.:
```
https://anylawyer.com/api/mcp/callback
```
Adres musi być identyczny co do znaku. Najczęstszy błąd na tym etapie to literówka lub dodatkowy ukośnik na końcu.
Kliknij Create.
Wyświetli się okno OAuth client created z dwiema wartościami:
- Client ID, długi ciąg zakończony na .apps.googleusercontent.com,
- Client secret, krótszy ciąg zaczynający się zwykle od GOCSPX-.
Skopiuj obie wartości od razu. Google pokazuje client secret tylko w tym oknie. Traktuj go jak hasło i nie wysyłaj e-mailem ani na czacie.

Jeśli konfigurujesz ekran zgody OAuth po raz pierwszy w tym projekcie, konsola poprosi Cię najpierw o nazwę aplikacji i adres e-mail wsparcia. Postępuj tak samo jak w przewodniku Konfiguracja Google Drive: w Google Workspace wybierz typ odbiorców Internal, a bez Workspace External i dodaj pracowników jako użytkowników testowych. Na ekranie zgody dodaj zakresy gmail.readonly oraz gmail.compose.

Krok 5: Dodaj Gmaila w AnyLawyer

Wróć do karty AnyLawyer z otwartą stroną Integracje (MCP). Kafelek Gmail powinien być nadal zaznaczony.
W polu Client ID wklej Client ID z Kroku 4.
W polu Client secret wklej Client secret.
Kliknij Dodaj Gmail.
Gmail pojawi się na liście Skonfigurowane serwery z opisem https://gmailmcp.googleapis.com/mcp/v1 · OAuth (zarejestrowany klient).

Od tej chwili integracja jest dostępna dla wszystkich użytkowników organizacji.

Krok 6: Sprawdź, czy działa

Otwórz dowolny projekt w AnyLawyer i rozpocznij rozmowę.
Pod polem wiadomości kliknij ikonę Integracje obok mikrofonu.
Przy pozycji Gmail kliknij Połącz.
Zostaniesz przekierowany na stronę Google. Wybierz konto i kliknij Zezwól / Allow.
Po powrocie do AnyLawyer przy pozycji Gmail pojawi się status Połączono.
Zapytaj asystenta np. „Znajdź ostatnią korespondencję z kancelarią X i streść ustalenia". Asystent użyje narzędzi Gmaila i pokaże, z czego skorzystał.
Asystent odczytuje też załączniki do wiadomości (PDF, DOCX, ODT, XLSX i pliki tekstowe). Możesz poprosić np. „Porównaj umowę z załącznika do maila od X z naszym wzorem".

Każdy użytkownik łączy własną skrzynkę w ten sam sposób. Połączenie można w każdej chwili rozłączyć w tym samym menu.

Najczęstsze problemy

Błąd redirect_uri_mismatch przy łączeniu konta. Adres przekierowania w kliencie OAuth różni się od adresu z Kroku 1. Sprawdź, czy nie ma literówki ani ukośnika na końcu, i zapisz zmiany w konsoli. Google może potrzebować kilku minut, aby nowe ustawienie zaczęło działać.
Google pokazuje błąd access_denied lub „This app is blocked". Aplikacja jest typu External w trybie testowym, a konto użytkownika nie jest na liście użytkowników testowych. Dodaj je na ekranie zgody OAuth albo przełącz aplikację na Internal (Google Workspace).
Po połączeniu asystent zgłasza błąd przy czytaniu poczty. Sprawdź, czy w projekcie jest włączone Gmail API (Krok 3). Błąd Gmail API has not been used in project… oznacza, że nie jest.
Client secret został utracony. W konsoli otwórz Google Auth Platform → Clients, wybierz klienta i dodaj nowy secret. Następnie usuń Gmaila w AnyLawyer i dodaj go ponownie z nowymi danymi.
Chcesz odłączyć integrację dla całej organizacji. Na stronie Integracje (MCP) kliknij ikonę kosza przy pozycji Gmail. Połączenia wszystkich użytkowników zostaną usunięte.