Połącz się z serwerem MCP Developer Knowledge

Serwer MCP Google Developer Knowledge umożliwia narzędziom deweloperskim opartym na AI wyszukiwanie oficjalnej dokumentacji dla deweloperów Google i pobieranie informacji o produktach Google, takich jak Firebase, Google Cloud, Android, Mapy i inne. Dzięki połączeniu aplikacji AI bezpośrednio z naszą oficjalną biblioteką dokumentacji masz pewność, że otrzymywany kod i wskazówki są aktualne i oparte na wiarygodnym kontekście.

Po skonfigurowaniu serwera zintegrowane narzędzia mogą pomagać w obsłudze takich żądań jak:

  • Wskazówki dotyczące implementacji

    • Przykład: Jaki jest najlepszy sposób na wdrożenie powiadomień push w aplikacji na Androida za pomocą Komunikacji w chmurze Firebase?
  • Generowanie i wyjaśnianie kodu

    • Na przykład: Wyszukaj w dokumentacji Google przykład w języku Python, który wyświetla wszystkie zasobniki w projekcie Cloud Storage.
  • Rozwiązywanie problemów i debugowanie

    • Przykład: Dlaczego na moim kluczu interfejsu API Map Google widnieje znak wodny „Tylko na potrzeby programowania”?
  • Analiza porównawcza i podsumowanie

    • Przykład: Pomóż mi wybrać między Cloud Run a Cloud Functions na potrzeby nowej mikrousługi. Utwórz tabelę w języku Markdown, która porównuje kluczowe aspekty, takie jak podstawowy przypadek użycia, współbieżność i model cenowy.

Możliwości serwera MCP

Serwer MCP Google Developer Knowledge udostępnia aplikacji opartej na AI te narzędzia:

Nazwa narzędzia Opis
search_documents Przeszukuje dokumentację dla deweloperów Google (Firebase, Google Cloud, Android, Mapy i inne), aby znaleźć odpowiednie strony i fragmenty dla Twojego zapytania. Użyj get_documentsparent z wyników wyszukiwania, aby uzyskać pełną treść strony.
get_documents Pobiera pełną treść wielu dokumentów za pomocą parent z wyników search_documents.
answer_query (Wersja zapoznawcza) Odpowiada na zapytania, korzystając z korpusu wiedzy dla deweloperów, aby generować odpowiedzi oparte na faktach.

Narzędzie search_documents dzieli dokumentację na mniejsze fragmenty tekstu, które są zoptymalizowane pod kątem wyszukiwania i pobierania z wykorzystaniem AI. Gdy wyszukujesz, narzędzie zwraca co najmniej 1 fragment dokumentu, który jest powiązany z Twoim zapytaniem. Jeśli chcesz wyświetlić pełną treść strony, która otacza fragment, użyj get_documents z parametrem parent podanym w wynikach wyszukiwania, aby pobrać pełną treść strony.

Użyj narzędzia answer_query, gdy chcesz uzyskać bezpośrednią odpowiedź na pytanie wygenerowaną na podstawie zbioru wiedzy dla deweloperów, a nie listę odpowiednich fragmentów lub pełnych dokumentów.

Instalacja

Serwer MCP Developer Knowledge Google to zdalny serwer MCP, który do wyszukiwania i pobierania dokumentacji używa interfejsu Developer Knowledge API. Uwierzytelnianie może się odbywać z wykorzystaniem OAuth lub klucza API.

Uwierzytelnianie przy użyciu OAuth

W tej sekcji znajdziesz instrukcje uwierzytelniania aplikacji AI na serwerze MCP Developer Knowledge za pomocą OAuth.

Wymaganie wstępne: skonfiguruj Google Cloud CLI

Zanim przejdziesz dalej, upewnij się, że masz:

Krok 1. Włączanie interfejsu Developer Knowledge API w projekcie

  1. Otwórz stronę interfejsu Developer Knowledge API w bibliotece interfejsów API Google.
  2. Sprawdź, czy masz wybrany odpowiedni projekt, w którym zamierzasz używać interfejsu API.
  3. Kliknij Włącz. Do włączenia i używania interfejsu API nie są wymagane żadne konkretne role uprawnień.

