Łączenie się z serwerami Model Context Protocol (MCP)

Serwery MCP udostępniają Gemini dodatkowe narzędzia i źródła danych. Na przykład po dodaniu serwera Firebase MCP, możesz używać języka naturalnego do eksplorowania danych Cloud Firestore podczas tworzenia lub debugowania aplikacji.

Wymagania wstępne

Jeśli serwer MCP tego wymaga, upewnij się, że masz działającą instalację Node.js i npm.

Wybieranie zgodnego serwera MCP

Firebase Studio ma podstawową obsługę serwerów MCP, ale nie wszystkie serwery MCP są zgodne. Wybierając serwer MCP, pamiętaj o tych szczegółach dotyczących zgodności:

  • Obsługiwane:

    • Standardowe serwery wejścia/wyjścia (stdio) lub serwery transportu HTTP z możliwością strumieniowania (SSE)
    • Uwierzytelnianie kluczem interfejsu API za pomocą nagłówków HTTP lub zmiennych środowiskowych
    • Narzędzia udostępniane przez serwery MCP

  • Nieobsługiwane:

    • Serwery, które wymagają graficznego interfejsu użytkownika lub sesji na komputerze
    • Podpowiedzi, próbkowanie lub inne zasoby udostępniane przez serwery MCP

Dodawanie serwera MCP

Aby dodać serwer MCP, musisz utworzyć lub edytować jego plik konfiguracyjny.

Krok 1. Utwórz plik konfiguracyjny

Czat interaktywny łączy się z serwerami MCP za pomocą pliku konfiguracyjnego:

  • Czat interaktywny używa pliku .idx/mcp.json.

Utwórz plik, postępując zgodnie z tymi instrukcjami.

Czat interaktywny

W widoku Code utwórz plik .idx/mcp.json, korzystając z jednej z tych metod:

  • Paleta poleceń: otwórz paletę poleceń (Shift+Ctrl+P) i użyj polecenia Firebase Studio: dodaj serwer MCP.
  • Czat interaktywny: na czacie interaktywnym kliknij Dostosowywanie ikony narzędzi Dostosuj narzędzia i wybierz Dodaj serwer MCP.
  • Eksplorator: w eksploratorze (Ctrl+Shift+E) kliknij prawym przyciskiem myszy katalog .idx i wybierz Nowy plik. Nazwij plik mcp.json.

Krok 2. Edytuj konfigurację serwera

  1. Otwórz plik konfiguracji serwera.

  2. Dodaj konfigurację serwera do zawartości pliku. Aby na przykład dodać serwer Firebase MCP, wpisz:

    {
  "mcpServers": {
   "firebase": {
     "command": "npx",
     "args": [
       "-y",
       "firebase-tools@latest",
       "mcp"
      ]
    }
  }
}

    Ten plik konfiguracyjny informuje Gemini którego serwera MCP ma używać. Ten przykład pokazuje pojedynczy serwer o nazwie firebase, który będzie używać polecenia npx do instalowania i uruchamiania firebase-tools@latest.

    Jeśli serwer MCP wymaga uwierzytelniania kluczem interfejsu API, możesz skonfigurować go na jeden z tych sposobów:

    • W przypadku zdalnych serwerów HTTP MCP, które wymagają klucza interfejsu API w nagłówkach żądań, użyj pola headers. Aby na przykład skonfigurować serwer GitHub MCP:

      {
  "mcpServers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer <ACCESS_TOKEN>"
      }
    }
  }
}

    • W przypadku lokalnych serwerów stdio MCP, które wymagają klucza interfejsu API w zmiennych środowiskowych, użyj pola env. Aby na przykład skonfigurować lokalną kompilację serwera GitHub MCP:

      {
  "mcpServers": {
    "github": {
      "command": "/path/to/github-mcp-server",
      "args": ["stdio"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<ACCESS_TOKEN>"
      }
    }
  }
}

    • Aby uniknąć zakodowania na stałe tajnych informacji w pliku mcp.json, możesz opcjonalnie użyć składni ${env:VARIABLE_NAME}. Spowoduje to zastąpienie wartościami ze zmiennych środowiskowych zdefiniowanych w pliku .env lub .env.local w katalogu głównym obszaru roboczego. Przykład:

      {
  "mcpServers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${env:GITHUB_ACCESS_TOKEN}"
      }
    }
  }
}

  3. W terminalu (Shift+Ctrl+C) uruchom wszystkie niezbędne polecenia, aby zakończyć instalację. Aby na przykład użyć serwera Firebase MCP, wpisz to polecenie, aby zalogować się na konto:

    firebase login --no-localhost

    Postępuj zgodnie z instrukcjami w terminalu, aby autoryzować sesję. Niektóre narzędzia wymagają połączenia z projektem Firebase. Możesz użyć serwera Firebase MCP, aby utworzyć projekt, lub uruchomić to polecenie, aby zainicjować projekt Firebase:

    firebase init

    Spowoduje to utworzenie pliku firebase.json w katalogu głównym.

