Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Connettiti al server MCP per Developer Knowledge

Il server MCP Google Developer Knowledge offre agli strumenti di sviluppo basati sull'AI l'accesso diretto per cercare e recuperare la documentazione ufficiale per sviluppatori Google per prodotti come Firebase, Google Cloud, Android, Google Maps Platform e altri. Se colleghi il tuo assistente alla programmazione alla libreria autorevole di documentazione di Google, eviti ricerche web manuali, contesto obsoleto e scraping.

Funzionalità del server MCP

Il server MCP di Google Developer Knowledge fornisce tre strumenti principali all'assistente di programmazione AI:

Nome strumento	Descrizione
`search_documents`	Cerca nella documentazione per sviluppatori di Google e restituisce gli estratti di pagina più pertinenti insieme ai nomi dei documenti.
`get_documents`	Recupera l'intero contenuto Markdown dei documenti utilizzando i nomi restituiti da `search_documents`.
`answer_query`	Genera risposte strutturate tratte dal corpus di conoscenze per gli sviluppatori.

Lo strumento search_documents esegue ricerche nella documentazione di Google per trovare le sezioni più pertinenti che corrispondono alla tua query. Quando fai una domanda, lo strumento restituisce brevi passaggi di testo. Se l'agente ha bisogno del contesto completo della pagina che circonda un passaggio, può passare il nome della risorsa del documento a get_documents per recuperare l'intera pagina.

Utilizza lo strumento answer_query quando vuoi una risposta diretta a una domanda tratta dal corpus di conoscenze per sviluppatori anziché risultati di ricerca non elaborati o file Markdown completi.

Scegliere il metodo di autenticazione

Il server MCP per Developer Knowledge supporta due approcci di autenticazione a seconda dell'ambiente di sviluppo e dell'assistente AI:

Chiave API: ideale per IDE e agenti CLI di terze parti come Claude Code, Cursor, GitHub Copilot, Codex e altri client MCP remoti. Trasmetti la chiave API nell'intestazione X-Goog-Api-Key tramite HTTPS.
OAuth e ADC: ideale per Google Antigravity, che supporta le credenziali predefinite dell'applicazione (ADC), o per i flussi di lavoro aziendali che richiedono un token di autenticazione OAuth 2.0 o un ID client OAuth 2.0 autonomo anziché una chiave API.

Genera le credenziali richieste per il metodo di autenticazione scelto per consentire all'assistente AI o all'agente di codifica di autenticare le richieste con il servizio del server MCP Developer Knowledge.

Seleziona una scheda per creare le tue credenziali:

Chiave API

Prerequisiti

Prima di creare una chiave API, assicurati di disporre di:

Un progetto Google Cloud.
gcloud CLI installato (se la configurazione viene eseguita dalla riga di comando).

Abilitare l'API e creare una chiave API

Puoi generare una chiave API utilizzando la console Google Cloud o gcloud CLI:

Google Cloud Console

Apri la pagina dell'API Developer Knowledge nella console Google Cloud.
Seleziona il tuo progetto Google Cloud e fai clic su Attiva.
Vai alla pagina Credenziali.
Fai clic su Crea credenziali e seleziona Chiave API.
Fai clic sull'azione Modifica chiave API per configurare le limitazioni:
- In Restrizioni delle API, scegli Limita chiave.
- Seleziona API Developer Knowledge.
- Se prevedi di utilizzare la stessa chiave per le chiamate di modelli (ad esempio GEMINI_API_KEY), seleziona anche API Generative Language.
Fai clic su Salva e poi copia la chiave API.

gcloud CLI

