Aggiungi 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à Agente di utilizzare gli strumenti ed estendere le conoscenze e le funzionalità con l'ambiente esterno.

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

Per aggiungere un server MCP:

  1. Vai alle impostazioni del server MCP facendo clic su File (Android Studio su macOS) > Impostazioni > Strumenti > Gemini > Server MCP.
  2. Seleziona Abilita 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 esegui l'integrazione.

Autenticazione

Dopo aver fatto clic su Ok, vedrai una notifica con il messaggio "Connessione al server MCP riuscita" o una notifica che descrive un errore. La maggior parte dei server MCP remoti richiede l'autenticazione e pertanto restituisce "Errore di 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 tentata di nuovo la connessione e, se riuscita, viene visualizzata la notifica "Connessione al server MCP riuscita...".

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".

Configurations (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 riproducibile in streaming.

Nome Tipo Descrizione
httpUrl Stringa Obbligatorio. L'URL completo dell'endpoint HTTP trasmissibile (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 Note lunghe Timeout della connessione in millisecondi. -1 indica nessun timeout. Il valore predefinito è -1.
enabled Booleano Indica se questa configurazione del server è attiva. Il valore predefinito è true.

Limitazioni

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

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