Aggiungere un server MCP

L'agente di Gemini in Android Studio può interagire con strumenti esterni utilizzando il Model Context Protocol (MCP). Questa funzionalità fornisce un modo standardizzato per la modalità Agent di utilizzare gli strumenti ed estendere le conoscenze e le funzionalità con l'ambiente esterno.

Esistono molti strumenti a cui puoi connetterti all'host MCP in Android Studio. Ad esempio, puoi eseguire l'integrazione con il server MCP di GitHub per creare richieste di pull direttamente da Android Studio o con il server MCP remoto di Figma per fornire informazioni di progettazione senza scaricare l'app desktop. Per altre idee, consulta i server di esempio MCP.

Per aggiungere un server MCP:

  1. Vai alle impostazioni del server MCP facendo clic su File (Android Studio su macOS) > Impostazioni > Strumenti > AI > Server MCP.
  2. Seleziona Attiva server MCP.
  3. Aggiungi la configurazione MCP nel campo fornito. La configurazione viene salvata in un file mcp.json nella directory di configurazione di Android Studio.
  4. Fai clic su OK.

L'esempio seguente mostra un file mcp.json con diverse configurazioni del server:

{
  "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"
    }
  }
}

Per i valori di configurazione precisi da elencare in questo file, consulta la documentazione del server MCP con cui stai eseguendo l'integrazione.

Autenticazione

Dopo aver fatto clic su OK, vedrai una notifica che indica "Connessione al server MCP in corso…" o una notifica che descrive un errore. La maggior parte dei server MCP remoti richiede l'autenticazione e pertanto restituisce "Errore durante la connessione al trasporto: eccezione di autorizzazione" quando l'autorizzazione non va a buon fine.

Fai clic su Avvia accesso per avviare la procedura di autenticazione per il server. Ti verrà chiesto di accedere alla pagina di accesso del server nel browser. Dopo aver eseguito l'accesso, viene ritentata la connessione e, se va a buon fine, vedrai la notifica "Connessione al server MCP in corso…".

Utilizzare gli strumenti MCP

Per vedere quali strumenti sono disponibili per Gemini in Android Studio, digita /mcp nella chat.

Puoi quindi fare riferimento agli strumenti nella chat, ad esempio "elenca i miei repository su GitHub".

Configurazioni

Questa sezione descrive tutte le opzioni di configurazione del server MCP.

Server MCP HTTP

La tabella seguente elenca le opzioni di configurazione per la connessione a un server MCP tramite un trasporto HTTP in streaming.

Nome Tipo Descrizione
httpUrl Stringa Obbligatorio. L'URL completo dell'endpoint HTTP in streaming (ad esempio, https://example.com/mcp o http://localhost:1234/mcp).
headers Map<String, String> Una mappa delle intestazioni HTTP personalizzate da includere nella richiesta di connessione. Il valore predefinito è {} (una mappa vuota).
timeout Lungo Timeout di connessione in millisecondi. -1 indica che non è previsto alcun timeout. Il valore predefinito è -1.
enabled Booleano Indica se questa configurazione del server è attiva. Il valore predefinito è true.

Limitazioni

L'integrazione MCP di Android Studio non supporta le seguenti funzionalità:

  • Connessione ai server MCP tramite trasporto stdio
  • Risorse MCP
  • Modelli di prompt
  • Accesso OAuth con alcuni server MCP, come GitHub