Attiva l'API Developer Knowledge nel tuo progetto, sostituendo PROJECT_ID con il tuo ID progetto:
```
gcloud services enable developerknowledge.googleapis.com \
  --project=PROJECT_ID
```
Crea una chiave API:
```
gcloud services api-keys create \
  --project=PROJECT_ID \
  --display-name="DK API Key"
```
Questo comando restituisce i dettagli dei metadati della nuova chiave. Copia e salva entrambi i seguenti valori dall'output comando:
- keyString: questa è la chiave API non elaborata (ad esempio, AIzaSy...). Devi incollare questo valore nella configurazione dell'IDE.
- name: il percorso della risorsa della chiave (ad esempio, projects/PROJECT_ID/locations/global/keys/UNIQUE_ID). Utilizzerai questo percorso per limitare la chiave nel passaggio successivo.
Limita la chiave all'API Developer Knowledge per impedire l'utilizzo non autorizzato. Sostituisci KEY_NAME con il percorso completo di name copiato dal passaggio precedente:
```
gcloud services api-keys update KEY_NAME \
  --api-target=service=developerknowledge.googleapis.com
```
Importante: se prevedi di utilizzare questa stessa chiave per le chiamate al modello generale del tuo client AI (ad esempio GEMINI_API_KEY), devi anche consentire l'API Generative Language:
```
gcloud services api-keys update KEY_NAME \
  --api-target=service=developerknowledge.googleapis.com \
  --api-target=service=generativelanguage.googleapis.com
```

OAuth e ADC

Prerequisiti

Prima di configurare OAuth o ADC, assicurati di avere:

Abilita l'API

Esegui questo comando per abilitare l'API Developer Knowledge nel tuo progetto:

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

Scegli il tipo di credenziali OAuth

Seleziona l'approccio alle credenziali richiesto dallo strumento:

ADC

Google Antigravity supporta ADC e aggiorna i token automaticamente. Altri client MCP possono utilizzare ADC passando un token di tipo bearer di breve durata nell'intestazione Authorization:

Autenticati con il tuo Account Google e imposta il progetto di quota:

gcloud auth application-default login \
  --project=PROJECT_ID

