Connettiti al server MCP per Developer Knowledge

Anteprima

Questo prodotto è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. I prodotti pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Il server MCP per Google Developer Knowledge consente agli strumenti di sviluppo basati sull'AI di cercare la documentazione ufficiale per sviluppatori di Google e recuperare informazioni sui prodotti Google come Firebase, Google Cloud, Android, Maps e altro ancora. Se colleghi la tua applicazione AI direttamente alla nostra libreria ufficiale di documentazione, il codice e le indicazioni che ricevi sono aggiornati e basati su un contesto autorevole.

Dopo aver configurato il server, gli strumenti integrati possono aiutarti con le richieste, ad esempio:

• Best practice per l'implementazione

  • Ad esempio: Qual è il modo migliore per implementare le notifiche push utilizzando Firebase Cloud Messaging in un'app per Android?

• Generazione e spiegazione del codice

  • Ad esempio: Cerca nella documentazione di Google un esempio di Python per elencare tutti i bucket in un progetto Cloud Storage.

• Risoluzione dei problemi e debug

  • Ad esempio: Perché la mia chiave API di Google Maps mostra una filigrana "Solo per scopi di sviluppo"?

• Analisi comparativa e riepilogo

  • Ad esempio: Aiutami a scegliere tra Cloud Run e Cloud Functions per un nuovo microservizio. Crea una tabella Markdown che confronti gli aspetti chiave come il caso d'uso principale, la concorrenza e il modello di prezzi.

Funzionalità del server MCP

Il server MCP per Google Developer Knowledge fornisce i seguenti strumenti alla tua applicazione AI:

Nome strumento	Descrizione
search_documents	Cerca nella documentazione per sviluppatori di Google (Firebase, Google Cloud, Android, Maps e altro ancora) le pagine e gli snippet pertinenti per la tua query. Utilizza get_documents con il parent dei risultati di ricerca per ottenere i contenuti della pagina completa.
get_documents	Ottiene i contenuti completi di più documenti utilizzando i parent dei risultati di search_documents.

Lo strumento search_documents suddivide la documentazione in blocchi di testo più piccoli ottimizzati per la ricerca e il recupero basati sull'AI. Quando esegui una ricerca, lo strumento restituisce uno o più snippet di documenti pertinenti alla tua query. Se devi visualizzare i contenuti della pagina completa che circondano uno snippet, utilizza get_documents con il parent fornito nei risultati di ricerca per recuperare i contenuti della pagina completa.

Installazione

Il server MCP per Google Developer Knowledge è un server MCP remoto che utilizza la API Developer Knowledge per cercare e recuperare la documentazione. Puoi autenticarti utilizzando OAuth o una chiave API.

Nota: non tutte le applicazioni AI sono compatibili con ogni metodo di autenticazione. Se non vedi l'applicazione che preferisci nella sezione di configurazione, prova a utilizzare un altro metodo di autenticazione supportato.

Autenticarsi utilizzando OAuth

Questa sezione ti guida nella procedura di autenticazione della tua applicazione AI con il server MCP per Developer Knowledge utilizzando OAuth.

Prerequisito: configura Google Cloud CLI

Prima di procedere, assicurati di avere:

• Un progetto cloud di Google
• Un'installazione locale di gcloud CLI

Passaggio 1: abilita l'API Developer Knowledge in un progetto

1. Apri la pagina dell'API Developer Knowledge nella libreria delle API di Google.
2. Verifica di aver selezionato il progetto corretto in cui intendi utilizzare l'API.
3. Fai clic su Abilita. Non sono necessari ruoli IAM specifici per abilitare o utilizzare l' API.

Passaggio 2: scegli il metodo di autenticazione

Il metodo di autenticazione scelto dipende dal fatto che l'assistente AI supporti le Credenziali predefinite dell'applicazione (ADC) utilizzando gcloud CLI o richieda un ID client OAuth autonomo. Gli assistenti come Gemini CLI possono utilizzare l'accesso esistente a Google Cloud per una configurazione senza problemi, mentre altri, come Antigravity, richiedono di creare e fornire manualmente le proprie credenziali per stabilire una connessione sicura.

