Dokumenty udostępniają zdalny serwer Model Context Protocol (MCP), który umożliwia agentom AI bezpieczną interakcję z danymi Dokumentów. Konfigurując serwer MCP Dokumentów, umożliwiasz aplikacjom AI, takim jak Google Antigravity i Claude, wykonywanie działań w Dokumentach.
Serwer MCP Dokumentów zapewnia agentom AI ustandaryzowany sposób:
- Odczytywanie danych: odczytywanie informacji o strukturze dokumentu i treści tekstowej.
- Podejmij działanie: zaktualizuj styl i strukturę dokumentu za pomocą aktualizacji zbiorczych.
- Przestrzeganie zabezpieczeń: dziedziczenie tych samych uprawnień i ustawień zarządzania danymi co użytkownik.
Wymagania wstępne
Udział w programie wersji przedpremierowej Google Workspace dla programistów.
projekt Google Cloud, Aby dowiedzieć się, jak utworzyć projekt, przeczytaj artykuł Tworzenie projektu.
Host MCP, czyli aplikacja AI, taka jak Google Antigravity lub Claude. Aplikacja AI tworzy połączenie klienta MCP dla każdego serwera MCP.
Aby uruchomić polecenia na tej stronie, skonfiguruj gcloud CLI w jednym z tych środowisk programistycznych:
Cloud Shell
Aby użyć terminala online ze skonfigurowanym już gcloud CLI, aktywuj Cloud Shell:
Lokalna powłoka
Aby użyć lokalnego środowiska programistycznego, wykonaj te czynności:
- Zainstaluj Google Cloud CLI.
Jeśli interfejs gcloud CLI został już zainstalowany, upewnij się, że masz najnowszą wersję, uruchamiając polecenie
gcloud components update. - Jeśli korzystasz z zewnętrznego dostawcy tożsamości, zaloguj się w gcloud CLI przy użyciu tożsamości sfederowanej. Więcej informacji znajdziesz w artykule na temat logowania się w gcloud CLI przy użyciu tożsamości sfederowanej.
- Zainicjuj gcloud CLI.
- Zainstaluj Google Cloud CLI.
Jeśli interfejs gcloud CLI został już zainstalowany, upewnij się, że masz najnowszą wersję, uruchamiając polecenie
Konfigurowanie serwera MCP Dokumentów
Aby korzystać z serwera MCP Dokumentów, włącz go w projekcie Google Cloud i skonfiguruj aplikację AI, aby się z nim łączyła.
Włączanie interfejsów API
Aby używać serwera MCP Dokumentów, włącz w projekcie Google Cloud ten interfejs API:
Google Docs API
Interfejs wiersza poleceń
gcloud services enable docs.googleapis.com --project=PROJECT_ID
Zastąp PROJECT_ID identyfikatorem projektu Google Cloud.
Konsola
Włącz interfejsy API w konsoli Google Cloud:
Włączanie usług MCP
Aby włączyć komponenty MCP w Dokumentach, włącz tę usługę w projekcie Google Cloud:
Docs MCP API
Interfejs wiersza poleceń
gcloud services enable docsmcp.googleapis.com --project=PROJECT_ID
Zastąp PROJECT_ID identyfikatorem projektu Google Cloud.
Konsola
Włącz usługi MCP w konsoli Google Cloud:
Konfigurowanie ekranu zgody OAuth
Serwer MCP Dokumentów używa protokołu OAuth 2.0 do uwierzytelniania i autoryzacji. Zanim utworzysz identyfikator klienta OAuth, musisz skonfigurować ekran zgody OAuth.
W konsoli Google Cloud otwórz Google Auth Platform > Marka.
Jeśli masz już skonfigurowaną platformę uwierzytelniania Google, możesz skonfigurować te ustawienia ekranu zgody OAuth: Marka, Odbiorcy i Dostęp do danych. Jeśli zobaczysz komunikat Platforma uwierzytelniania Google nie została jeszcze skonfigurowana, kliknij Rozpocznij:
- W sekcji Informacje o aplikacji w polu Nazwa aplikacji wpisz
Docs MCP Server. - W polu Adres e-mail dla użytkowników potrzebujących pomocy wybierz swój adres e-mail lub odpowiednią grupę dyskusyjną Google.
- Kliknij Dalej.
- W sekcji Odbiorcy wybierz Wewnętrzny. Jeśli nie możesz wybrać opcji Wewnętrzny, wybierz Zewnętrzny.
- Kliknij Dalej.
- W sekcji Informacje kontaktowe wpisz adres e-mail, na który chcesz otrzymywać powiadomienia o zmianach w projekcie.
- Kliknij Dalej.
- W sekcji Finish (Zakończ) zapoznaj się z zasadami dotyczącymi danych użytkownika w usługach interfejsów API Google i jeśli się z nimi zgadzasz, zaznacz pole I agree to the Google API Services: User Data Policy (Akceptuję zasady dotyczące danych użytkownika w usługach interfejsów API Google).
- Kliknij Dalej.
- Kliknij Utwórz.
- Jeśli jako typ użytkownika wybrano Zewnętrzny, dodaj użytkowników testowych:
- Kliknij Odbiorcy.
- W sekcji Użytkownicy testowi kliknij Dodaj użytkowników.
- Wpisz swój adres e-mail i adresy innych autoryzowanych użytkowników testowych, a następnie kliknij Zapisz.
- W sekcji Informacje o aplikacji w polu Nazwa aplikacji wpisz
Kliknij Dostęp do danych > Dodaj lub usuń zakresy. Pojawi się panel z listą zakresów dla każdego interfejsu API włączonego w projekcie Google Cloud.
W sekcji Ręczne dodawanie zakresów wklej zakresy serwera MCP Dokumentów:
https://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/documents.readonlyhttps://www.googleapis.com/auth/documents
Kliknij Dodaj do tabeli.
Kliknij Aktualizuj.
Po wybraniu zakresów wymaganych przez aplikację na stronie Dostęp do danych kliknij Zapisz.
Konfigurowanie aplikacji AI
Aby dodać zdalny serwer MCP Dokumentów do aplikacji AI, postępuj zgodnie z instrukcjami dotyczącymi aplikacji.
Identyfikatory klienta OAuth 2.0 delegowane przez użytkownika, które wywołują serwer MCP Dokumentów, muszą mieć zaznaczoną opcję Używaj tego klienta w przypadku agenta opartego na AI w sekcji Platforma uwierzytelniania Google > Klienci. Aby zaktualizować istniejący identyfikator klienta OAuth 2.0, wybierz to ustawienie w Google Auth Platform > Clients (Klienci), jak opisano w artykule Zarządzanie klientami OAuth. Jeśli nie możesz zmienić tego ustawienia na istniejącym kliencie lub jeśli klient obsługuje też funkcje inne niż agent, utwórz nowy identyfikator klienta OAuth 2.0 dla agenta AI. Informacje o odrzuconych prośbach, kontach usługi z przekazywaniem dostępu w całej domenie i Google Apps Script znajdziesz w sekcji Rozwiązywanie problemów.
Antigravity
Aby dodać zdalny serwer MCP Dokumentów do Antigravity, dodaj konfigurację serwera do pliku mcp_config.json. Te instrukcje dotyczą Antigravity 2.0, Antigravity IDE i Antigravity CLI.
Utwórz identyfikator klienta i tajny klucz OAuth 2.0:
W konsoli Google Cloud otwórz Google Auth Platform > Klienci > Utwórz klienta.
Jako typ aplikacji wybierz Aplikacja internetowa.
Wpisz nazwę.
W sekcji Autoryzowane identyfikatory URI przekierowania kliknij + Dodaj URI, a następnie dodaj
https://antigravity.google/oauth-callbackw polu Identyfikatory URI.Wybierz Używaj tego klienta w przypadku agenta opartego na AI.
Kliknij Create (Utwórz) i skopiuj wartości Client ID (Identyfikator klienta) i Client Secret (Tajny klucz klienta).
Otwórz lub utwórz plik konfiguracji
~/.gemini/config/mcp_config.json.Dodaj konfigurację
mcpServersdomcp_config.json:{ "mcpServers": { "docs": { "serverUrl": "https://docsmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } } } }Zastąp te elementy:
OAUTH_CLIENT_ID: utworzony przez Ciebie identyfikator klienta.OAUTH_CLIENT_SECRET: utworzony przez Ciebie tajny klucz klienta.
Zaoszczędź
mcp_config.json.Uwierzytelnij serwer MCP. Uwierzytelnianie możesz przeprowadzić za pomocą ustawień GUI lub interfejsu wiersza poleceń:
W przypadku Antigravity IDE lub GUI (Antigravity 2.0):
- Otwórz ekran ustawień (np. kliknij Ustawienia w lewym dolnym rogu lub otwórz Ustawienia użytkownika Antigravity).
- Kliknij Dostosowania.
- W sekcji Zainstalowane serwery MCP kliknij Odśwież.
- Znajdź na liście
docs, kliknij Uwierzytelnij, zaloguj się na konto Google, skopiuj kod autoryzacji, wklej go w oknie dialogowym i kliknij Prześlij.
Antigravity CLI:
Uruchom Antigravity CLI:
agyOtwórz interaktywny panel zarządzania MCP, uruchamiając:
/mcpUżyj klawiszy strzałek, aby wybrać
docs, przejdź do działania Uwierzytelnij i naciśnij Enter. Dokończ proces logowania w przeglądarce, skopiuj kod autoryzacji, wklej go w wierszu poleceń terminala i naciśnij Enter.
Sprawdź, czy serwer jest prawidłowo skonfigurowany i działa:
- W przypadku interfejsu GUI lub Antigravity IDE: przycisk Wyloguj się jest wyświetlany obok serwera w sekcji Dostosowania > Zainstalowane serwery MCP.
- W przypadku Antigravity CLI: otwórz panel
/mcp, aby wyświetlić skonfigurowane serwery MCP. Zweryfikowane i uwierzytelnione serwery mają obok nazwy w interaktywnym panelu TUI oznaczenie Authed (Uwierzytelniony). Możesz wybrać dowolny serwer w widoku panelu, aby sprawdzić jego stan i wyświetlić listę wszystkich dostępnych narzędzi.
Zdalny serwer MCP jest gotowy do użycia w Antigravity.
Claude
Aby używać zdalnego serwera MCP Dokumentów z Claude.ai lub Claude Desktop, musisz mieć abonament Claude Enterprise, Pro, Max lub Team.
Aby dodać zdalny serwer MCP Dokumentów do Claude, skonfiguruj niestandardowe oprogramowanie sprzęgające z identyfikatorem klienta OAuth i kluczem tajnym.
Utwórz identyfikator klienta i tajny klucz OAuth 2.0:
W konsoli Google Cloud otwórz Google Auth Platform > Klienci > Utwórz klienta.
Jako typ aplikacji wybierz Aplikacja internetowa.
Wpisz nazwę.
W sekcji Autoryzowane identyfikatory URI przekierowania kliknij + Dodaj URI, a następnie dodaj
https://claude.ai/api/mcp/auth_callbackw polu Identyfikatory URI.Wybierz Używaj tego klienta w przypadku agenta opartego na AI.
Kliknij Create (Utwórz) i skopiuj wartości Client ID (Identyfikator klienta) i Client Secret (Tajny klucz klienta).
Skonfiguruj serwer MCP w Claude:
- W Claude.ai lub Claude Desktop otwórz Ustawienia > Oprogramowanie sprzęgające lub Ustawienia administratora > Oprogramowanie sprzęgające.
- Kliknij Dodaj oprogramowanie sprzęgające niestandardowe.
- Wpisz szczegóły połączenia z usługą Dokumenty:
- Nazwa serwera:
Docs. - URL zdalnego serwera MCP:
https://docsmcp.googleapis.com/mcp/v1
- Nazwa serwera:
- W sekcji Ustawienia zaawansowane wpisz Identyfikator klienta OAuth i Tajny klucz klienta OAuth.
- Kliknij Dodaj.
Inne
Wiele aplikacji AI ma sposoby łączenia się ze zdalnym serwerem MCP. Zwykle musisz podać szczegóły dotyczące serwera, takie jak jego nazwa, punkty końcowe, protokół transportowy i metoda uwierzytelniania. W przypadku zdalnego serwera MCP Dokumentów wpisz:
Nazwa serwera:
docsURL serwera:
https://docsmcp.googleapis.com/mcp/v1Transport: Streamable HTTP
Uwierzytelnianie: zdalny serwer MCP Dokumentów używa protokołu OAuth 2.0. Podczas tworzenia klienta OAuth 2.0 wybierz Używaj tego klienta w przypadku agenta opartego na AI. Szczegółowe informacje znajdziesz w artykule Informacje o uwierzytelnianiu i autoryzacji.
Aby uniknąć wyświetlania co godzinę prośby o zalogowanie się w przypadku klienta OAuth aplikacji internetowej, skonfiguruj klienta MCP tak, aby prosił o dostęp offline za pomocą zakresu
access_type=offlineluboffline_access. Więcej informacji znajdziesz w sekcji Powtarzające się co godzinę prośby o zalogowanie się.
Więcej informacji o łączeniu różnych typów aplikacji opartych na AI znajdziesz w artykule Konfigurowanie MCP w aplikacji opartej na AI.
Testowanie serwera MCP Dokumentów
Po skonfigurowaniu aplikacji AI możesz sprawdzić połączenie, uruchamiając kilka testowych promptów.
Spróbuj zadać aplikacji AI te pytania:
„Pokaż mi zawartość strukturalną dokumentu Google
abcd123”.Klient pobiera strukturę i zawartość dokumentu za pomocą
docs.read_doc.„Wstaw tytuł »Mój plan marketingowy« do dokumentu Google
abcd123”.Klient wykonuje
docs.update_doc, aby zaktualizować elementy strukturalne i wstawić tekst.
Jeśli narzędzia zostaną wykonane pomyślnie i otrzymasz odpowiednie odpowiedzi, serwer MCP Dokumentów jest skonfigurowany prawidłowo.
Rozwiązywanie problemów
W sekcjach poniżej znajdziesz informacje o rozwiązywaniu typowych problemów z uwierzytelnianiem i połączeniem z serwerem MCP Dokumentów.
Sprawdzanie zdarzeń z dziennika OAuth
Jeśli wystąpią problemy z połączeniem z serwerem MCP, sprawdź, czy w logach OAuth nie ma błędów. Poproś administratora Google Workspace o sprawdzenie zdarzeń z dziennika OAuth w narzędziu do analizy zagrożeń.
Odrzucone żądania od klientów OAuth z delegowaniem przez użytkownika
Jeśli żądania wysyłane do serwera MCP są odrzucane, sprawdź, czy identyfikator klienta OAuth 2.0 delegowany przez użytkownika dla 3-etapowego procesu OAuth ma wybraną opcję Użyj tego klienta dla agenta opartego na AI w sekcji Platforma uwierzytelniania Google > Klienci:
- Dotychczasowy klient obsługuje to ustawienie: w przypadku dotychczasowego klienta OAuth wybierz Używaj tego klienta w przypadku agenta opartego na AI.
- Nie można zaktualizować istniejącego klienta: utwórz nowego klienta OAuth z zaznaczoną opcją Użyj tego klienta w przypadku agenta opartego na AI i zaktualizuj aplikację, aby go używała.
- Istniejący klient obsługuje też funkcje niezwiązane z agentem: utwórz osobnego klienta OAuth dla agenta AI i zachowaj istniejącego klienta dla funkcji niezwiązanych z agentem.
Instrukcje znajdziesz w artykułach Konfigurowanie aplikacji AI i Zarządzanie klientami OAuth.
Konta usługi korzystające z przekazywania dostępu w całej domenie
Jeśli Twoja aplikacja używa konta usługi z przekazywaniem dostępu w całej domenie na potrzeby dwuetapowego protokołu OAuth, nie możesz wybrać opcji Użyj tego klienta w przypadku agenta opartego na AI, ponieważ konta usługi nie są zarządzane w Google Auth Platform > Klienci:
- Kontrola dostępu: żądania wysyłane do serwera MCP z tych kont usługi nie są odrzucane z powodu braku ustawienia agenta. Dostęp jest kontrolowany przez ustawienia przekazywania dostępu w całej domenie, którymi zarządza administrator Google Workspace. Szczegółowe informacje o ustawieniach administratora znajdziesz w artykule Kontrola dostępu do interfejsów API przy użyciu przekazywania dostępu w całej domenie.
- Działania dotyczące poufnych danych: serwery MCP Google Workspace nadal zwracają prośby o wypełnienie formularza w celu potwierdzenia przez człowieka wywołań narzędzi dotyczących poufnych danych, które zostały wykonane przez przyjęcie tożsamości użytkownika z przekazaniem dostępu w całej domenie.
Żądania z Apps Script
Jeśli wywołujesz serwer MCP z Apps Script, nie możesz wybrać opcji Używaj tego klienta w przypadku agenta opartego na AI w domyślnym kliencie OAuth, który Apps Script tworzy i którym zarządza na potrzeby Twojego skryptu. Dotyczy to również sytuacji, gdy skrypt używa standardowego projektu Google Cloud.
Aby wywołać serwer MCP z Apps Script, wykonaj te czynności:
- W konsoli Google Cloud otwórz Google Auth Platform > Klienci, utwórz klienta OAuth i wybierz Użyj tego klienta w przypadku agenta opartego na AI.
- W skrypcie użyj biblioteki OAuth2 dla Apps Script, aby autoryzować użytkowników za pomocą tego klienta OAuth.
- Gdy wywołujesz serwer MCP, wyślij token dostępu zwracany przez bibliotekę, a nie token z
ScriptApp.getOAuthToken.
Nie dotyczy to projektów Apps Script, które nie wywołują serwerów MCP Google Workspace.
Powtarzające się co godzinę prośby o zalogowanie się
Jeśli co godzinę pojawia się prośba o ponowne zalogowanie, klient MCP nie otrzymuje lub nie używa tokena odświeżania. Zwykle dzieje się tak w tych sytuacjach:
- Brak dostępu offline w przypadku klienta OAuth aplikacji internetowej: w przeciwieństwie do klientów OAuth aplikacji komputerowej klienci OAuth aplikacji internetowej domyślnie mają dostęp online. Aby poprosić o token odświeżania, dołącz
access_type=offlinelub zakres OpenID Connect (OIDC)offline_accesswraz z co najmniej jednym zakresem interfejsu API i nie ustawiajaccess_type=online. - Ponowne autoryzowanie aplikacji, która ma już zgodę: serwer OAuth 2.0 Google wydaje token odświeżania, gdy użytkownik po raz pierwszy przyznaje dostęp offline. Jeśli użytkownik autoryzował już klienta OAuth bez dostępu offline lub jeśli klient MCP utracił zapisany token odświeżania, kolejne logowania mogą nie zwrócić nowego tokena odświeżania. Uwzględnij
prompt=consentw prośbie o autoryzację lub usuń dostęp aplikacji w połączeniach z kontem Google i zaloguj się ponownie. - Statyczny token okaziciela: jeśli przekazujesz nieprzetworzony token dostępu w nagłówku
Authorization, np. dane wyjściowe zgcloud auth print-access-token, token wygasa po godzinie, chyba że klient go odświeży.
Więcej informacji znajdziesz w artykule Odświeżanie tokena dostępu.
Dokumentacja narzędzia
W przypadku serwera MCP Dokumentów dostępne są te narzędzia. Schematy wejściowe i wyjściowe znajdziesz w dokumentacji MCP Dokumentów:
Ważna uwaga dotycząca bezpieczeństwa: pośrednie wstrzykiwanie promptów
Gdy udostępniasz model językowy niezaufanym danym, istnieje ryzyko pośredniego ataku typu „wstrzykiwanie promptów”. Aplikacje AI takie jak Google Antigravity mają dostęp do zaawansowanych narzędzi i interfejsów API przez serwer MCP Dokumentów, więc mogą odczytywać, modyfikować i usuwać dane na Twoim koncie Google.
Aby ograniczyć te zagrożenia, musisz sprawdzać prompty i odpowiedzi pod kątem szkodliwych treści lub ataków typu „wstrzykiwanie promptów”. Możesz użyć udostępnionego przez Google rozwiązania Model Armor lub własnego rozwiązania, jeśli je udokumentujesz, aby użytkownicy mogli zaakceptować ryzyko. Instrukcje znajdziesz w artykule Konfigurowanie zabezpieczeń serwerów MCP Google Workspace.
Zastosuj te sprawdzone metody:
- Korzystaj tylko z zaufanych narzędzi. Nigdy nie łącz serwera MCP Dokumentów z niezaufanymi lub niezweryfikowanymi aplikacjami.
- Zachowaj ostrożność w przypadku niezaufanych danych wejściowych. Unikaj proszenia aplikacji AI o przetwarzanie dokumentów lub innych zasobów z niezweryfikowanych źródeł. Te dane wejściowe mogą zawierać ukryte instrukcje, które mogą przejąć sesję i umożliwić atakującemu modyfikowanie, kradzież lub usunięcie danych.
- Przejrzyj wszystkie działania. Zawsze dokładnie sprawdzaj działania podejmowane przez aplikację AI w Twoim imieniu, aby upewnić się, że są one prawidłowe i zgodne z Twoimi intencjami.