Quando si apre il browser, accedi con il tuo Account Google e concedi le autorizzazioni richieste.
(Facoltativo) Se stai configurando un client MCP di terze parti che non supporta ADC integrato, genera un token di autenticazione (valido per un'ora) da utilizzare nell'intestazione Authorization del client:
```
gcloud auth application-default print-access-token
```

ID client OAuth

Crea un ID client e un client secret OAuth 2.0 se l'assistente AI utilizza un flusso OAuth interattivo perché i server MCP remoti di Google non supportano la registrazione dinamica dei client (DCR) OAuth.

Vai alla pagina Brand e seleziona il tuo progetto. Inserisci un Nome app e un'Email per assistenza utenti, quindi fai clic su Salva.
Vai alla pagina Pubblico e imposta il Tipo di utente su Esterno.
Nella stessa pagina, fai clic su Aggiungi utenti in Utenti di test, inserisci il tuo indirizzo email Google e fai clic su Salva.
Vai alla pagina Client, fai clic su Crea client e scegli il tipo di applicazione richiesto dal client MCP:
- Seleziona App desktop per i client desktop che richiedono un ID client e un secret (ad esempio VS Code).
- Seleziona Applicazione web e aggiungi l'URI di reindirizzamento del tuo client per i client che richiedono callback di reindirizzamento OAuth statici (ad esempio connettori personalizzati di Cursor o Claude Code). Utilizza l'URI di reindirizzamento esatto documentato dal client; gli URI di reindirizzamento personalizzati non sono supportati. Per gli URI di reindirizzamento specifici del client, consulta Configurare MCP in un'applicazione AI.
Fai clic su Crea, poi copia l'ID client e il secret client (o scarica il file JSON delle credenziali client).

Configura l'IDE o l'agente di programmazione

Dopo aver ottenuto le credenziali, segui le istruzioni di configurazione per il tuo ambiente di programmazione. Le istruzioni per ogni ambiente di codifica supportano i seguenti metodi di autenticazione:

Ambiente di programmazione	Metodi di autenticazione
Google Antigravity	Credenziali Google integrate (ADC) o chiave API
Claude Code, Cursor, GitHub Copilot, Codex	Chiave API
Altro	Chiave API, token bearer ADC o ID client OAuth 2.0

Per utilizzare un token di autenticazione ADC o un ID client OAuth 2.0 con Claude Code, Cursor, GitHub Copilot o Codex, segui le istruzioni nella scheda Altro.

A seconda del modello che utilizzi, sostituisci i seguenti segnaposto:

Chiave API (YOUR_API_KEY): sostituisci con la stringa della chiave API non elaborata.
ID progetto (PROJECT_ID): sostituisci con l'ID del tuo progetto Google Cloud.
Token di accesso (ACCESS_TOKEN): sostituisci con il token di tipo Bearer di gcloud auth application-default print-access-token.

Google Antigravity

Antigravity IDE ed estensioni

Per configurare il server MCP nell'IDE Antigravity o nell'estensione Antigravity (ad esempio in VS Code), seleziona il metodo di autenticazione:

Credenziali Google

Per installare il server MCP utilizzando la configurazione con un solo clic:

Nel riquadro Agente, fai clic sul menu Altre opzioni () e seleziona Server MCP.
Cerca Google Developer Knowledge.
Fai clic sull'icona Installa (). Antigravity configura automaticamente il server e si connette utilizzando le tue credenziali Google attive.

Chiave API

Per configurare una chiave API in Antigravity IDE o nell'estensione Antigravity:

Nel riquadro Agente, fai clic sul menu Opzioni aggiuntive () > Server MCP > Gestisci server MCP > Visualizza configurazione non elaborata (o apri .agents/mcp_config.json).

Aggiungi la seguente configurazione del server:

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

Antigravity CLI

Configura il server MCP nel file .agents/mcp_config.json del tuo progetto (o a livello globale in ~/.gemini/config/mcp_config.json):

Credenziali Google

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

Chiave API

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

Claude Code

Esegui questo comando nel terminale:

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

Cursore

Per configurare Cursor, modifica .cursor/mcp.json nella radice del progetto o ~/.cursor/mcp.json per l'accesso globale:

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

GitHub Copilot

Impostazioni di Workspace

Per configurare GitHub Copilot in VS Code per uno spazio di lavoro specifico, crea o modifica .vscode/mcp.json:

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

Impostazioni utente globali

Per rendere il server disponibile in tutti gli spazi di lavoro VS Code, apri la tavolozza dei comandi, esegui MCP: Open User Configuration e aggiungi quanto segue al file mcp.json nel tuo profilo utente:

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

Codex

Per configurare la CLI Codex o l'agente Codex, aggiungi la configurazione del server a ~/.codex/config.toml (o al .codex/config.toml del tuo progetto):

[mcp_servers.google-developer-knowledge]
  url = "https://developerknowledge.googleapis.com/mcp"
  http_headers = { "X-Goog-Api-Key" = "YOUR_API_KEY" }

Altro

Per configurare qualsiasi altro client MCP remoto (come JetBrains AI Assistant, Windsurf, Cline, Zed, Continue o Claude Desktop) o per utilizzare un token ADC o un ID client OAuth 2.0 in un client di terze parti, seleziona il metodo di autenticazione:

Chiave API

Configura un server di trasporto HTTP con le seguenti impostazioni:

URL server: https://developerknowledge.googleapis.com/mcp
Intestazione HTTP: X-Goog-Api-Key: YOUR_API_KEY

Template di configurazione JSON standard:

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

Token di connessione ADC

Se il tuo client MCP non supporta ADC integrato, puoi autenticarti con ADC passando il token di autenticazione da gcloud auth application-default print-access-token e il tuo ID progetto Google Cloud nelle intestazioni della richiesta:

{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp",
      "headers": {
        "Authorization": "Bearer ACCESS_TOKEN",
        "X-Goog-User-Project": "PROJECT_ID"
      }
    }
  }
}

L'intestazione X-Goog-User-Project richiede l'autorizzazione serviceusage.services.use per il progetto. I proprietari e gli editor del progetto dispongono di questa autorizzazione. Gli altri utenti hanno bisogno di un ruolo che lo includa, ad esempio Service Usage Consumer (roles/serviceusage.serviceUsageConsumer).

ID client OAuth

Per l'autenticazione utilizzando un ID client e un client secret OAuth 2.0 autonomi:

Aggiungi l'endpoint del server MCP alla configurazione del client senza un'intestazione della chiave API:
```
{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp"
    }
  }
}
```
Nota: VS Code utilizza una chiave servers di primo livello anziché mcpServers. Aggiungi il server a .vscode/mcp.json nella cartella che apri come workspace oppure esegui MCP: Open User Configuration dalla tavolozza dei comandi per renderlo disponibile in tutti i workspace. Per la struttura dei file di VS Code, fai riferimento alla scheda GitHub Copilot e ometti la sezione headers.
Completa la configurazione di OAuth per il tuo cliente:
- Prompt interattivo (ad esempio VS Code): invia un prompt di test all'agente. Quando viene visualizzato un messaggio che indica che la Dynamic Client Registration non è supportata, procedi e inserisci l'ID client e il secret client, poi accedi con il tuo Account Google.
- Configurazione OAuth statica (ad esempio Cursor o Claude Code): fornisci l'ID client OAuth, il client secret e l'URI di reindirizzamento nelle impostazioni OAuth del client. Per istruzioni specifiche per il cliente, consulta Configurare MCP in un'applicazione AI.
Se il cliente ti chiede di specificare gli ambiti OAuth, utilizza https://www.googleapis.com/auth/devprofiles.full_control.

