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 standardowy sposób na:

  • Odczytywanie danych: odczytywanie informacji strukturalnych i treści tekstowych dokumentu.
  • Podejmij działanie: zaktualizuj styl i strukturę dokumentu za pomocą aktualizacji zbiorczych.
  • Przestrzeganie zasad bezpieczeństwa: dziedziczenie tych samych uprawnień i ustawień zarządzania danymi co użytkownik.

Wymagania wstępne

  • Projekt Google Cloud. Informacje o tworzeniu projektu znajdziesz w artykule Tworzenie projektu.

  • Host MCP, np. Google Antigravity.

  • Aby uruchomić polecenia na tej stronie, skonfiguruj gcloud CLI w jednym z tych środowisk programistycznych:

    Cloud Shell

    Aby użyć terminala online z już skonfigurowanym gcloud CLI, aktywuj Cloud Shell:

    Aktywuj Cloud Shell

    Powłoka lokalna

    Aby użyć lokalnego środowiska programistycznego, wykonaj te czynności:

    1. Zainstaluj Google Cloud CLI. Jeśli interfejs gcloud CLI został już zainstalowany, upewnij się, że masz najnowszą wersję, uruchamiając polecenie gcloud components update.
    2. Jeśli korzystasz z zewnętrznego dostawcy tożsamości, zaloguj się w interfejsie wiersza poleceń gcloud za pomocą tożsamości sfederowanej. Więcej informacji znajdziesz w artykule Logowanie się w gcloud CLI przy użyciu tożsamości sfederowanej.
    3. Zainicjuj gcloud CLI.

Konfigurowanie serwera MCP Dokumentów Google

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

Włączanie interfejsów API

Aby korzystać z serwera MCP Dokumentów Google, musisz włączyć w swoim projekcie w chmurze Google 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łącz usługi MCP

Aby włączyć komponenty MCP w Dokumentach Google, musisz włączyć w projekcie Google Cloud tę usługę:

  • 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łącz usługi 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 > Branding.

    Przejdź do sekcji Elementy marki

  2. Jeśli platforma uwierzytelniania Google została już skonfigurowana, możesz skonfigurować te ustawienia ekranu zgody OAuth: Branding, 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 sekcji 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 Dane kontaktowe wpisz adres e-mail, na który będziesz otrzymywać powiadomienia o zmianach w projekcie.
    7. Kliknij Dalej.
    8. W sekcji Zakończ zapoznaj się z zasadami dotyczącymi danych użytkownika w usługach interfejsu API Google. Jeśli je akceptujesz, wybierz Akceptuję zasady dotyczące danych użytkownika w usługach interfejsu API Google.
    9. Kliknij Dalej.
    10. Kliknij Utwórz.
    11. Jeśli jako typ użytkownika wybierzesz 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 e-mail innych autoryzowanych testerów, 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 dla 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 Twojego klienta.

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 i tajny klucz klienta 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. Kliknij Utwórz i skopiuj Identyfikator klienta oraz Tajny klucz klienta.

  2. Otwórz lub utwórz plik konfiguracji ~/.gemini/antigravity/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ń interfejsu 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 Dostosowywanie.
      3. W sekcji Zainstalowane serwery MCP kliknij Odśwież.
      4. Na liście znajdź docs, kliknij Uwierzytelnij, zaloguj się na konto Google, skopiuj kod autoryzacji, wklej go w oknie dialogowym i kliknij Prześlij.

    • W przypadku Antigravity CLI:

      1. Uruchom interfejs wiersza poleceń Antigravity:

        agy

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

        /mcp

      3. Za pomocą klawiszy strzałek wybierz 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: obok serwera w sekcji Dostosowywanie > Zainstalowane serwery MCP wyświetla się przycisk Wyloguj się.
    • W przypadku Antigravity CLI: otwórz panel /mcp, aby wyświetlić skonfigurowane serwery MCP. Zweryfikowane i uwierzytelnione serwery mają obok swoich nazw w interaktywnym panelu TUI wyświetlany tekst Authed. W widoku panelu możesz wybrać dowolny serwer, 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 korzystać z serwera MCP Dokumentów Google z Claude.ai lub Claude Desktop, musisz mieć subskrypcję Claude Enterprise, Pro, Max lub Team.