Krok 2. Wybierz metodę uwierzytelniania

Wybrana metoda uwierzytelniania zależy od tego, czy asystent AI obsługuje domyślne dane logowania aplikacji (ADC) za pomocą gcloud CLI, czy wymaga osobnego identyfikatora klienta OAuth. Asystenci tacy jak Gemini CLI mogą używać Twoich dotychczasowych danych logowania w Google Cloud, co ułatwia konfigurację, a inni, np. Antigravity, wymagają ręcznego utworzenia i podania własnych danych logowania w celu nawiązania bezpiecznego połączenia.

Wybierz kartę odpowiadającą wymaganiom dotyczącym konfiguracji konkretnego asystenta AI.

ADC

Połącz swoje konto

  1. Aby przyznać serwerowi MCP uprawnienia do działania w Twoim imieniu, uruchom to polecenie, zastępując PROJECT_ID identyfikatorem projektu Google Cloud:

    gcloud auth application-default login
    --project=PROJECT_ID
    
  2. Gdy pojawi się prośba, wybierz konto, a potem kliknij Dalej.

Konfigurowanie aplikacji AI

Po uwierzytelnieniu ostatnim krokiem jest podanie aplikacji AI szczegółów konfiguracji serwera. Dokładna struktura JSON różni się w zależności od aplikacji, ale możesz użyć poniższego przykładu jako szablonu.

  1. Aby skonfigurować interfejs wiersza poleceń Gemini lub Gemini Code Assist, edytuj lub utwórz jeden z tych plików konfiguracyjnych:

    • W projekcie: .gemini/settings.json
    • W katalogu głównym: ~/.gemini/settings.json
    {
      "mcpServers": {
        "google-developer-knowledge": {
          "httpUrl": "https://developerknowledge.googleapis.com/mcp",
          "authProviderType": "google_credentials",
          "oauth": {
            "scopes": [
              "https://www.googleapis.com/auth/cloud-platform"
            ]
         },
          "timeout": 30000,
          "headers": {
            "X-goog-user-project": "PROJECT_ID"
          }
        }
      }
    }
    

    Aby sprawdzić, czy serwer MCP działa zgodnie z oczekiwaniami, przejdź do sekcji weryfikacja instalacji.

Dane logowania wpisywane ręcznie

Konfigurowanie ekranu zgody OAuth

Skonfiguruj ekran zgody OAuth w projekcie i dodaj siebie jako użytkownika testowego. Jeśli ten krok został już wykonany w Twoim projekcie Google Cloud, przejdź do następnego.

  1. Otwórz stronę przeglądu uwierzytelniania w konsoli Google Cloud i kliknij Rozpocznij.
  2. Wpisz nazwę aplikacji, wybierz adres e-mail pomocy i kliknij Dalej.
  3. W sekcji Odbiorcy wybierz Zewnętrzny i kliknij Dalej.
  4. Wpisz adres e-mail w sekcji Dane kontaktowe i kliknij Dalej.
  5. Zapoznaj się z zasadami dotyczącymi danych użytkownika w usługach interfejsu API Google i zaakceptuj je, a potem kliknij Dalej.
  6. Kliknij Utwórz.

Dodawanie użytkowników testowych

  1. Na platformie Google Auth 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 potem kliknij Zapisz.

Tworzenie klienta OAuth

Aby uwierzytelnić się jako użytkownik i uzyskać dostęp do danych użytkownika w aplikacji, musisz utworzyć identyfikatory klienta OAuth 2.0. Identyfikator klienta wskazuje konkretną aplikację na serwerach OAuth Google.

  1. Na platformie Google Auth kliknij Klienci.
  2. Kliknij Utwórz klienta.
  3. W selektorze Typ aplikacji wybierz Aplikacja na komputer.
  4. W polu Nazwa wpisz nazwę danych logowania. Ta nazwa jest wyświetlana tylko w konsoli Google Cloud.
  5. Kliknij Utwórz. Wyświetli się ekran utworzonego klienta OAuth z nowym identyfikatorem klienta i tajnym kluczem klienta.
  6. Kliknij OK. Nowo utworzone dane logowania pojawią się w sekcji Identyfikatory klientów OAuth 2.0.
  7. Kliknij nowo utworzony identyfikator klienta. W sekcji Client secrets (Tajne klucze klienta) kliknij ikonę pobierania, aby zapisać plik JSON. Wartości client_idclient_secret z tego pliku wykorzystasz w kolejnym kroku.