Seleziona la scheda corrispondente ai requisiti di configurazione specifici del tuo assistente AI.

ADC

Collega il tuo account

1. Per concedere al server MCP la possibilità di agire per tuo conto, esegui il comando seguente, sostituendo PROJECT_ID con il tuo ID progetto Google Cloud:

   gcloud auth application-default login
   --project=PROJECT_ID
   

2. Quando ti viene richiesto, scegli un account e fai clic su Continua.

Configura l'applicazione AI

Una volta autenticato, l'ultimo passaggio consiste nel fornire all'applicazione AI i dettagli di configurazione del server. Sebbene la struttura JSON esatta vari in base all'applicazione, puoi utilizzare il seguente esempio come modello.

1. Per configurare Gemini CLI o Gemini Code Assist, modifica o crea uno dei seguenti file di configurazione:

   • Nel tuo progetto: .gemini/settings.json
   • Nella tua home directory: ~/.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"
         }
       }
     }
   }
   

   Per verificare se il server MCP funziona come previsto, continua con la verifica dell'installazione.

Credenziali manuali

Configura la schermata per il consenso OAuth

Configura la schermata per il consenso OAuth del progetto e aggiungiti come utente di test. Se hai già completato questo passaggio per il tuo progetto Google Cloud, vai al passaggio successivo.

1. Apri la pagina di panoramica dell'autenticazione della console Google Cloud, e fai clic su Inizia.
2. Inserisci un nome dell'app, seleziona la tua email di assistenza e fai clic Avanti.
3. In Pubblico, seleziona Esterno e fai clic su Avanti.
4. Inserisci il tuo indirizzo email in Informazioni di contatto e fai clic su Avanti.
5. Leggi e accetta le Norme relative ai dati utente: servizi API di Google, quindi fai clic su Continua.
6. Fai clic su Crea.

Aggiungi utenti di test

1. Nella piattaforma di autenticazione Google, fai clic su Pubblico.
2. In Utenti di test, fai clic su Aggiungi utenti.
3. Inserisci il tuo indirizzo email e gli altri utenti di test autorizzati, quindi fai clic su Salva.

Crea un client OAuth

Per autenticarti come utente finale e accedere ai dati utente nella tua app, devi creare ID client OAuth 2.0. L'ID client viene utilizzato per identificare una singola app nei server OAuth di Google.

1. Nella piattaforma di autenticazione Google, fai clic su Client.
2. Fai clic su Crea client.
3. Nel selettore Tipo di applicazione, scegli App desktop.
4. Nel campo Nome, digita un nome per la credenziale. Questo nome viene visualizzato solo nella console Google Cloud.
5. Fai clic su Crea. Viene visualizzata la schermata Client OAuth creato, che mostra il nuovo ID client e il nuovo client secret.
6. Fai clic su OK. La credenziale appena creata viene visualizzata in ID client OAuth 2.0.
7. Fai clic sull'ID client appena creato. Nella sezione Client secret , fai clic sull'icona di download per salvare il file JSON. Utilizzerai i client_id e client_secret valori in questo file in un passaggio successivo.

Configura l'applicazione AI

A questo punto devi fornire all'applicazione AI i dettagli di configurazione del server. Sebbene la sequenza esatta di passaggi vari in base all'applicazione, puoi utilizzare il seguente esempio come modello.

Per configurare Antigravity in modo che utilizzi il server MCP:

1. In Antigravity, fai clic sul menu Altre opzioni nel riquadro Agente > Server MCP > Gestisci server MCP.

2. Nella parte superiore del riquadro Gestisci server MCP che si apre, fai clic su Visualizza configurazione non elaborata per modificare il mcp_config.json file:

   {
     "mcpServers": {
       "google-developer-knowledge": {
         "serverUrl": "https://developerknowledge.googleapis.com/mcp"
       }
     }
   }
   

3. Torna a Gestisci server MCP e fai clic su Aggiorna.

Aggiungi le credenziali OAuth

La prima volta che tenti di utilizzare il server MCP per Developer Knowledge, l'assistente AI ti chiederà di completare la configurazione:

1. Chiedi all'agente di utilizzare il server MCP per Developer Knowledge con un prompt come:

   How do I list Cloud Storage buckets?
   

2. Se visualizzi un messaggio che ti chiede di registrare uno o più URI di reindirizzamento, fai clic sull'opzione per procedere. Poiché hai configurato l'ID client come app desktop, non è necessario aggiungere questi URI specifici nella piattaforma di autenticazione Google.

3. Quando l'assistente AI ti chiede l'ID client e client secret, incolla ogni chiave corrispondente dal file JSON del client secret che hai salvato in precedenza.

4. Quando ti viene richiesto, scegli un account e fai clic su Continua.

5. Torna all'assistente AI. L'agente elaborerà ora la tua richiesta utilizzando il server appena autenticato.

Autenticarsi utilizzando una chiave API

Questa sezione ti guida nella procedura di autenticazione della tua applicazione AI con il server MCP per Developer Knowledge utilizzando una chiave API.

Passaggio 1: crea una chiave API

Puoi generare una chiave API Developer Knowledge nel tuo progetto Google Cloud utilizzando la console Google Cloud o gcloud CLI:

Google Cloud Console

Abilita l'API

1. Apri la pagina dell'API Developer Knowledge nella libreria delle API di Google.
2. Verifica di aver selezionato il progetto corretto in cui intendi utilizzare l'API.
3. Fai clic su Abilita. Non sono necessari ruoli IAM specifici per abilitare o utilizzare l' API.

Crea e proteggi la chiave API

1. Nella console Google Cloud per il progetto in cui hai abilitato l'API, vai alla pagina Credenziali.
2. Fai clic su Crea credenziali e seleziona Chiave API dal menu. La finestra di dialogo Chiave API creata mostra la stringa della chiave appena creata.
3. Fai clic su Modifica chiave API.
4. Nel campo Nome, fornisci un nome per la chiave.
5. In Restrizioni delle API, seleziona Limita chiave.
6. Nell'elenco Seleziona API, abilita API Developer Knowledge e fai clic su OK.
   • Nota: se hai appena abilitato l'API Developer Knowledge, potrebbe esserci un ritardo prima che venga visualizzata nell'elenco Seleziona API.
7. Fai clic su Salva.

Dopo aver creato la chiave, fai clic su Mostra chiave per visualizzarla. Prendi nota per utilizzarla durante la configurazione dell'applicazione AI.

gcloud CLI

1. Se non l'hai ancora fatto, scarica e installa gcloud CLI.

2. Abilita l'API Developer Knowledge, sostituendo PROJECT_ID con il tuo ID progetto Google Cloud:

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

3. Crea una chiave API utilizzando lo stesso ID progetto Google Cloud:

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

   Questo comando restituisce una stringa della chiave API. Prendi nota per utilizzarla durante la configurazione dell'applicazione AI.

4. Proteggi la chiave API aggiungendo limitazioni relative alle chiavi API. Per una maggiore sicurezza, limita la chiave API all'API Developer Knowledge.

Nota: l'utilizzo della quota della chiave API privata può essere visualizzato e gestito accedendo alla pagina IAM e amministrazione > Quote e limiti di sistema nella console Google Cloud, selezionando Servizio e poi API Developer Knowledge nel campo del filtro.

Passaggio 2: abilita il server MCP per Developer Knowledge in un progetto

Nota: dopo il 17 marzo, il server MCP per Developer Knowledge viene abilitato automaticamente quando abiliti l'API Developer Knowledge.

Per abilitare il server MCP per Developer Knowledge nel tuo progetto Google Cloud, scarica e installa gcloud CLI, quindi esegui il comando seguente, sostituendo PROJECT_ID con l'ID progetto Google Cloud:

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

Se il servizio Developer Knowledge non è abilitato per il tuo progetto Google Cloud, ti verrà chiesto di abilitarlo prima di abilitare il server MCP remoto.

Come best practice di sicurezza, ti consigliamo di abilitare i server MCP solo per i servizi necessari al funzionamento dell'applicazione AI.

Suggerimento: se si verifica un errore durante l'esecuzione del comando gcloud, esegui gcloud components update beta per aggiornare i componenti e riprova.

Passaggio 3: configura l'applicazione AI

Configura le applicazioni AI più diffuse utilizzando queste istruzioni. Sostituisci YOUR_API_KEY con la chiave API Developer Knowledge che hai generato in nel passaggio precedente:

Gemini CLI

Per configurare Gemini CLI, esegui il comando seguente:

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

In alternativa, modifica o crea uno dei seguenti file di configurazione:

• Nel tuo progetto: .gemini/settings.json
• Nella tua home directory: ~/.gemini/settings.json

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

Gemini Code Assist

Per configurare Gemini Code Assist, modifica o crea uno dei seguenti file di configurazione:

• Nel tuo progetto: .gemini/settings.json
• Nella tua home directory: ~/.gemini/settings.json

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

Claude Code

Per configurare Claude Code, esegui il comando seguente nella cartella dell'app.

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

Cursore

Per configurare Cursor, modifica .cursor/mcp.json (per un progetto specifico) o ~/.cursor/mcp.json (per tutti i progetti).

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

GitHub Copilot

Per configurare GitHub Copilot in VS Code per un singolo progetto, modifica il file .vscode/mcp.json nell'area di lavoro.

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

Per rendere disponibile il server in ogni progetto, modifica le impostazioni utente. Fai clic sul pulsante Apri impostazioni (JSON).

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

Windsurf

Per configurare Windsurf Editor, modifica il file ~/.codeium/windsurf/mcp_config.json.

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

Verifica installazione

Una volta configurata, apri l'applicazione AI e inserisci un prompt come:

How do I list Cloud Storage buckets?

Se vedi una chiamata allo strumento search_documents o a un altro strumento del server MCP per Developer Knowledge, il server funziona correttamente.

Gestisci l'utilizzo dei token

Il recupero dei contenuti dei documenti, soprattutto quando utilizzi batch_get_documents, consuma token nella finestra contestuale dell'applicazione AI. Poiché alcune pagine della documentazione per sviluppatori di Google sono piuttosto grandi, il recupero di più documenti può comportare rapidamente costi più elevati, tempi di risposta del modello più lenti e overflow della finestra contestuale.

Per ottimizzare le prestazioni ed evitare una fattura imprevista, crea prompt specifici che prendano di mira solo le informazioni di cui hai bisogno. Evita richieste generiche (ad esempio, "Confronta tutti i prodotti Firebase") che costringano l'agente a importare enormi quantità di dati contemporaneamente.

Documentazione inclusa

Per informazioni sui documenti cercati dal server, consulta la documentazione di riferimento del corpus.

Limitazioni note

• Ambito dei contenuti: sono incluse solo le pagine visibili pubblicamente nella documentazione di riferimento del corpus. I contenuti di altre fonti come GitHub, siti OSS, blog o YouTube non sono inclusi.
• Risultati solo in inglese: il server supporta solo i risultati in inglese.
• Dipendente dalla rete: gli strumenti del server si basano sui servizi Google Cloud attivi. Se riscontri errori persistenti, controlla la connessione a internet e la configurazione della chiave API Developer Knowledge.

Risoluzione dei problemi

Se riscontri problemi, verifica quanto segue:

• Il file di configurazione MCP per lo strumento AI è formattato correttamente.
• Se utilizzi il metodo di autenticazione API, hai utilizzato una chiave API Developer Knowledge valida nel file di configurazione che ha l'API Developer Knowledge abilitata.
• Non hai esaurito la quota dell'API Developer Knowledge.

Model Armor

Se utilizzi Model Armor per proteggere la tua applicazione, potresti riscontrare errori 403 PERMISSION_DENIED per alcune query. Poiché il server MCP per Developer Knowledge restituisce solo la documentazione pubblica da fonti Google attendibili, ti consigliamo di impostare i filtri di iniezione di prompt e jailbreak (PIJB) su livelli di attendibilità HIGH_AND_ABOVE per ridurre i falsi positivi. Se il tuo caso d'uso non prevede altri strumenti che accedono a dati privati o sensibili, puoi anche disattivare i filtri PIJB.