Aby dodać do Claude zdalny serwer MCP Dokumentów Google, skonfiguruj niestandardowe złącze z identyfikatorem i tajnym kluczem klienta OAuth.

  1. Utwórz identyfikator klienta i tajny klucz klienta 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. Kliknij Utwórz i skopiuj Identyfikator klienta oraz Tajny klucz klienta.

  2. Skonfiguruj serwer MCP w Claude:

    1. W Claude.ai lub Claude Desktop kliknij Ustawienia (lub Ustawienia administratora) > Łączniki.
    2. Kliknij Dodaj niestandardowe oprogramowanie sprzęgające.
    3. Wpisz szczegóły połączenia z usługą Dokumenty Google:
      • Nazwa serwera: Google Docs
      • Adres URL zdalnego serwera MCP: https://docsmcp.googleapis.com/mcp/v1
    4. W Ustawieniach zaawansowanych wpisz identyfikator klienta OAuth i tajny klucz klienta OAuth.
    5. Kliknij Dodaj.

Inne

Wiele aplikacji AI ma możliwość łączenia się ze zdalnym serwerem MCP. Zazwyczaj 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

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

  • Transport: HTTP

  • Uwierzytelnianie: zdalny serwer MCP Dokumentów Google korzysta z protokołu OAuth 2.0. Więcej informacji znajdziesz w artykule Uwierzytelnianie i autoryzacja.

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 MCP te pytania:

  • „Pokaż mi strukturę dokumentu Google abcd123”.

    Klient pobiera strukturę i zawartość dokumentu za pomocą funkcji 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ą uruchomione prawidłowo i otrzymasz odpowiednie odpowiedzi, serwer MCP Dokumentów Google jest prawidłowo skonfigurowany.

Rozwiązywanie problemów

Jeśli wystąpią problemy z połączeniem z serwerem MCP, możesz sprawdzić błędy w logach OAuth. Poproś administratora o sprawdzenie zdarzeń z dziennika OAuth w narzędziu do analizy zagrożeń.

Odwołanie do narzędzia

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

  • read_doc
  • update_doc

Ważna kwestia bezpieczeństwa: pośrednie wstrzykiwanie promptów

Gdy udostępniasz modelowi językowemu dane, którym nie ufasz, 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 złośliwych treści lub ataków typu prompt injection. Możesz użyć dostarczonego przez Google rozwiązania Model Armor lub własnego rozwiązania, jeśli udokumentujesz je w taki sposób, aby użytkownicy mogli zaakceptować to ryzyko. Więcej informacji znajdziesz w artykule Konfigurowanie zabezpieczeń serwerów MCP Google Workspace.

Postępuj zgodnie z tymi sprawdzonymi metodami:

  • Używaj tylko zaufanych narzędzi. Nigdy nie łącz serwera MCP Dokumentów Google z niezaufanymi lub niezweryfikowanymi aplikacjami.
  • Uważaj na niezaufane dane wejściowe. Nie proś klienta MCP o przetwarzanie dokumentów ani innych zasobów pochodzących z niezweryfikowanych źródeł. Te dane wejściowe mogą zawierać ukryte instrukcje, które mogą przejąć Twoją sesję, umożliwiając atakującemu modyfikowanie, kradzież lub usuwanie Twoich danych.
  • Sprawdź wszystkie działania. Zawsze dokładnie sprawdzaj działania podejmowane przez klienta AI w Twoim imieniu, aby upewnić się, że są one prawidłowe i zgodne z Twoimi intencjami.