Dodawanie serwera MCP

Agent Gemini w Android Studio może wchodzić w interakcje z narzędziami zewnętrznymi za pomocą protokołu kontekstu modelu (MCP). Ta funkcja zapewnia standardowy sposób, w jaki tryb agenta może korzystać z narzędzi oraz poszerzać wiedzę i możliwości w środowisku zewnętrznym.

Z hostem MCP w Android Studio możesz połączyć wiele narzędzi. Możesz na przykład zintegrować się z serwerem MCP GitHub, aby tworzyć żądania scalenia bezpośrednio w Android Studio, lub z zdalnym serwerem MCP Figma, aby udostępniać informacje o projekcie bez pobierania aplikacji na komputer. Więcej pomysłów znajdziesz na stronie przykładowych serwerów MCP.

Aby dodać serwer MCP, wykonaj te czynności:

  1. Otwórz ustawienia serwera MCP, klikając Plik (Android Studio na macOS) > Ustawienia > Narzędzia > Gemini > Serwery MCP.
  2. Kliknij Włącz serwery MCP.
  3. Dodaj konfigurację MCP w odpowiednim polu. Konfiguracja jest zapisywana w pliku mcp.json w katalogu konfiguracji Androida Studio.
  4. Kliknij OK.

Ten przykład przedstawia plik mcp.json z kilkoma konfiguracjami serwera:

{
  "mcpServers": {
    "figma": {
      "httpUrl": "https://mcp.figma.com/mcp"
    },
    "github": {
      "httpUrl": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer <YOUR_PERSONAL_ACCESS_TOKEN>"
      }
    },
    "gitlab": {
      "httpUrl": "https://gitlab.com/api/v4/mcp"
    },
    "canva": {
      "httpUrl": "https://mcp.canva.com/mcp"
    },
    "notion": {
      "httpUrl": "https://mcp.notion.com/mcp"
    },
    "linear": {
      "httpUrl": "https://mcp.linear.app/mcp"
    }
  }
}

Dokładne wartości konfiguracji, które należy umieścić w tym pliku, znajdziesz w dokumentacji serwera MCP, z którym integrujesz usługę.

Uwierzytelnianie

Po kliknięciu OK zobaczysz powiadomienie „Połączenie z serwerem MCP zostało nawiązane...” lub powiadomienie z opisem błędu. Większość zdalnych serwerów MCP wymaga uwierzytelniania, dlatego w przypadku niepowodzenia autoryzacji zwraca komunikat „Error connecting to transport: Authorization Exception” (Błąd połączenia z transportem: wyjątek autoryzacji).

Kliknij Rozpocznij logowanie, aby rozpocząć proces uwierzytelniania na tym serwerze. W przeglądarce pojawi się prośba o zalogowanie się na stronie logowania tego serwera. Po zalogowaniu się połączenie zostanie ponowione. Jeśli się uda, zobaczysz powiadomienie „Successfully connected to MCP server...” (Połączenie z serwerem MCP zostało nawiązane...).

Korzystanie z narzędzi MCP

Aby sprawdzić, które narzędzia są dostępne dla Gemini w Android Studio, wpisz /mcp na czacie.

Następnie możesz odwoływać się do narzędzi na czacie, np. „wyświetl moje repozytoria w GitHubie”.

Konfiguracje

W tej sekcji opisujemy wszystkie opcje konfiguracji serwera MCP.

Serwer MCP HTTP

W tabeli poniżej znajdziesz opcje konfiguracji połączenia z serwerem MCP za pomocą przesyłanego strumieniowo transportu HTTP.

Nazwa Typ Opis
httpUrl Ciąg znaków Wymagany. Pełny adres URL punktu końcowego HTTP, z którego można przesyłać strumieniowo dane (np. https://example.com/mcp lub http://localhost:1234/mcp).
headers Map<String, String> Mapa niestandardowych nagłówków HTTP, które mają zostać dołączone do żądania połączenia. Domyślna wartość to {} (pusta mapa).
timeout Długie Czas oczekiwania na połączenie w milisekundach. -1 oznacza brak limitu czasu. Domyślna wartość to -1.
enabled Wartość logiczna Czy ta konfiguracja serwera jest aktywna. Domyślna wartość to true.

Ograniczenia

Integracja MCP w Android Studio nie obsługuje tych funkcji:

  • Połączenie z serwerami MCP za pomocą transportu stdio
  • Zasoby MCP
  • Szablony promptów
  • Logowanie OAuth za pomocą niektórych serwerów MCP, np. GitHub