Korzystanie z narzędzi MCP

Po zainstalowaniu serwera MCP, którego chcesz używać, narzędzia lub dane, które udostępnia, są dostępne w tych miejscach:

  • Czat interaktywny w trybie agenta i trybie agenta (automatyczne uruchamianie)
  • o App Prototyping agent

Jeśli na przykład dodasz serwer Firebase MCP, możesz poprosić Gemini o pobranie konfiguracji pakietu SDK dla bieżącego projektu, pobranie danych przechowywanych w Cloud Firestore i Realtime Database, pomoc w konfigurowaniu usług Firebase i inne działania.

Na czacie interaktywnym wpisz /, aby wyświetlić listę dostępnych podpowiedzi MCP.

Lista dostępnych promptów MCP

Sprawdzanie i dostosowywanie narzędzi

Możesz zarządzać tym, które narzędzia są aktywne na czacie interaktywnym:

  1. Na czacie interaktywnym kliknij Dostosowywanie ikony narzędzi Dostosuj narzędzia , aby wyświetlić listę wszystkich dostępnych narzędzi ze skonfigurowanych serwerów MCP.
  2. Użyj pól wyboru, aby włączyć lub wyłączyć cały serwer albo poszczególne narzędzia.

Lista dostępnych narzędzi MCP

Rozwiązywanie problemów z serwerami MCP

Jeśli masz problemy z serwerem MCP, wykonaj te czynności, aby zdiagnozować problem.

Sprawdzanie dzienników pod kątem błędów

  1. Otwórz panel Wyniki (Shift+Ctrl+U).
  2. W menu wybierz Gemini.
  3. Sprawdź, czy nie ma wiadomości zaczynających się od tagu [MCPManager]. Te dzienniki pokazują, które serwery są skonfigurowane, które narzędzia zostały pomyślnie dodane oraz wszelkie komunikaty o błędach.

Ponowne tworzenie środowiska

Jeśli nie uda się zainstalować serwera MCP lub połączyć się z nim, spróbuj ponownie utworzyć obszar roboczy:

  1. Otwórz paletę poleceń (Shift+Ctrl+P).
  2. Uruchom polecenie Firebase Studio: Rebuild Environment (Firebase Studio: ponownie utwórz środowisko).
  3. Po ponownym utworzeniu obszaru roboczego sprawdź, czy serwer MCP się łączy.

Jeśli narzędzia nie są używane

Jeśli serwer MCP się łączy, ale Gemini nie używa jego narzędzi:

  • Rozpocznij nową sesję czatu: dzięki temu Gemini będzie korzystać z najnowszej konfiguracji narzędzi. Dowiedz się, jak zarządzać historią czatu.
  • Używaj konkretnych podpowiedzi: jeśli Gemini może wykonać zadanie bez użycia narzędzia MCP, może spróbować innej metody. Jeśli chcesz użyć konkretnego narzędzia, spróbuj je nazwać. Na przykład: „Użyj firebase_get_sdk_config, aby pobrać konfigurację pakietu SDK dla bieżącego projektu”.
  • Dołącz do programu Google dla deweloperów: sprawdź, czy Twoje konto jest zarejestrowane.

Dalsze kroki