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 per sviluppatori basati sull'AI l'accesso diretto alla ricerca e al recupero della documentazione per lo sviluppo ufficiale per i prodotti Google come Firebase, Google Cloud, Android, Google Maps Platform e altri ancora. Se colleghi l'assistenza al coding alla libreria autorevole di documentazione di Google, eviti ricerche web manuali, contesto obsoleto e scraping.

Per connetterti al server MCP Developer Knowledge dal tuo codice di applicazione o agente anziché da un IDE, consulta Connettersi utilizzando gli SDK MCP.

Funzionalità del server MCP

Il server MCP di Google Developer Knowledge fornisce tre strumenti principali al tuo assistente di programmazione AI:

Nome strumento	Descrizione
`search_documents`	Cerca nella documentazione per lo sviluppo 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 corrispondenti 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 gli 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 di terze parti e agenti CLI 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: ideali per Google Antigravity, che dispone di un supporto integrato per le Credenziali predefinite dell'applicazione (ADC), o per i workflow aziendali che richiedono un token di connessione 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 restrizioni:
- In Restrizioni delle API, scegli Limita chiave.
- Seleziona API Developer Knowledge.
- Se prevedi di utilizzare questa stessa chiave per le chiamate ai modelli (ad esempio GEMINI_API_KEY), seleziona anche API Generative Language.
Fai clic su Salva e poi copia la chiave API.

gcloud CLI

Abilita l'API Developer Knowledge nel tuo progetto, sostituendo PROJECT_ID con l'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 relativi alla nuova chiave. Copia e salva entrambi i seguenti valori dall'output comando:
- keyString: questa è la chiave API non elaborata (ad esempio, AIzaSy...). Incollerai 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 ha il supporto integrato per ADC e aggiorna automaticamente i token di aggiornamento. Altri client MCP possono utilizzare ADC passando un token di connessione di breve durata nell'intestazione Authorization:

Esegui l'autenticazione 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 connessione (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 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 Configura MCP in un'applicazione di AI.
Fai clic su Crea, quindi copia l'ID client e il client secret (oppure scarica il file delle credenziali client JSON).

Ambiti OAuth

Il server MCP per Developer Knowledge accetta i seguenti ambiti OAuth:

https://www.googleapis.com/auth/cloud-platform: ambito predefinito utilizzato dalle credenziali predefinite dell'applicazione (ADC) e da gcloud CLI.
https://www.googleapis.com/auth/devprofiles.full_control: ambito utilizzato per i flussi di consenso dell'ID client OAuth 2.0 e l'individuazione del server MCP.
https://www.googleapis.com/auth/developerprofiles.readonly: ambito di sola lettura supportato per gli account di servizio e le credenziali che non richiedono una schermata per il consenso OAuth dell'utente finale.

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 di connessione ADC o ID client OAuth 2.0

Per utilizzare un token di connessione 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 template utilizzato, 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 progetto Google Cloud.
Token di accesso (ACCESS_TOKEN): sostituisci con il token di connessione 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 Opzioni aggiuntive () 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 dell'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 directory principale 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 un workspace 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 i workspace di 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 di connessione 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 del server: https://developerknowledge.googleapis.com/mcp
Intestazione HTTP: X-Goog-Api-Key: YOUR_API_KEY

Modello 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 dispone del supporto ADC integrato, puoi eseguire l'autenticazione con ADC passando il token di connessione da gcloud auth application-default print-access-token e l'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 sul progetto. I proprietari e gli editor del progetto dispongono di questa autorizzazione. Gli altri utenti devono avere un ruolo che la includa, ad esempio Service Usage Consumer (roles/serviceusage.serviceUsageConsumer).

ID client OAuth

Per eseguire l'autenticazione utilizzando un ID client e un 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 o esegui MCP: Open User Configuration dalla tavolozza dei comandi per renderlo disponibile in tutti i workspace. Per la struttura dei file di VS Code, consulta la 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 tuo cliente ti chiede di specificare gli ambiti OAuth, utilizza https://www.googleapis.com/auth/devprofiles.full_control.