Non devi specificare un ID progetto Google Cloud in questa configurazione. Le richieste vengono attribuite al progetto proprietario del tuo ID client OAuth.

Verifica la connessione

Una volta configurato, riavvia l'assistente AI o ricarica i relativi server MCP. Quindi invia un prompt di test per verificare che l'integrazione dello strumento funzioni:

How do I list Cloud Storage buckets using the Google Cloud Python SDK?

Se l'agente richiama search_documents o answer_query e restituisce informazioni dalla documentazione di Google, il tuo server è connesso e attivo.

Utilizzare la skill dell'agente Developer Knowledge

Installa la skill agente retrieving-developer-knowledge ufficiale per insegnare all'assistente quando e come utilizzare gli strumenti principali offerti dal server MCP per Developer Knowledge.

Una competenza dell'agente è un insieme di istruzioni che l'assistente di programmazione AI legge prima di iniziare un'attività. La skill retrieving-developer-knowledge funziona con qualsiasi assistente che supporta lo standard Open Agent Skills e aiuta l'assistente a svolgere le seguenti operazioni:

Scegli lo strumento giusto: guida l'assistente a utilizzare answer_query per domande e confronti generici su "come fare" e search_documents (con due o cinque parole chiave mirate) quando cerchi flag CLI esatti, autorizzazioni IAM o sintassi del codice.
Controlla la presenza di errori prima di rispondere: indica all'assistente di assicurarsi che una ricerca nella documentazione sia andata a buon fine prima di scrivere una risposta, in modo che non confonda un errore di quota o chiave API con la documentazione mancante o non ricorra a ipotesi basate su dati di addestramento precedenti.
Esegui il fallback all'API REST: fornisce all'assistente comandi curl per chiamare direttamente l'API Developer Knowledge se l'editor non supporta i server MCP o se la connessione MCP non va a buon fine.

Installare la skill dell'agente

Seleziona l'assistente alla programmazione per installare l'abilità retrieving-developer-knowledge nella directory del progetto:

Google Antigravity

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=antigravity

Claude Code

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=claude-code

Cursore

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=cursor

Codex

npx skills add google/skills --skill retrieving-developer-knowledge \
  --agent=codex

Altro

Per altri assistenti AI che supportano lo standard aperto delle competenze degli agenti, esegui:

npx skills add google/skills --skill retrieving-developer-knowledge

Per aggiornare le skill installate all'ultima versione, esegui:

npx skills update

Per visualizzare le istruzioni complete e le guide di riferimento per le skill, consulta la directory retrieving-developer-knowledge su GitHub.

Ottimizzare la finestra contestuale e l'utilizzo dei token

Il recupero di pagine di documentazione complete nella finestra contestuale di un modello di AI consuma un numero significativo di token. L'importazione di più documenti di grandi dimensioni può causare costi elevati dei token, aumento della latenza e overflow della finestra contestuale.

Per garantire risposte rapide ed economiche, segui queste best practice di prompt engineering:

Installa la skill dell'agente (consigliato): installa la skill dell'agente retrieving-developer-knowledge in modo che l'assistente scelga automaticamente lo strumento di ricerca giusto (answer_query o search_documents), utilizzi ricerche di parole chiave brevi e scarichi pagine complete solo quando necessario.
Affidati al recupero in due passaggi: consenti all'agente di iniziare chiamando il numero search_documents. Restituisce snippet (blocchi) mirati che spesso contengono la sintassi o la firma API esatta di cui hai bisogno senza consumare token per l'intera pagina. Chiedi all'agente di chiamare get_documents solo quando il contesto circostante è strettamente necessario.
Preferisci answer_query per le domande concettuali: quando hai bisogno di una spiegazione generata o di un confronto tra design, chiedi all'agente di utilizzare answer_query. Questo strumento genera una risposta direttamente dal corpus di conoscenze per sviluppatori senza restituire pagine Markdown non elaborate complete.
Scrivi prompt specifici e mirati: evita prompt troppo generici come "Spiega tutto Firebase". Specifica invece il prodotto, la piattaforma e la lingua di destinazione:
```
How do I write a Firestore transaction in Dart with error handling?
```
Aggiungi regole personalizzate per l'agente: se non utilizzi l'intent retrieving-developer-knowledge, aggiungi linee guida a livello di progetto ai file di istruzioni dell'assistente (ad esempio .cursorrules, CLAUDE.md o .github/copilot-instructions.md) per limitare il recupero automatico delle pagine intere:
```
When searching Google developer documentation, inspect search_documents
snippets first. Do not call get_documents unless the snippet lacks
necessary code context.
```

