Konfigurowanie serwera MCP Dokumentów Google

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

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 interfejsów API

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:

Włączanie usług MCP

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.

  1. W konsoli Google Cloud otwórz Google Auth Platform > Marka.

    Przejdź na stronę Elementy marki

  2. 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:

    1. W sekcji Informacje o aplikacji w polu Nazwa aplikacji wpisz Docs MCP Server.
    2. W polu Adres e-mail dla użytkowników potrzebujących pomocy wybierz swój adres e-mail lub odpowiednią grupę dyskusyjną Google.
    3. Kliknij Dalej.
    4. W sekcji Odbiorcy wybierz Wewnętrzny. Jeśli nie możesz wybrać opcji Wewnętrzny, wybierz Zewnętrzny.
    5. Kliknij Dalej.
    6. W sekcji Informacje kontaktowe wpisz adres e-mail, na który chcesz otrzymywać powiadomienia o zmianach w projekcie.
    7. Kliknij Dalej.
    8. 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).
    9. Kliknij Dalej.
    10. Kliknij Utwórz.
    11. Jeśli jako typ użytkownika wybrano Zewnętrzny, dodaj użytkowników testowych:
      1. Kliknij Odbiorcy.
      2. W sekcji Użytkownicy testowi kliknij Dodaj użytkowników.
      3. Wpisz swój adres e-mail i adresy innych autoryzowanych użytkowników testowych, a następnie kliknij Zapisz.
  3. 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.

    1. W sekcji Ręczne dodawanie zakresów wklej zakresy serwera MCP Dokumentów:

      • https://www.googleapis.com/auth/drive.readonly
      • https://www.googleapis.com/auth/drive.file
      • https://www.googleapis.com/auth/documents.readonly
      • https://www.googleapis.com/auth/documents
    2. Kliknij Dodaj do tabeli.

    3. Kliknij Aktualizuj.

    4. 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.

  1. Utwórz identyfikator klienta i tajny klucz OAuth 2.0:

    1. W konsoli Google Cloud otwórz Google Auth Platform > Klienci > Utwórz klienta.

      Otwórz stronę Utwórz klienta

    2. Jako typ aplikacji wybierz Aplikacja internetowa.

    3. Wpisz nazwę.

    4. W sekcji Autoryzowane identyfikatory URI przekierowania kliknij + Dodaj URI, a następnie dodaj https://antigravity.google/oauth-callback w polu Identyfikatory URI.

    5. Wybierz Używaj tego klienta w przypadku agenta opartego na AI.

    6. Kliknij Create (Utwórz) i skopiuj wartości Client ID (Identyfikator klienta) i Client Secret (Tajny klucz klienta).

  2. Otwórz lub utwórz plik konfiguracji ~/.gemini/config/mcp_config.json.

  3. Dodaj konfigurację mcpServers do mcp_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.
  4. Zaoszczędź mcp_config.json.

  5. Uwierzytelnij serwer MCP. Uwierzytelnianie możesz przeprowadzić za pomocą ustawień GUI lub interfejsu wiersza poleceń:

    • W przypadku Antigravity IDE lub GUI (Antigravity 2.0):

      1. Otwórz ekran ustawień (np. kliknij Ustawienia w lewym dolnym rogu lub otwórz Ustawienia użytkownika Antigravity).
      2. Kliknij Dostosowania.
      3. W sekcji Zainstalowane serwery MCP kliknij Odśwież.
      4. 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:

      1. Uruchom Antigravity CLI:

        agy
        
      2. Otwórz interaktywny panel zarządzania MCP, uruchamiając:

        /mcp
        
      3. Uż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.

  6. 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.

  1. Utwórz identyfikator klienta i tajny klucz OAuth 2.0:

    1. W konsoli Google Cloud otwórz Google Auth Platform > Klienci > Utwórz klienta.

      Otwórz stronę Utwórz klienta

    2. Jako typ aplikacji wybierz Aplikacja internetowa.

    3. Wpisz nazwę.

    4. W sekcji Autoryzowane identyfikatory URI przekierowania kliknij + Dodaj URI, a następnie dodaj https://claude.ai/api/mcp/auth_callback w polu Identyfikatory URI.

    5. Wybierz Używaj tego klienta w przypadku agenta opartego na AI.

    6. Kliknij Create (Utwórz) i skopiuj wartości Client ID (Identyfikator klienta) i Client Secret (Tajny klucz klienta).

  2. Skonfiguruj serwer MCP w Claude:

    1. W Claude.ai lub Claude Desktop otwórz Ustawienia > Oprogramowanie sprzęgające lub Ustawienia administratora > Oprogramowanie sprzęgające.
    2. Kliknij Dodaj oprogramowanie sprzęgające niestandardowe.
    3. Wpisz szczegóły połączenia z usługą Dokumenty:
      • Nazwa serwera: Docs.
      • URL zdalnego serwera MCP: https://docsmcp.googleapis.com/mcp/v1
    4. W sekcji Ustawienia zaawansowane wpisz Identyfikator klienta OAuth i Tajny klucz klienta OAuth.
    5. 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: docs

  • URL serwera: https://docsmcp.googleapis.com/mcp/v1

  • Transport: 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=offline lub offline_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:

  1. 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.
  2. W skrypcie użyj biblioteki OAuth2 dla Apps Script, aby autoryzować użytkowników za pomocą tego klienta OAuth.
  3. 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=offline lub zakres OpenID Connect (OIDC) offline_access wraz z co najmniej jednym zakresem interfejsu API i nie ustawiaj access_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=consent w 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 z gcloud 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.