Non è necessario 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.

Usa la skill dell'agente Developer Knowledge

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

Una skill dell'agente è un insieme di istruzioni che l'assistenza al coding 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: indica all'assistente di utilizzare answer_query per domande e confronti generali su "come fare" e search_documents (con 2-5 parole chiave mirate) quando cerca flag dell'interfaccia a riga di comando, autorizzazioni IAM o sintassi del codice esatti.
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.
Utilizza l'API REST come soluzione di riserva: fornisce all'assistente i 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.

Installa la skill dell'agente

Seleziona l'assistenza al coding per installare la skill 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 Agent Skills, 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.

Ottimizza 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 con parole chiave brevi e scarichi le pagine complete solo quando necessario.
Affidati al recupero in due passaggi: consenti all'agente di iniziare chiamando search_documents. In questo modo, vengono restituiti snippet (chunk) mirati che spesso contengono la sintassi o la firma dell'API esatta di cui hai bisogno senza consumare token per l'intera pagina. Istruisci l'agente a 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 di progettazione, chiedi all'agente di utilizzare answer_query. Questo strumento genera una risposta direttamente dal corpus di conoscenze per gli sviluppatori senza restituire pagine Markdown non elaborate complete.
Scrivi prompt specifici e mirati: evita prompt troppo generici come "Spiega tutto di 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 la skill 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 i recuperi automatici di intere pagine:
```
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 tue 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 eseguendo il deployment dell'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 policy di sicurezza e protezione dell'AI in modo coerente nel tuo panorama di 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 non supportata da Model Armor, il comportamento di routing della chiamata potrebbe essere diverso per i vari server MCP e potrebbe violare la conformità della 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 attivare Model Armor.

Configurare la protezione per i server MCP remoti

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

Configura un'impostazione di base di Model Armor con la sanificazione MCP abilitata. 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 un'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 al traffico del server MCP di Google.

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.

Modifica 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 per 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 prevede l'utilizzo di 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	Causa probabile	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 programmazione 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	Causa probabile	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 restrizioni delle chiavi API esclude l'API Developer Knowledge.	Aggiorna le restrizioni della chiave API nella pagina Credenziali della console Google Cloud per includere l'API Developer Knowledge.

Errori OAuth e ADC

Sintomo o errore	Causa probabile	Risoluzione
`401 UNAUTHENTICATED` o credenziali ADC mancanti	I token di connessione 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 o esegui `gcloud auth application-default print-access-token` per generare un nuovo token di connessione.
`403 PERMISSION_DENIED`: `API requires a quota project, which is not set by default`	La richiesta utilizza un token di connessione 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.	In 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 un URI di reindirizzamento mancante.	Utilizza App desktop per i client con prompt interattivi (come VS Code) o Applicazione web con l'URI di reindirizzamento autorizzato del client (come Cursor o Claude Code).

Errori relativi a quote e filtri di sicurezza

Sintomo o errore	Causa probabile	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 scoprire di più sui limiti e 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 del 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 di Google Cloud: il traffico in uscita verso internet pubblico non è richiesto. 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 limitato (restricted.googleapis.com / 199.36.153.4/30) o sugli endpoint PSC vpc-sc. Se il tuo VPC instrada *.googleapis.com a restricted.googleapis.com, configura una policy di risposta Cloud DNS specifica o un record DNS privato per developerknowledge.googleapis.com in modo che venga risolto 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

Ambiti 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

Usa la skill dell'agente Developer Knowledge

Installa la skill dell'agente

Google Antigravity

Claude Code

Cursore

Codex

Altro

Ottimizza 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

Modifica le impostazioni di Model Armor

Risoluzione dei problemi

Errori di configurazione e connessione

Errori della chiave API

Errori OAuth e ADC

Errori relativi a quote e filtri di sicurezza

Documentazione inclusa

Limitazioni note

Connettiti al server MCP per Developer Knowledge