Configurazioni di sicurezza e protezione facoltative

MCP introduce nuovi rischi e considerazioni sulla sicurezza a causa dell'ampia varietà di azioni che puoi eseguire con gli strumenti MCP. Per ridurre al minimo e gestire questi rischi, Google Cloud offre impostazioni predefinite e policy personalizzabili per controllare l'utilizzo degli strumenti MCP nella tua organizzazione o nel tuo progetto Google Cloud.

Per saperne di più sulla sicurezza e sulla governance di MCP, consulta Sicurezza e protezione dell'AI.

Utilizzare Model Armor

Model Armor è un servizio Google Cloud progettato per migliorare la sicurezza delle applicazioni di AI. Funziona analizzando in modo proattivo i prompt e le risposte degli LLM, proteggendo da vari rischi e supportando pratiche di AI responsabile. Che tu stia implementando l'AI nel tuo ambiente cloud o su provider cloud esterni, Model Armor può aiutarti a prevenire input dannosi, verificare la sicurezza dei contenuti, proteggere i dati sensibili, mantenere la conformità e applicare le tue norme di sicurezza dell'AI in modo coerente nel tuo panorama AI diversificato.

Quando Model Armor è abilitato con il logging abilitato, Model Armor registra l'intero payload. Ciò potrebbe esporre informazioni sensibili nei log.

Routing delle richieste MCP a Model Armor

Model Armor è disponibile in determinate regioni. Quando Model Armor è abilitato e utilizzi un server MCP in una giurisdizione che Model Armor non supporta, il comportamento di routing della chiamata potrebbe essere diverso per i diversi server MCP e potrebbe violare la conformità alla residenza dei dati per i dati in uso e in transito. Per saperne di più sul comportamento dei singoli server MCP, consulta Prodotti supportati da Model Armor.

Abilita Model Armor

Segui i passaggi descritti in Esegui l'integrazione con i server MCP di Google e Google Cloud per abilitare Model Armor.

Configurare la protezione per i server MCP remoti

Per proteggere le chiamate e le risposte allo strumento MCP, puoi utilizzare le impostazioni di base di Model Armor. Un'impostazione di base definisce i filtri di sicurezza minimi che vengono applicati a tutto il progetto. Questa configurazione applica un insieme coerente di filtri a tutte le chiamate e le risposte dello strumento MCP all'interno del progetto.

Configura un'impostazione di base di Model Armor con la sanificazione MCP attivata. Per saperne di più, consulta Configurare le impostazioni di base di Model Armor.

Vedi il seguente comando di esempio:

gcloud model-armor floorsettings update \
--full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
--enable-floor-setting-enforcement=TRUE \
--add-integrated-services=GOOGLE_MCP_SERVER \
--google-mcp-server-enforcement-type=INSPECT_AND_BLOCK \
--enable-google-mcp-server-cloud-logging \
--malicious-uri-filter-settings-enforcement=ENABLED \
--add-rai-settings-filters='[{"confidenceLevel": "MEDIUM_AND_ABOVE", "filterType": "DANGEROUS"}]'

Sostituisci PROJECT_ID con l'ID progetto Google Cloud.

Tieni presente le seguenti impostazioni:

INSPECT_AND_BLOCK: il tipo di applicazione che ispeziona i contenuti per il server MCP di Google e blocca i prompt e le risposte che corrispondono ai filtri.
ENABLED: l'impostazione che attiva un filtro o l'applicazione.
MEDIUM_AND_ABOVE: il livello di confidenza per le impostazioni del filtro AI responsabile - Pericoloso. Puoi modificare questa impostazione, anche se valori inferiori potrebbero comportare un maggior numero di falsi positivi. Per saperne di più, consulta Livelli di confidenza di Model Armor.