Konfigurowanie aplikacji AI

Następnie musisz podać aplikacji opartej na AI szczegóły konfiguracji serwera. Dokładna sekwencja kroków różni się w zależności od aplikacji, ale możesz użyć poniższego przykładu jako szablonu.

Aby skonfigurować Antigravity do korzystania z serwera MCP:

  1. W Antigravity kliknij menu Dodatkowe opcje w panelu Agent > Serwery MCP > Zarządzaj serwerami MCP.
  2. U góry otwartego panelu Zarządzaj serwerami MCP kliknij Wyświetl konfigurację w postaci nieprzetworzonej, aby edytować plik mcp_config.json:

    {
      "mcpServers": {
        "google-developer-knowledge": {
          "serverUrl": "https://developerknowledge.googleapis.com/mcp"
        }
      }
    }
    
  3. Wróć do Zarządzaj serwerami MCP i kliknij Odśwież.

Dodawanie danych logowania OAuth

Gdy po raz pierwszy spróbujesz użyć serwera MCP Developer Knowledge, asystent AI poprosi Cię o dokończenie konfiguracji:

  1. Poproś agenta o użycie serwera MCP Developer Knowledge, np. za pomocą promptu:

    How do I list Cloud Storage buckets?
    
  2. Jeśli zobaczysz komunikat z prośbą o zarejestrowanie co najmniej jednego identyfikatora URI przekierowania, kliknij opcję, aby kontynuować. Identyfikator klienta został skonfigurowany jako aplikacja na komputer, więc nie musisz dodawać tych konkretnych identyfikatorów URI na platformie Google Auth.

  3. Gdy asystent AI poprosi Cię o podanie identyfikatora klientatajnego klucza klienta, wklej odpowiednie klucze z zapisanego wcześniej pliku JSON z tajnym kluczem klienta.

  4. Gdy pojawi się prośba, wybierz konto, a potem kliknij Dalej.

  5. Wróć do asystenta AI. Agent przetworzy teraz Twoją prośbę za pomocą nowo uwierzytelnionego serwera.

Uwierzytelnianie za pomocą klucza interfejsu API

W tej sekcji znajdziesz instrukcje uwierzytelniania aplikacji AI na serwerze MCP Developer Knowledge za pomocą klucza interfejsu API.

Krok 1. Utwórz klucz interfejsu API

Klucz interfejsu Developer Knowledge API możesz wygenerować w projekcie Google Cloud za pomocą konsoli Google Cloud lub interfejsu gcloud CLI:

Google Cloud Console

Włącz API

  1. Otwórz stronę interfejsu Developer Knowledge API w bibliotece interfejsów API Google.
  2. Sprawdź, czy masz wybrany odpowiedni projekt, w którym zamierzasz używać interfejsu API.
  3. Kliknij Włącz. Do włączenia i używania interfejsu API nie są wymagane żadne konkretne role uprawnień.

Tworzenie i zabezpieczanie klucza interfejsu API

  1. W konsoli Google Cloud w projekcie, w którym został włączony interfejs API, otwórz stronę Dane logowania.
  2. Kliknij Utwórz dane logowania, a potem wybierz z menu Klucz interfejsu API.
  3. W polu Nazwa wpisz nazwę klucza.
  4. Kliknij menu Wybierz ograniczenia interfejsu API, a następnie wpisz Developer Knowledge API. Kliknij wynik, a potem OK.

    Uwagi:

    • Jeśli interfejs Developer Knowledge API został włączony niedawno, może minąć trochę czasu, zanim pojawi się na liście. Poczekaj kilka minut i spróbuj ponownie.
    • Jeśli planujesz używać tego samego klucza do wywoływania ogólnego modelu klienta AI (np. GEMINI_API_KEY), musisz też wybrać Generative Language API. W przeciwnym razie te połączenia zostaną zablokowane.
  5. Kliknij Utwórz.

