MCP Server w gws – Google Workspace jako narzędzie dla każdego AI

Model Context Protocol to standard, który pozwala AI korzystać z zewnętrznych narzędzi. Zamiast tylko odpowiadać na pytania, AI może wykonywać akcje – szukać plików, wysyłać wiadomości, zarządzać kalendarzem.

gws mcp zamienia całe Google Workspace w zestaw takich narzędzi. Bez jednej linii kodu integracyjnego.

1. Co to jest MCP?
2. gws mcp – Google Workspace jako serwer MCP
3. Konfiguracja krok po kroku
4. Zarządzanie liczbą narzędzi
5. Klienci MCP kompatybilni z gws
6. Praktyczne zastosowania

Co to jest MCP?

Model Context Protocol (MCP) to otwarty standard stworzony przez Anthropic. Definiuje, jak aplikacje AI mogą bezpiecznie korzystać z zewnętrznych narzędzi i źródeł danych.

MCP definiuje trzy typy integracji:

• Tools – akcje, które AI może wykonać (wyślij wiadomość, utwórz plik)
• Resources – dane, które AI może odczytać (zawartość pliku, lista wydarzeń)
• Prompts – gotowe szablony promptów dla specyficznych zadań

Zamiast budować osobną integrację dla każdego AI (Claude, Gemini, ChatGPT, OpenClaw), tworzysz jeden serwer MCP – i działa z każdym klientem MCP.

gws mcp – Google Workspace jako serwer MCP

Google Workspace CLI ma wbudowany serwer MCP. Jedno polecenie uruchamia pełny serwer, który udostępnia wybrane serwisy Google jako narzędzia dla AI.

gws mcp -s drive,gmail,calendar

To wszystko. Agent AI może teraz:

• Szukać i pobierać pliki z Drive
• Czytać i wysyłać wiadomości przez Gmail
• Sprawdzać i tworzyć wydarzenia w Calendar

Dynamiczne generowanie narzędzi

gws mcp nie ma statycznej listy narzędzi. Przy starcie odpytuje Google Discovery Service i dynamicznie generuje narzędzia na podstawie aktualnego API. Gdy Google doda nową funkcję – pojawi się automatycznie.

# Sprawdź dostępne narzędzia
gws mcp -s drive --list-tools

Odpowiedzi strukturalne

Wszystkie odpowiedzi są w formacie JSON – idealnym dla AI do przetwarzania. Żadnego analizowania tekstu, żadnych niejednoznaczności.

Konfiguracja krok po kroku

1. Instalacja gws

npm install -g @googleworkspace/cli

2. Uwierzytelnianie

gws auth setup
gws auth login --scopes drive,gmail,calendar

Więcej o bezpiecznej konfiguracji w artykule Bezpieczne uwierzytelnianie w gws.

3. Test serwera MCP

gws mcp -s drive,gmail

Serwer uruchomi się i będzie czekał na połączenia przez stdio.

4. Konfiguracja klienta

Dla OpenClaw dodaj do konfiguracji MCP:

{
  "mcpServers": {
    "gws": {
      "command": "gws",
      "args": ["mcp", "-s", "drive,gmail,calendar"]
    }
  }
}

Dla Claude Desktop (macOS):

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "google-workspace": {
      "command": "gws",
      "args": ["mcp", "-s", "drive,gmail,calendar"]
    }
  }
}

Zarządzanie liczbą narzędzi

Tu jest haczyk. Każdy serwis Google generuje od 10 do 80 narzędzi MCP. Gmail to kilkadziesiąt operacji (list, get, send, modify, trash...). Drive podobnie. Calendar też.

Większość klientów MCP ma limit 50–100 narzędzi. Przekroczenie może powodować:

• Spowolnienie (AI musi przeanalizować wszystkie opcje)
• Błędy kontekstu (za dużo do przetworzenia)
• Problemy z wyborem właściwego narzędzia

Strategia: wybierz tylko potrzebne

Zamiast -s recommended (wszystko), wybierz konkretne serwisy:

# Dla asystenta poczty
gws mcp -s gmail

# Dla zarządzania dokumentami
gws mcp -s drive

# Dla planowania
gws mcp -s calendar

# Połączenie dla asystenta wykonawczego
gws mcp -s gmail,calendar,drive

Klienci MCP kompatybilni z gws

MCP to otwarty standard – każdy klient, który go implementuje, może korzystać z gws mcp.

OpenClaw

Pełna integracja MCP. Agent może autonomicznie korzystać z narzędzi Google Workspace, łączyć je z innymi źródłami, uruchamiać złożone scenariusze.

Claude Desktop

Osobisty asystent z dostępem do Twoich plików i wiadomości. „Znajdź ostatnią fakturę od X i wyślij przypomnienie o płatności."

VS Code + Continue

Asystent kodowania AI, który może czytać dokumentację z Drive, pobierać dane testowe z Sheets, sprawdzać harmonogram projektu w Calendar.

Praktyczne zastosowania

Claude z dostępem do firmowego Drive

Scenariusz: Twój zespół ma dokumentację na Drive. Claude Desktop z gws mcp może:

„Znajdź wszystkie dokumenty z tagiem «wdrożenie» i stwórz podsumowanie procesu wprowadzania nowego pracownika."

Agent przeszukuje Drive, czyta dokumenty, generuje syntezę – bez kopiowania plików, bez ręcznego wklejania.

VS Code który czyta dane z Sheets

Programista pracuje nad aplikacją. Dane testowe są w arkuszu Google. Z MCP:

„Pobierz dane z arkusza «Test Data» i wygeneruj fixtures do testów jednostkowych."

AI czyta Sheets, generuje kod, wstawia do projektu.

Asystent wykonawczy z pełnym dostępem

Agent OpenClaw z gws mcp -s gmail,calendar,drive:

„Przejrzyj moją skrzynkę, znajdź wiadomości wymagające odpowiedzi, sprawdź mój kalendarz na jutro i przygotuj plan dnia z uwzględnieniem kontynuacji rozmów."

Jedno polecenie, trzy serwisy, kompletny przegląd.

Własne aplikacje

MCP to standard – możesz zbudować własnego klienta. Python SDK, TypeScript SDK lub dowolny język obsługujący stdio/JSON-RPC.

# Przykład: własny klient MCP
from mcp import Client

client = Client()
client.connect("gws mcp -s gmail")

# Wywołanie narzędzia
result = client.call_tool("gmail_users_messages_list", {
    "userId": "me",
    "maxResults": 10
})