Konfigurowanie serwera MCP Prezentacji

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

Serwer MCP Prezentacji Google zapewnia agentom AI standardowy sposób na:

  • odczytywanie danych: odczytywanie werbalizowanych struktur, stylów i układów prezentacji;
  • podejmowanie działań: zmienianie układów, slajdów i elementów oraz wykonywanie wsadowych aktualizacji struktury wizualnej;
  • zachowanie bezpieczeństwa: dziedziczenie tych samych uprawnień i kontroli zarządzania danymi co użytkownik.

Wymagania wstępne

  • Projekt Google Cloud. Aby utworzyć projekt, przeczytaj artykuł Tworzenie projektu.

  • Klient MCP, np. Google Antigravity.

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

    Cloud Shell

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

    Aktywuj Cloud Shell

    Powłoka lokalna

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

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

Konfigurowanie serwera MCP Prezentacji Google

Aby używać serwera MCP Prezentacji Google, musisz go włączyć w projekcie Google Cloud, a następnie skonfigurować klienta MCP tak, aby się z nim łączył.

Włączanie interfejsów API

Aby używać serwera MCP Prezentacji Google, musisz włączyć w projekcie Google Cloud ten interfejs API:

  • Google Slides API

CLI

gcloud services enable slides.googleapis.com --project=PROJECT_ID

Zastąp PROJECT_ID identyfikatorem projektu Google Cloud.

Konsola

Włącz interfejsy API w konsoli Google Cloud:

Włącz interfejsy API

Włączanie usług MCP

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

  • Google Slides MCP API

CLI

gcloud services enable slidesmcp.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 Prezentacji 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 Platforma uwierzytelniania Google > Elementy marki.

    Przejdź na stronę Elementy marki

  2. Jeśli Platforma uwierzytelniania Google jest już skonfigurowana, możesz skonfigurować te ustawienia ekranu zgody OAuth w sekcjach Elementy marki, 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 Slides MCP Server.
    2. W polu E-mail pomocy dla użytkowników 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 chcesz 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 i jeśli je akceptujesz, zaznacz pole 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 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 e-mail 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 dla serwera MCP Prezentacji Google:

      • https://www.googleapis.com/auth/drive.readonly
      • https://www.googleapis.com/auth/presentations.readonly

    2. Kliknij Dodaj do tabeli.

    3. Kliknij Aktualizuj.

    4. Po wybraniu zakresów wymaganych przez aplikację kliknij Zapisz na stronie Dostęp do danych.

Konfigurowanie klienta MCP

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

Antigravity

Aby dodać zdalny serwer MCP Prezentacji 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 OAuth 2.0:

    1. W konsoli Google Cloud otwórz Platforma uwierzytelniania Google > 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 pliku mcp_config.json:

    {
  "mcpServers": {
    "slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

    Zastąp następujące elementy:

    • OAUTH_CLIENT_ID: utworzony identyfikator klienta.
    • OAUTH_CLIENT_SECRET: utworzony tajny klucz klienta.

  4. Zapisz plik mcp_config.json.

  5. Uwierzytelnij serwer MCP. Możesz uwierzytelnić się 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. Otwórz Dostosowania.
      3. W sekcji Zainstalowane serwery MCP kliknij Odśwież.
      4. Znajdź slides na liście, 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 Antigravity CLI:

        agy

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

        /mcp

      3. Za pomocą klawiszy strzałek wybierz slides, przejdź do działania Uwierzytelnij i naciśnij Enter. Zakoń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 Dostosowania > 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 wyświetlają obok swoich nazw w interaktywnym panelu TUI napis 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 Prezentacji Google z Claude.ai lub Claude Desktop, musisz mieć abonament Claude Enterprise, Pro, Max lub Team.

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

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

    1. W konsoli Google Cloud otwórz Platforma uwierzytelniania Google > 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 otwórz Ustawienia (lub Ustawienia administratora) > Oprogramowanie sprzęgające.
    2. Kliknij Dodaj niestandardowe oprogramowanie sprzęgające.
    3. Wpisz szczegóły połączenia z Prezentacjami Google:
      • Nazwa serwera: Google Slides.
      • Adres URL zdalnego serwera MCP: https://slidesmcp.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 sposoby łączenia się ze zdalnym serwerem MCP. Zazwyczaj trzeba wpisać szczegóły dotyczące serwera, takie jak jego nazwa, punkty końcowe, protokół transportowy i metoda uwierzytelniania. W przypadku zdalnego serwera MCP Prezentacji Google wpisz te informacje:

  • Nazwa serwera: slides

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

  • Transport: HTTP

  • Uwierzytelnianie: zdalny serwer MCP Prezentacji Google używa protokołu OAuth 2.0. Więcej informacji 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 Prezentacji Google

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

Zadaj klientowi MCP te pytania:

  • „Pokaż mi werbalizowany układ prezentacji Google abcd123”.

    Klient pobiera struktury układu wizualnego prezentacji za pomocą slides.read_presentation.

  • „Zduplikuj slajd o indeksie 1 w prezentacji Google abcd123”.

    Klient wykonuje slides.update_presentation, aby skopiować stronę.

Jeśli narzędzia działają prawidłowo i otrzymujesz odpowiednie odpowiedzi, serwer MCP Prezentacji Google jest prawidłowo skonfigurowany.

Rozwiązywanie problemów

Jeśli masz problemy z połączeniem z serwerem MCP, możesz sprawdzić, czy w dziennikach OAuth nie ma błędów. Poproś administratora, aby sprawdził zdarzenia z dziennika OAuth w narzędziu do analizy zagrożeń.

Informacje o narzędziach

W przypadku serwera MCP Prezentacji Google dostępne są te narzędzia:

  • read_presentation
  • update_presentation

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

Gdy udostępniasz model językowy niezaufanym danym, istnieje ryzyko ataku polegającego na pośrednim wstrzykiwaniu promptów. Ponieważ klienci MCP, tacy jak Google Antigravity, mają dostęp do zaawansowanych narzędzi i interfejsów API za pomocą serwera MCP Prezentacji Google, mogą odczytywać, modyfikować i usuwać dane na Twoim koncie Google.

Aby zmniejszyć to ryzyko, postępuj zgodnie z tymi sprawdzonymi metodami:

  • Używaj tylko zaufanych narzędzi. Nigdy nie łącz serwera MCP Prezentacji Google z niezaufanymi lub niezweryfikowanymi aplikacjami.
  • Zachowaj ostrożność w przypadku niezaufanych danych wejściowych. Nie proś klienta MCP o przetwarzanie prezentacji 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 usuwanie danych.
  • Sprawdzaj 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.