Po utworzeniu klucza kliknij Pokaż klucz, aby go wyświetlić. Zapisz go, aby użyć go podczas konfigurowania aplikacji AI.

interfejs wiersza poleceń gcloud

  1. Jeśli jeszcze tego nie zrobisz, pobierz i zainstaluj gcloud CLI.
  2. Włącz Developer Knowledge API, zastępując PROJECT_ID identyfikatorem projektu w chmurze Google Cloud:

    gcloud services enable developerknowledge.googleapis.com --project=PROJECT_ID
    
  3. Utwórz klucz interfejsu API, używając tego samego identyfikatora projektu Google Cloud:

    gcloud services api-keys create --project=PROJECT_ID --display-name="DK API Key"
    

    To polecenie zwraca 2 wartości, które warto zapisać:

    • Znak keyString to Twój klucz interfejsu API. Będzie on potrzebny podczas konfigurowania aplikacji z AI.
    • name zostanie użyty w następnym kroku podczas zabezpieczania klucza.
  4. Ogranicz klucz do interfejsu Developer Knowledge API, zastępując KEY_NAME nazwą klucza (np. projects/my-project/locations/global/keys/12345-67890):

    gcloud services api-keys update KEY_NAME --api-target=service=developerknowledge.googleapis.com
    

    Ważne: jeśli planujesz używać tego samego klucza do wywołań ogólnego modelu klienta AI (np. GEMINI_API_KEY), musisz też zezwolić na interfejs Generative Language API:

    gcloud services api-keys update KEY_NAME \
      --api-target=service=developerknowledge.googleapis.com \
      --api-target=service=generativelanguage.googleapis.com
    

Krok 2. Włącz serwer MCP Developer Knowledge w projekcie

Aby włączyć serwer MCP Developer Knowledge w projekcie Google Cloud, pobierz i zainstaluj gcloud CLI, a następnie uruchom to polecenie, zastępując PROJECT_ID identyfikatorem projektu Google Cloud:

gcloud beta services mcp enable developerknowledge.googleapis.com --project=PROJECT_ID

Jeśli usługa Developer Knowledge nie jest włączona w Twoim projekcie Google Cloud, przed włączeniem zdalnego serwera MCP pojawi się prośba o włączenie tej usługi.

Ze względów bezpieczeństwa zalecamy włączanie serwerów MCP tylko w przypadku usług wymaganych do działania aplikacji AI.

Krok 3. Skonfiguruj aplikację AI

Skonfiguruj popularne aplikacje AI, korzystając z tych instrukcji. Zastąp YOUR_API_KEY kluczem interfejsu Developer Knowledge API wygenerowanym w poprzednim kroku:

Interfejs wiersza poleceń Gemini

Aby skonfigurować interfejs wiersza poleceń Gemini, uruchom to polecenie:

gemini mcp add -t http -H "X-Goog-Api-Key: YOUR_API_KEY" google-developer-knowledge https://developerknowledge.googleapis.com/mcp --scope user

