Konfigurowanie serwera MCP Dokumentów

Dokumenty Google oferują zdalny serwer Model Context Protocol (MCP), który umożliwia agentom AI bezpieczną interakcję z danymi Dokumentów Google. Konfigurując serwer MCP Dokumentów Google, umożliwiasz aplikacjom AI, takim jak Google Antigravity i Claude, wykonywanie działań w Dokumentach Google.

Serwer MCP Dokumentów Google 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 Google

Aby korzystać z serwera MCP Dokumentów Google, musisz go włączyć w projekcie w chmurze Google, a następnie skonfigurować klienta MCP, aby się z nim łączył.

Włączanie interfejsów API

Aby korzystać z serwera MCP Dokumentów Google, musisz włączyć 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 Google, musisz włączyć tę usługę w projekcie Google Cloud:

  • Google 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 Google 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 w sekcjach 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 Google:

      • 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 klienta MCP

Aby dodać zdalny serwer MCP Dokumentów Google do klienta MCP, postępuj zgodnie z instrukcjami dotyczącymi klienta.

Identyfikatory klienta OAuth 2.0 delegowane przez użytkownika, które wywołują serwer MCP Dokumentów, muszą mieć wybraną 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 sekcji Google Auth Platform (Platforma uwierzytelniania Google) > Clients (Klienci), zgodnie z opisem 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 Google 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 OAuth 2.0 i klucz tajny:

    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 Utwórz i skopiuj identyfikator klienta oraz 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 identyfikator klienta.
    • OAUTH_CLIENT_SECRET: utworzony 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 Authenticate (Uwierzytelnij), zaloguj się na konto Google, skopiuj kod autoryzacji, wklej go w oknie dialogowym i kliknij Submit (Prześlij).

    • Antigravity CLI:

      1. Uruchom Antigravity CLI:

        agy

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

        /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 Antigravity IDE lub GUI: 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. 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 Google z Claude.ai lub Claude Desktop, musisz mieć abonament Claude Enterprise, Pro, Max lub Team.

Aby dodać zdalny serwer MCP Dokumentów Google do Claude, skonfiguruj niestandardowe oprogramowanie sprzęgające z identyfikatorem klienta OAuth i kluczem tajnym.

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

    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 Utwórz i skopiuj identyfikator klienta oraz 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 dla usługi Dokumenty Google:
      • Nazwa serwera: Google 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 Google wpisz:

  • Nazwa serwera: docs

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

  • Transport: Streamable HTTP

  • Uwierzytelnianie: zdalny serwer MCP Dokumentów Google 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.

Więcej informacji o łączeniu różnych typów klientów znajdziesz w artykule Konfigurowanie MCP w aplikacji AI.

Testowanie serwera MCP Dokumentów Google

Po skonfigurowaniu klienta MCP możesz sprawdzić połączenie, uruchamiając kilka testowych promptów.

Zadaj klientowi korzystającemu z MCP 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 prawidłowo i otrzymasz odpowiednie odpowiedzi, serwer MCP Dokumentów Google jest prawidłowo skonfigurowany.

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 masz 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 delegowanych przez użytkowników

Jeśli żądania wysyłane do serwera MCP są odrzucane, sprawdź, czy identyfikator klienta OAuth 2.0 przekazany przez użytkownika w przypadku 3-etapowego procesu OAuth ma wybraną opcję Użyj tego klienta w przypadku agenta opartego na AI w Google Auth Platform > 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żywaj tego klienta na potrzeby 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 klienta MCP 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 dwuetapowej autoryzacji 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 w ramach przekazywania 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 tokena odświeżania. Serwer OAuth 2.0 Google wydaje token odświeżania tylko wtedy, gdy żądanie autoryzacji zawiera parametr access_type=offline. Żądanie tylko zakresu OpenID Connect (OIDC) offline_access nie zwraca identyfikatora.

Sprawdź, czy klient MCP obsługuje niestandardowe parametry autoryzacji:

  • Klient obsługuje niestandardowe parametry autoryzacji: dodaj access_type=offline do żądania autoryzacji. Aby uzyskać nowy token odświeżania dla użytkownika, który już przyznał dostęp, dodaj też prompt=consent.
  • Klient nie obsługuje niestandardowych parametrów autoryzacji: loguj się ponownie za każdym razem, gdy token dostępu wygaśnie.

Więcej informacji znajdziesz w artykule o odświeżaniu tokena dostępu.

Dokumentacja narzędzia

W przypadku serwera MCP Dokumentów Google dostępne są te narzędzia:

  • read_doc
  • update_doc

Ważna uwaga dotycząca bezpieczeństwa: pośrednie wstrzykiwanie promptów

Gdy udostępniasz modelowi językowemu niezaufane dane, istnieje ryzyko pośredniego ataku polegającego na wstrzykiwaniu promptów. Ponieważ hosty MCP, takie jak Google Antigravity, mają dostęp do zaawansowanych narzędzi i interfejsów API za pośrednictwem serwera MCP Dokumentów Google, 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ć dostarczonego przez Google rozwiązania Model Armor lub własnego rozwiązania, jeśli je udokumentujesz, aby użytkownicy mogli zaakceptować ryzyko. Więcej informacji 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 Google z niezaufanymi lub niezweryfikowanymi aplikacjami.
  • Zachowaj ostrożność w przypadku niezaufanych danych wejściowych. Nie proś klienta MCP o przetwarzanie dokumentów ani innych zasobów z niezweryfikowanych źródeł. Te dane wejściowe mogą zawierać ukryte instrukcje, które mogą przejąć sesję, umożliwiając atakującemu modyfikowanie, kradzież lub usunięcie danych.
  • Sprawdź wszystkie działania. Zawsze dokładnie sprawdzaj działania podejmowane przez klienta AI w Twoim imieniu, aby upewnić się, że są prawidłowe i zgodne z Twoimi intencjami.