Disabilita l'analisi del traffico MCP con Model Armor

Per impedire a Model Armor di analizzare automaticamente il traffico da e verso i server MCP di Google in base alle impostazioni di base del progetto, esegui questo comando:

gcloud model-armor floorsettings update \
  --full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
  --remove-integrated-services=GOOGLE_MCP_SERVER

Sostituisci PROJECT_ID con l'ID progetto Google Cloud. Model Armor non applica automaticamente le regole definite nelle impostazioni di base di questo progetto a nessun traffico del server Google MCP.

Le impostazioni di base di Model Armor e la configurazione generale possono influire su più di un solo MCP. Poiché Model Armor si integra con servizi come Vertex AI, qualsiasi modifica apportata alle impostazioni di base può influire sulla scansione del traffico e sui comportamenti di sicurezza in tutti i servizi integrati, non solo in MCP.

Modificare le impostazioni di Model Armor

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

Risoluzione dei problemi

Se riscontri problemi di connessione o di query al server MCP di Developer Knowledge, individua il tuo sintomo o messaggio di errore nelle tabelle seguenti.

Errori di configurazione e connessione

Sintomo o errore	Probabile causa	Risoluzione
`404 NOT_FOUND` sull'endpoint `/mcp`	L'API non è abilitata per il tuo progetto.	Abilita l'API Developer Knowledge nella console Google Cloud o esegui `gcloud services enable developerknowledge.googleapis.com`.
`403 PERMISSION_DENIED`: `Developer Knowledge API has not been used`	L'API Developer Knowledge non è abilitata nel progetto Google Cloud.	Abilita l'API nella console Google Cloud o esegui `gcloud services enable developerknowledge.googleapis.com`.
Strumenti MCP mancanti o connessione non riuscita	Il tuo strumento di codifica non supporta i server MCP HTTP remoti o non riesce a connettersi al server.	Installa la skill dell'agente `retrieving-developer-knowledge`, che indica all'assistente come eseguire il fallback agli endpoint REST dell'API Developer Knowledge utilizzando `curl` quando gli strumenti MCP non sono disponibili.

Errori della chiave API

Sintomo o errore	Probabile causa	Risoluzione
`400 Bad Request: API key not valid`	La stringa della chiave API è mancante, non valida o in un formato non corretto.	Verifica che la chiave API sia stata copiata correttamente e configurata nell'oggetto `headers` con la chiave `X-Goog-Api-Key`. Non passare la chiave API come parametro di query nell'URL.
`403 PERMISSION_DENIED: API target restriction`	L'elenco delle limitazioni delle chiavi API esclude l'API Developer Knowledge.	Aggiorna le limitazioni della chiave API nella pagina Credenziali della console Google Cloud per includere l'API Developer Knowledge.

Errori OAuth e ADC

Sintomo o errore	Probabile causa	Risoluzione
`401 UNAUTHENTICATED` o credenziali ADC mancanti	I token di autenticazione di tipo bearer delle credenziali predefinite dell'applicazione o ADC sono scaduti o non sono inizializzati.	Esegui `gcloud auth application-default login --project=PROJECT_ID` per aggiornare le credenziali locali oppure esegui `gcloud auth application-default print-access-token` per generare un nuovo token di autenticazione.
`403 PERMISSION_DENIED`: `API requires a quota project, which is not set by default`	La richiesta utilizza un token bearer ADC senza un intestazione `X-Goog-User-Project`.	Aggiungi l'intestazione `X-Goog-User-Project` con il tuo ID progetto Google Cloud alla configurazione del client MCP.
`403 PERMISSION_DENIED` con un'intestazione `X-Goog-User-Project`	Il tuo account non dispone dell'autorizzazione `serviceusage.services.use` per il progetto nell'intestazione.	Chiedi a un amministratore del progetto di concederti il ruolo Service Usage Consumer (`roles/serviceusage.serviceUsageConsumer`).
`403 access_denied` / "Accesso bloccato: errore di autorizzazione"	La schermata per il consenso OAuth utilizza il tipo di utente Esterno in modalità di test e il tuo account non è elencato come utente di prova.	Nella console Google Cloud > Auth Platform > Pubblico, aggiungi il tuo indirizzo email Google attivo in Utenti di test.
Errore del client OAuth o URI di reindirizzamento non valido	Il client OAuth è stato creato con un tipo di applicazione non supportato o con un URI di reindirizzamento mancante.	Utilizza l'app desktop per i client con prompt interattivi (come VS Code) o l'applicazione web con l'URI di reindirizzamento autorizzato del client (come Cursor o Claude Code).

Errori relativi a quota e filtro di sicurezza

Sintomo o errore	Probabile causa	Risoluzione
`429 RESOURCE_EXHAUSTED`	Hai raggiunto il limite di quota del tuo progetto.	Controlla l'utilizzo nella pagina delle quote dell'API Developer Knowledge nella console Google Cloud. Per informazioni sui limiti e per richiedere un aumento, consulta Quota dell'API Developer Knowledge.
`403 PERMISSION_DENIED` con Model Armor	Un falso positivo del filtro PIJB di Model Armor ha bloccato una query sicura.	Imposta l'affidabilità del filtro PIJB su `HIGH_AND_ABOVE` nelle impostazioni del modello Model Armor.

Documentazione inclusa

Consulta il riferimento al corpus per l'elenco completo dei prodotti Google e dei repository di documentazione indicizzati dal server.

Limitazioni note

Solo documentazione pubblica: il server indicizza solo la documentazione disponibile pubblicamente elencata nel riferimento del corpus. Documenti interni, repository privati e risorse di terze parti non sono inclusi.
Lingua inglese: il server indicizza e restituisce la documentazione solo in inglese.
Dipendenza di rete e Controlli di servizio VPC: poiché il server MCP Developer Knowledge è un servizio ospitato remoto, il client deve disporre della connettività di rete per raggiungere https://developerknowledge.googleapis.com.
- All'interno delle reti VPC Google Cloud: il traffico in uscita da internet pubblico non è obbligatorio. Puoi raggiungere developerknowledge.googleapis.com in privato senza indirizzi IP esterni o Cloud NAT instradando il traffico utilizzando l'accesso privato Google (private.googleapis.com / 199.36.153.8/30) o un endpoint Private Service Connect (PSC) che ha come target il bundle all-apis.
- Controlli di servizio VPC (VPC-SC): developerknowledge.googleapis.com non è supportato sul VIP con limitazioni (restricted.googleapis.com / 199.36.153.4/30) o sugli endpoint PSC vpc-sc. Se le route VPC *.googleapis.com a restricted.googleapis.com, configura un criterio di risposta Cloud DNS o un record DNS privato specifico per developerknowledge.googleapis.com da risolvere in private.googleapis.com (199.36.153.8/30).

Connettiti al server MCP per Developer Knowledge Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Funzionalità del server MCP

Scegliere il metodo di autenticazione

Chiave API

Prerequisiti

Abilitare l'API e creare una chiave API

Google Cloud Console

gcloud CLI

OAuth e ADC

Prerequisiti

Abilita l'API

Scegli il tipo di credenziali OAuth

ADC

ID client OAuth

Configura l'IDE o l'agente di programmazione

Google Antigravity

Antigravity IDE ed estensioni

Credenziali Google

Chiave API

Antigravity CLI

Credenziali Google

Chiave API

Claude Code

Cursore

GitHub Copilot

Impostazioni di Workspace

Impostazioni utente globali

Codex

Altro

Chiave API

Token di connessione ADC

ID client OAuth

Verifica la connessione

Utilizzare la skill dell'agente Developer Knowledge

Installare la skill dell'agente

Google Antigravity

Claude Code

Cursore

Codex

Altro

Ottimizzare la finestra contestuale e l'utilizzo dei token

Configurazioni di sicurezza e protezione facoltative

Utilizzare Model Armor

Routing delle richieste MCP a Model Armor

Abilita Model Armor

Configurare la protezione per i server MCP remoti

Disabilita l'analisi del traffico MCP con Model Armor

Modificare le impostazioni di Model Armor

Risoluzione dei problemi

Errori di configurazione e connessione

Errori della chiave API

Errori OAuth e ADC

Errori relativi a quota e filtro di sicurezza

Documentazione inclusa

Limitazioni note

Connettiti al server MCP per Developer Knowledge