Możesz też edytować lub utworzyć jeden z tych plików konfiguracyjnych:

  • W projekcie: .gemini/settings.json
  • W katalogu głównym: ~/.gemini/settings.json
{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Gemini Code Assist

Aby skonfigurować Gemini Code Assist, edytuj lub utwórz jeden z tych plików konfiguracyjnych:

  • W projekcie: .gemini/settings.json
  • W katalogu głównym: ~/.gemini/settings.json
{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Claude Code

Aby skonfigurować Claude Code, uruchom to polecenie w folderze aplikacji.

claude mcp add google-dev-knowledge --transport http https://developerknowledge.googleapis.com/mcp --header "X-Goog-Api-Key: YOUR_API_KEY"

Kursor

Aby skonfigurować Cursor, edytuj plik .cursor/mcp.json (dla konkretnego projektu) lub ~/.cursor/mcp.json (dla wszystkich projektów).

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

GitHub Copilot

Aby skonfigurować GitHub Copilot w VS Code dla jednego projektu, edytuj plik .vscode/mcp.json w obszarze roboczym.

{
  "servers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Aby serwer był dostępny w każdym projekcie, zmień ustawienia użytkownika. Kliknij przycisk Otwórz ustawienia (JSON).

{
  "mcp": {
    "servers": {
      "google-developer-knowledge": {
        "url": "https://developerknowledge.googleapis.com/mcp",
        "headers": {
          "X-Goog-Api-Key": "YOUR_API_KEY"
        }
      }
    }
  }
}

Windsurfing

Aby skonfigurować edytor Windsurf, edytuj plik ~/.codeium/windsurf/mcp_config.json.

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Zweryfikuj instalację

Po skonfigurowaniu otwórz aplikację AI i wpisz prompt, np.:

How do I list Cloud Storage buckets?

Jeśli widzisz wywołanie narzędzia search_documents lub innego narzędzia serwera MCP Developer Knowledge, serwer działa prawidłowo.

Zarządzanie wykorzystaniem tokenów

Pobieranie treści dokumentów – zwłaszcza podczas korzystania z batch_get_documents – zużywa tokeny w oknie kontekstowym aplikacji AI. Niektóre strony dokumentacji dla deweloperów Google są dość duże, więc pobieranie wielu dokumentów może szybko prowadzić do wyższych kosztów, wolniejszego czasu odpowiedzi modelu i przepełnienia okna kontekstowego.

Aby zoptymalizować wydajność i uniknąć nieoczekiwanego rachunku, twórz konkretne prompty, które są kierowane tylko na potrzebne Ci informacje. Unikaj ogólnych próśb (np. „Porównaj wszystkie usługi Firebase”), które zmuszają agenta do jednoczesnego przetwarzania ogromnych ilości danych.

Dołączona dokumentacja

Informacje o tym, które dokumenty są przeszukiwane przez serwer, znajdziesz w tym artykule.

Znane ograniczenia

  • Zakres treści: obejmuje tylko publicznie widoczne strony w korpusie referencyjnym. Nie uwzględniamy treści z innych źródeł, takich jak GitHub, witryny OSS, blogi czy YouTube.
  • Wyniki tylko w języku angielskim: serwer obsługuje tylko wyniki w języku angielskim.
  • Zależne od sieci: narzędzia serwera korzystają z usług Google Cloud na żywo. Jeśli błędy nadal będą występować, sprawdź połączenie z internetem i konfigurację klucza interfejsu Developer Knowledge API.

Opcjonalne konfiguracje zabezpieczeń

MCP wprowadza nowe zagrożenia i kwestie związane z bezpieczeństwem ze względu na szeroki zakres działań, które można wykonywać za pomocą narzędzi MCP. Aby zminimalizować te zagrożenia i nimi zarządzać, Google Cloud oferuje ustawienia domyślne i zasady, które można dostosowywać, aby kontrolować korzystanie z narzędzi MCP w organizacji lub projekcie Google Cloud.

Więcej informacji o bezpieczeństwie i zarządzaniu MCP znajdziesz w artykule Bezpieczeństwo i ochrona AI.

Korzystanie z Model Armor

Model Armor to usługa Google Cloud, która zwiększa bezpieczeństwo aplikacji AI. Działa ona poprzez proaktywne sprawdzanie promptów i odpowiedzi LLM, chroniąc przed różnymi zagrożeniami i wspierając odpowiedzialne praktyki związane z AI. Niezależnie od tego, czy wdrażasz AI w środowisku chmury, czy u zewnętrznych dostawców usług w chmurze, Model Armor może pomóc Ci zapobiegać złośliwym danym wejściowym, weryfikować bezpieczeństwo treści, chronić dane wrażliwe, zachowywać zgodność z przepisami oraz konsekwentnie egzekwować zasady bezpieczeństwa AI w różnorodnym środowisku AI.

Gdy Model Armor jest włączony z włączonym logowaniem, rejestruje cały ładunek. Może to spowodować ujawnienie w logach informacji poufnych.

Włącz Model Armor

Aby włączyć Model Armor, wykonaj czynności opisane w artykule Integracja z serwerami MCP Google i Google Cloud.

Konfigurowanie ochrony zdalnych serwerów MCP Google i Google Cloud

Aby chronić wywołania narzędzi MCP i odpowiedzi, możesz użyć ustawień progu Model Armor. Ustawienie minimalne określa minimalne filtry zabezpieczeń, które obowiązują w całym projekcie. Ta konfiguracja stosuje spójny zestaw filtrów do wszystkich wywołań i odpowiedzi narzędzi MCP w projekcie.

Skonfiguruj ustawienie progu Model Armor z włączonym czyszczeniem MCP. Więcej informacji znajdziesz w artykule Konfigurowanie ustawień progu Model Armor.

Oto przykładowe polecenie:

gcloud model-armor floorsettings update \
--full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
--enable-floor-setting-enforcement=TRUE \
--add-integrated-services=GOOGLE_MCP_SERVER \
--google-mcp-server-enforcement-type=INSPECT_AND_BLOCK \
--enable-google-mcp-server-cloud-logging \
--malicious-uri-filter-settings-enforcement=ENABLED \
--add-rai-settings-filters='[{"confidenceLevel": "MEDIUM_AND_ABOVE", "filterType": "DANGEROUS"}]'

Zastąp PROJECT_ID identyfikatorem projektu .

Zwróć uwagę na te ustawienia:

  • INSPECT_AND_BLOCK: typ egzekwowania, który sprawdza treści na serwerze MCP Google i blokuje prompty oraz odpowiedzi pasujące do filtrów.
  • ENABLED: ustawienie, które włącza filtr lub egzekwowanie.
  • MEDIUM_AND_ABOVE: poziom ufności ustawień filtra odpowiedzialnej AI – niebezpieczne. Możesz zmodyfikować to ustawienie, ale niższe wartości mogą powodować więcej wyników fałszywie pozytywnych. Więcej informacji znajdziesz w artykule Poziomy ufności Model Armor.

Wyłącz skanowanie ruchu MCP za pomocą Model Armor

Aby zatrzymać automatyczne skanowanie ruchu do i z serwerów MCP Google przez Model Armor na podstawie ustawień progów projektu, uruchom to polecenie:

gcloud model-armor floorsettings update \
  --full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
  --remove-integrated-services=GOOGLE_MCP_SERVER

Zastąp PROJECT_ID identyfikatorem projektu. Model Armor nie stosuje automatycznie reguł zdefiniowanych w ustawieniach progu tego projektu do ruchu na serwerach Google MCP.

Ustawienia progu i ogólna konfiguracja Model Armor mogą mieć wpływ nie tylko na MCP. Model Armor jest zintegrowany z usługami takimi jak Vertex AI, więc wszelkie zmiany ustawień progu mogą wpływać na skanowanie ruchu i zachowania związane z bezpieczeństwem we wszystkich zintegrowanych usługach, a nie tylko w MCP.

Dostosowywanie ustawień Model Armor

Jeśli do ochrony aplikacji używasz Model Armor, w przypadku niektórych zapytań możesz napotkać błędy 403 PERMISSION_DENIED. Serwer MCP Developer Knowledge zwraca tylko publiczną dokumentację z zaufanych źródeł Google, dlatego zalecamy ustawienie filtrów wstrzykiwania promptów i jailbreakingu (PIJB) na poziomy ufności HIGH_AND_ABOVE, aby zmniejszyć liczbę fałszywych alarmów. Jeśli Twój przypadek użycia nie obejmuje innych narzędzi, które mają dostęp do danych prywatnych lub wrażliwych, możesz też wyłączyć filtry PIJB.

Rozwiązywanie problemów

Jeśli napotkasz problemy, sprawdź te kwestie: