O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Conectar-se ao servidor MCP de conhecimento do desenvolvedor

O servidor MCP do Google Developer Knowledge oferece às ferramentas para desenvolvedores com tecnologia de IA acesso direto para pesquisar e recuperar a documentação para desenvolvedores oficial do Google para produtos como Firebase, Google Cloud, Android, Plataforma Google Maps e muito mais. Ao conectar seu assistente de programação à biblioteca oficial de documentação do Google, você evita pesquisas manuais na Web, contexto desatualizado e scraping.

Para se conectar ao servidor MCP do Developer Knowledge usando seu próprio aplicativo ou código de agente em vez de um ambiente de desenvolvimento integrado, consulte Conectar usando SDKs do MCP.

Recursos do servidor MCP

O servidor MCP do Google Developer Knowledge oferece três ferramentas principais para seu assistente de programação de IA:

Nome da ferramenta	Descrição
`search_documents`	Pesquisa a documentação para desenvolvedores do Google e retorna os trechos de página mais relevantes com os nomes dos documentos.
`get_documents`	Recupera o conteúdo completo em Markdown dos documentos usando os nomes retornados por `search_documents`.
`answer_query`	Gera respostas estruturadas com base no corpus de conhecimento do desenvolvedor.

A ferramenta search_documents pesquisa a documentação do Google para encontrar as seções mais relevantes que correspondem à sua consulta. Quando você faz uma pergunta, a ferramenta retorna trechos curtos de texto. Se o agente precisar do contexto completo da página em torno de um trecho, ele poderá transmitir o nome do recurso do documento para get_documents para recuperar a página inteira.

Use a ferramenta answer_query quando quiser uma resposta direta a uma pergunta extraída do corpus de conhecimento para desenvolvedores, em vez de resultados da pesquisa brutos ou arquivos Markdown completos.

Escolha o método de autenticação

O servidor MCP de conhecimento do desenvolvedor oferece suporte a duas abordagens de autenticação, dependendo do seu ambiente de desenvolvimento e do assistente de IA:

Chave de API: ideal para ambientes de desenvolvimento integrado de terceiros e agentes de CLI, como Claude Code, Cursor, GitHub Copilot, Codex e outros clientes MCP remotos. Transmita a chave de API no cabeçalho X-Goog-Api-Key por HTTPS.
OAuth e ADC: ideal para o Google Antigravity, que tem suporte integrado para o Application Default Credentials (ADC), ou para fluxos de trabalho corporativos que exigem um token do portador do OAuth 2.0 ou um ID do cliente do OAuth 2.0 independente em vez de uma chave de API.

Gere as credenciais necessárias para o método de autenticação escolhido para permitir que seu assistente de IA ou agente de programação autentique solicitações com o serviço de servidor MCP da Developer Knowledge.

Selecione uma guia para criar suas credenciais:

Chave de API

Pré-requisitos

Antes de criar uma chave de API, verifique se você tem:

Um projeto do Google Cloud.
A CLI gcloud instalada (se a configuração for feita na linha de comando).

Ativar a API e criar uma chave de API

É possível gerar uma chave de API usando o console do Google Cloud ou a CLI gcloud:

Console do Google Cloud

Abra a página da API Developer Knowledge no console do Google Cloud.
Selecione o projeto do Google Cloud e clique em Ativar.
Acesse a página Credenciais.
Clique em Criar credenciais e selecione Chave de API.
Clique na ação Editar chave de API para configurar restrições:
- Em Restrições de API, escolha Restringir chave.
- Selecione API Developer Knowledge.
- Se você planeja usar essa mesma chave para chamadas de modelo (como GEMINI_API_KEY), selecione também a API Generative Language.
Clique em Salvar e copie a chave de API.

CLI da gcloud

Ative a API Developer Knowledge no seu projeto, substituindo PROJECT_ID pelo ID do projeto:

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

Crie uma chave de API:
```
gcloud services api-keys create \
  --project=PROJECT_ID \
  --display-name="DK API Key"
```
Esse comando retorna detalhes de metadados sobre sua nova chave. Copie e salve os dois valores a seguir da resposta ao comando:
- keyString: é a chave de API bruta (por exemplo, AIzaSy...). Cole esse valor na configuração do seu ambiente de desenvolvimento integrado.
- name: é o caminho do recurso da chave (por exemplo, projects/PROJECT_ID/locations/global/keys/UNIQUE_ID). Você vai usar esse caminho para restringir a chave na próxima etapa.
Restrinja a chave à API Developer Knowledge para evitar o uso não autorizado. Substitua KEY_NAME pelo caminho completo de name copiado da etapa anterior:
```
gcloud services api-keys update KEY_NAME \
  --api-target=service=developerknowledge.googleapis.com
```
Importante: se você planeja usar essa mesma chave para as chamadas de modelo gerais do cliente de IA (por exemplo, GEMINI_API_KEY), também é necessário permitir a 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

Pré-requisitos

Antes de configurar o OAuth ou o ADC, verifique se você tem:

Ativar a API

Execute o seguinte comando para ativar a API Developer Knowledge no seu projeto:

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

Escolher o tipo de credencial OAuth

Selecione a abordagem de credenciais exigida pela sua ferramenta:

ADC

O Google Antigravity tem suporte integrado para ADC e atualiza os tokens de atualização automaticamente. Outros clientes do MCP podem usar o ADC transmitindo um token do portador de curta duração no cabeçalho Authorization:

Autentique-se com sua Conta do Google e defina seu projeto de cota:

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

Quando o navegador abrir, faça login com sua Conta do Google e conceda as permissões solicitadas.
(Opcional) Se você estiver configurando um cliente MCP de terceiros que não tem suporte integrado ao ADC, gere um token do portador (válido por uma hora) para usar no cabeçalho Authorization do cliente:
```
gcloud auth application-default print-access-token
```

ID do cliente OAuth

Crie um ID do cliente e uma chave secreta do OAuth 2.0 se o assistente de IA usar um fluxo interativo do OAuth, porque os servidores MCP remotos do Google não são compatíveis com o registro dinâmico de clientes (DCR) do OAuth.

Acesse a página de branding e selecione seu projeto. Insira um Nome do app e um E-mail de suporte ao usuário e clique em Salvar.
Acesse a página "Público-alvo" e defina o Tipo de usuário como Externo.
Na mesma página, clique em Adicionar usuários em Usuários de teste, insira seu endereço de e-mail do Google e clique em Salvar.
Acesse a página "Clientes", clique em Criar cliente e escolha o tipo de aplicativo exigido pelo seu cliente MCP:
- Selecione App para computador para clientes de computador que solicitam um ID do cliente e uma chave secreta (como o VS Code).
- Selecione Aplicativo da Web e adicione o URI de redirecionamento do cliente para clientes que exigem callbacks de redirecionamento OAuth estáticos (como conectores personalizados do Cursor ou do Claude Code). Use o URI de redirecionamento exato que seu cliente documenta. URIs de redirecionamento personalizados não são compatíveis. Para URIs de redirecionamento específicos do cliente, consulte Configurar o MCP em um aplicativo de IA.
Clique em Criar e copie o ID do cliente e a chave secreta do cliente (ou faça o download do arquivo JSON de credenciais do cliente).

Escopos do OAuth

O servidor MCP de conhecimento do desenvolvedor aceita os seguintes escopos do OAuth:

https://www.googleapis.com/auth/cloud-platform: escopo padrão usado pelo Application Default Credentials (ADC) e pela CLI gcloud.
https://www.googleapis.com/auth/devprofiles.full_control: escopo usado para fluxos de consentimento de ID do cliente OAuth 2.0 e descoberta de servidor MCP.
https://www.googleapis.com/auth/developerprofiles.readonly: escopo somente leitura compatível com contas de serviço e credenciais que não exigem uma tela de permissão OAuth do usuário final.

Configurar o ambiente de desenvolvimento integrado ou o agente de programação

Depois de receber suas credenciais, siga as instruções de configuração do seu ambiente de programação. As instruções para cada ambiente de programação são compatíveis com os seguintes métodos de autenticação:

Ambiente de programação	Métodos de autenticação
Google Antigravity	Credenciais integradas do Google (ADC) ou chave de API
Claude Code, Cursor, GitHub Copilot, Codex	Chave de API
Outro	Chave de API, token do portador do ADC ou ID do cliente OAuth 2.0

Para usar um token do portador do ADC ou um ID do cliente OAuth 2.0 com o Claude Code, o Cursor, o GitHub Copilot ou o Codex, siga as instruções na guia Outros.

Dependendo do modelo usado, substitua os seguintes marcadores:

Chave de API (YOUR_API_KEY): substitua pela string bruta da chave de API.
ID do projeto (PROJECT_ID): substitua pelo ID do seu projeto do Google Cloud.
Token de acesso (ACCESS_TOKEN): substitua pelo token do portador de gcloud auth application-default print-access-token.

Google Antigravity

IDE do Antigravity e extensões

Para configurar o servidor MCP no IDE do Antigravity ou na extensão do Antigravity (como no VS Code), selecione seu método de autenticação:

credenciais do Google

Para instalar o servidor MCP usando a configuração com um clique:

No painel do agente, clique no menu Outras opções () e selecione Servidores MCP.
Pesquise por Google Developer Knowledge.
Clique no ícone Instalar (). O Antigravity configura automaticamente o servidor e se conecta usando suas credenciais ativas do Google.

Chave de API

Para configurar uma chave de API no IDE do Antigravity ou na extensão do Antigravity:

No painel do agente, clique no menu Opções adicionais () > Servidores MCP > Gerenciar servidores MCP > Ver configuração bruta (ou abra .agents/mcp_config.json).

Adicione a seguinte configuração de servidor:

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

CLI do Antigravity

Configure o servidor MCP no arquivo .agents/mcp_config.json do projeto ou globalmente em ~/.gemini/config/mcp_config.json:

credenciais do 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"
      }
    }
  }
}

Chave de API

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

Claude Code

Execute o comando a seguir no terminal.

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

Cursor

Para configurar o Cursor, edite .cursor/mcp.json na raiz do projeto ou ~/.cursor/mcp.json para acesso global:

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

GitHub Copilot

Configurações do espaço de trabalho

Para configurar o GitHub Copilot no VS Code para um espaço de trabalho específico, crie ou edite .vscode/mcp.json:

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

Configurações globais do usuário

Para disponibilizar o servidor em todos os espaços de trabalho do VS Code, abra a paleta de comandos, execute MCP: Open User Configuration e adicione o seguinte ao arquivo mcp.json no seu perfil de usuário:

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

Codex

Para configurar a CLI do Codex ou o agente do Codex, adicione a configuração do servidor a ~/.codex/config.toml (ou .codex/config.toml do projeto):

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

Outro

Para configurar qualquer outro cliente MCP remoto (como o JetBrains AI Assistant, Windsurf, Cline, Zed, Continue ou Claude Desktop) ou usar um token de acesso do ADC ou um ID do cliente OAuth 2.0 em um cliente de terceiros, selecione seu método de autenticação:

Chave de API

Configure um servidor de transporte HTTP com as seguintes configurações:

URL do servidor: https://developerknowledge.googleapis.com/mcp
Cabeçalho HTTP: X-Goog-Api-Key: YOUR_API_KEY

Modelo de configuração JSON padrão:

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

Token do portador do ADC

Se o cliente do MCP não tiver suporte integrado ao ADC, será possível fazer a autenticação com o ADC transmitindo o token do portador de gcloud auth application-default print-access-token e o ID do projeto na nuvem do Google Cloud nos cabeçalhos da solicitação:

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

O cabeçalho X-Goog-User-Project requer a permissão serviceusage.services.use no projeto. Os proprietários e editores do projeto têm essa permissão. Outros usuários precisam de um papel que o inclua, como o consumidor do Service Usage (roles/serviceusage.serviceUsageConsumer).

ID do cliente OAuth

Para autenticar usando um ID do cliente e uma chave secreta do OAuth 2.0 independente:

Adicione o endpoint do servidor MCP à configuração do cliente sem um cabeçalho de chave de API:
```
{
  "mcpServers": {
    "google-developer-knowledge": {
      "url": "https://developerknowledge.googleapis.com/mcp"
    }
  }
}
```
Observação: o VS Code usa uma chave servers de nível superior em vez de mcpServers. Adicione o servidor a .vscode/mcp.json na pasta que você abrir como seu espaço de trabalho ou execute MCP: Open User Configuration na paleta de comandos para disponibilizá-lo em todos os espaços de trabalho. Para a estrutura de arquivos do VS Code, consulte a guia GitHub Copilot e omita a seção headers.
Conclua a configuração do OAuth para seu cliente:
- Prompt interativo (como o VS Code): envie um prompt de teste para o agente. Quando for informado que o registro dinâmico de cliente não é compatível, prossiga e insira o ID do cliente e a chave secreta do cliente. Em seguida, faça login com sua Conta do Google.
- Configuração estática do OAuth (como Cursor ou Claude Code): forneça o ID do cliente OAuth, a chave secreta do cliente e o URI de redirecionamento nas configurações do OAuth do cliente. Para instruções específicas do cliente, consulte Configurar o MCP em um aplicativo de IA.
Se o cliente pedir para você especificar escopos do OAuth, use https://www.googleapis.com/auth/devprofiles.full_control.

Não é necessário especificar um ID do projeto do Google Cloud nessa configuração. As solicitações são atribuídas ao projeto que possui seu ID do cliente OAuth.

Verifique a conexão

Depois de configurar, reinicie o assistente de IA ou recarregue os servidores MCP. Em seguida, envie um comando de teste para verificar se a integração de ferramentas funciona:

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

Se o agente invocar search_documents ou answer_query e retornar informações da documentação do Google, seu servidor está conectado e ativo.

Usar a habilidade de agente de conhecimento do desenvolvedor

Instale a habilidade de agente oficial do retrieving-developer-knowledge para ensinar ao assistente quando e como usar as ferramentas principais oferecidas pelo servidor MCP de conhecimento para desenvolvedores.

Uma habilidade de agente é um conjunto de instruções que seu assistente de programação de IA lê antes de iniciar uma tarefa. A habilidade retrieving-developer-knowledge funciona com qualquer assistente que aceite o padrão aberto de habilidades de agente e ajuda o assistente a fazer o seguinte:

Escolha a ferramenta certa: orienta o assistente a usar answer_query para perguntas e comparações amplas de "Instruções" e search_documents (com duas a cinco palavras-chave focadas) ao pesquisar flags exatas da CLI, permissões do IAM ou sintaxe de código.
Verificar se há erros antes de responder: instrui o assistente a verificar se uma pesquisa de documentação foi bem-sucedida antes de escrever uma resposta, para que ele não confunda um erro de chave de API ou de cota com documentação ausente ou recorra a suposições com base em dados de treinamento mais antigos.
Usar a API REST como alternativa: fornece ao assistente comandos curl para chamar a API Developer Knowledge diretamente se o editor não for compatível com servidores MCP ou se a conexão MCP falhar.

Instalar a habilidade do agente

Selecione seu assistente de programação para instalar a habilidade retrieving-developer-knowledge no diretório do projeto:

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

Cursor

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

Codex

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

Outro

Para outros assistentes de IA que oferecem suporte ao padrão aberto Agent Skills, execute:

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

Para atualizar as habilidades instaladas para a versão mais recente, execute:

npx skills update

Para conferir as instruções completas da habilidade e os guias de referência, consulte o diretório retrieving-developer-knowledge no GitHub.

Otimizar a janela de contexto e o uso de tokens

Recuperar páginas de documentação completas na janela de contexto de um modelo de IA consome muitos tokens. A ingestão de vários documentos grandes pode causar altos custos de tokens, aumento da latência e estouro da janela de contexto.

Para garantir respostas rápidas e econômicas, siga estas práticas recomendadas de engenharia de comandos:

Instale a habilidade do agente (recomendado): instale a habilidade do agente retrieving-developer-knowledge para que seu assistente escolha automaticamente a ferramenta de pesquisa certa (answer_query ou search_documents), use pesquisas curtas por palavras-chave e baixe apenas páginas completas quando necessário.
Confie na recuperação em duas etapas: deixe o agente começar chamando search_documents. Isso retorna snippets (trechos) focados que geralmente contêm a sintaxe ou a assinatura de API exata de que você precisa, sem consumir tokens para a página inteira. Instrua o agente a chamar get_documents apenas quando o contexto ao redor for estritamente necessário.
Prefira answer_query para perguntas conceituais: quando você precisar de uma explicação gerada ou de uma comparação de design, peça ao agente para usar answer_query. Essa ferramenta gera uma resposta diretamente do corpus de conhecimento para desenvolvedores sem retornar páginas Markdown brutas completas.
Escreva comandos específicos e com escopo: evite comandos muito amplos, como "Explique tudo sobre o Firebase". Em vez disso, especifique o produto, a plataforma e o idioma de destino:
```
How do I write a Firestore transaction in Dart with error handling?
```
Adicionar regras de agente personalizadas: se você não estiver usando a habilidade retrieving-developer-knowledge, adicione diretrizes para envolvidos no projeto aos arquivos de instrução do assistente (por exemplo, .cursorrules, CLAUDE.md ou .github/copilot-instructions.md) para restringir buscas automáticas de páginas completas:
```
When searching Google developer documentation, inspect search_documents
snippets first. Do not call get_documents unless the snippet lacks
necessary code context.
```

Configurações opcionais de segurança

O MCP apresenta novos riscos e considerações de segurança devido à grande variedade de ações que podem ser realizadas com as ferramentas do MCP. Para minimizar e gerenciar esses riscos, o Google Cloud oferece configurações padrão e políticas personalizáveis para controlar o uso de ferramentas do MCP na sua organização ou projeto do Google Cloud.

Para mais informações sobre segurança e governança do MCP, consulte Segurança e proteção de IA.

Usar o Model Armor

O Model Armor é um serviço do Google Cloud projetado para aumentar a segurança dos seus aplicativos de IA. Ele funciona verificando de maneira proativa os comandos e respostas de LLMs, protegendo contra vários riscos e apoiando práticas de IA responsável. Seja no seu ambiente de nuvem ou em provedores de nuvem externos, o Model Armor ajuda a evitar entradas maliciosas, verificar a segurança do conteúdo, proteger dados sensíveis, manter a conformidade e aplicar suas políticas de segurança de IA de maneira consistente em todo o seu cenário de IA.

Quando o Model Armor está ativado com a geração de registros ativada, ele registra todo o payload. Isso pode expor informações sensíveis nos registros.

Encaminhamento de solicitações do MCP para o Model Armor

O Model Armor está disponível em algumas regiões. Quando o Model Armor está ativado e você usa um servidor MCP em uma jurisdição que não tem suporte do Model Armor, o comportamento de roteamento da chamada pode ser diferente para diferentes servidores MCP e violar a conformidade de residência de dados para dados em uso e em trânsito. Para mais informações sobre o comportamento de servidores MCP individuais, consulte Produtos compatíveis com o Model Armor.

Ativar o Model Armor

Siga as etapas em Integrar com servidores MCP do Google e do Google Cloud para ativar o Model Armor.

Configurar a proteção para servidores MCP remotos

Para proteger as chamadas e respostas da ferramenta MCP, use as configurações de proteção do Model Armor. Uma configuração mínima define os filtros de segurança mínimos que se aplicam ao projeto. Essa configuração aplica um conjunto consistente de filtros a todas as chamadas e respostas de ferramentas do MCP no projeto.

Defina uma configuração mínima do Model Armor com a sanitização do MCP ativada. Para mais informações, consulte Configurar as configurações mínimas do Model Armor.

Confira o exemplo de comando a seguir:

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"}]'

Substitua PROJECT_ID pelo ID do projeto do Google Cloud.

Observe as seguintes configurações:

INSPECT_AND_BLOCK: o tipo de restrição que inspeciona o conteúdo do servidor MCP do Google e bloqueia comandos e respostas que correspondem aos filtros.
ENABLED: a configuração que ativa um filtro ou uma aplicação.
MEDIUM_AND_ABOVE: o nível de confiança para as configurações do filtro de IA responsável - Perigoso. É possível modificar essa configuração, mas valores mais baixos podem resultar em mais falsos positivos. Para mais informações, consulte Níveis de confiança do Model Armor.

Desativar a verificação do tráfego do MCP com o Model Armor

Para impedir que o Model Armor verifique automaticamente o tráfego de e para os servidores MCP do Google com base nas configurações mínimas do projeto, execute o seguinte comando:

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

Substitua PROJECT_ID pelo ID do projeto do Google Cloud. O Model Armor não aplica automaticamente as regras definidas nas configurações mínimas desse projeto a nenhum tráfego do servidor MCP do Google.

As configurações mínimas e a configuração geral do Model Armor podem afetar mais do que apenas o MCP. Como o Model Armor se integra a serviços como a Vertex AI, as mudanças feitas nas configurações mínimas podem afetar a verificação de tráfego e os comportamentos de segurança em todos os serviços integrados, não apenas no MCP.

Ajustar as configurações do Model Armor

Se você estiver usando o Model Armor para proteger seu aplicativo, poderá encontrar erros 403 PERMISSION_DENIED em algumas consultas. Como o servidor MCP do Developer Knowledge só retorna documentação pública de fontes confiáveis do Google, recomendamos definir os filtros de injeção de comandos e jailbreak (PIJB) para níveis de confiança HIGH_AND_ABOVE para reduzir falsos positivos. Se o caso de uso não envolver outras ferramentas que acessam dados particulares ou sensíveis, considere desativar os filtros de PIJB.

Solução de problemas

Se você tiver problemas para se conectar ou consultar o servidor MCP do Developer Knowledge, encontre seu sintoma ou mensagem de erro nas tabelas a seguir.

Erros de configuração e conexão

Sintoma ou erro	Causa provável	Resolução
`404 NOT_FOUND` no endpoint `/mcp`	A API não está ativada para seu projeto.	Ative a API Developer Knowledge no console do Google Cloud ou execute `gcloud services enable developerknowledge.googleapis.com`.
`403 PERMISSION_DENIED`: `Developer Knowledge API has not been used`	A API Developer Knowledge não está ativada no projeto do Google Cloud.	Ative a API no console do Google Cloud ou execute `gcloud services enable developerknowledge.googleapis.com`.
Ferramentas do MCP ausentes ou falha na conexão	Sua ferramenta de programação não é compatível com servidores MCP HTTP remotos ou não consegue se conectar ao servidor.	Instale a habilidade do agente `retrieving-developer-knowledge`, que informa ao assistente como voltar aos endpoints REST da API Developer Knowledge usando `curl` quando as ferramentas do MCP não estão disponíveis.

Erros de chave de API

Sintoma ou erro	Causa provável	Resolução
`400 Bad Request: API key not valid`	A string da chave de API está ausente, é inválida ou está incorreta.	Verifique se a chave de API foi copiada corretamente e configurada no objeto `headers` com a chave `X-Goog-Api-Key`. Não transmita a chave de API como um parâmetro de consulta no URL.
`403 PERMISSION_DENIED: API target restriction`	A lista de restrições de chaves de API exclui a API Developer Knowledge.	Atualize as restrições da chave de API na página "Credenciais" do console do Google Cloud para incluir a API Developer Knowledge.

Erros de OAuth e ADC

Sintoma ou erro	Causa provável	Resolução
`401 UNAUTHENTICATED` ou credenciais do ADC ausentes	As Application Default Credentials ou os tokens do portador do ADC expiraram ou não foram inicializados.	Execute `gcloud auth application-default login --project=PROJECT_ID` para atualizar as credenciais locais ou `gcloud auth application-default print-access-token` para gerar um novo token do portador.
`403 PERMISSION_DENIED`: `API requires a quota project, which is not set by default`	A solicitação usa um token do portador do ADC sem um cabeçalho `X-Goog-User-Project`.	Adicione o cabeçalho `X-Goog-User-Project` com o ID do projeto do Google Cloud à configuração do cliente MCP.
`403 PERMISSION_DENIED` com um cabeçalho `X-Goog-User-Project`	Sua conta não tem a permissão `serviceusage.services.use` no projeto do cabeçalho.	Peça a um administrador do projeto para conceder a você o papel de consumidor do Service Usage (`roles/serviceusage.serviceUsageConsumer`).
`403 access_denied` / "Acesso bloqueado: erro de autorização"	Sua tela de permissão OAuth usa o tipo de usuário Externo no modo de teste, e sua conta não está listada como um usuário de teste.	No console do Google Cloud > Auth Platform > Público-alvo, adicione seu endereço de e-mail ativo do Google em Usuários de teste.
Erro do cliente OAuth ou URI de redirecionamento inválido	O cliente OAuth foi criado com um tipo de aplicativo incompatível ou sem o URI de redirecionamento.	Use o App para computador para clientes com comandos interativos (como o VS Code) ou o Aplicativo da Web com o URI de redirecionamento autorizado do cliente (como o Cursor ou o Claude Code).

Erros de cota e filtro de segurança

Sintoma ou erro	Causa provável	Resolução
`429 RESOURCE_EXHAUSTED`	Você atingiu o limite de cota do seu projeto.	Verifique seu uso na página de cotas da API Developer Knowledge no console do Google Cloud. Para saber mais sobre os limites e solicitar um aumento, consulte Cota da API Developer Knowledge.
`403 PERMISSION_DENIED` com o Model Armor	Um falso positivo do filtro de PIJB do Model Armor bloqueou uma consulta segura.	Defina a confiança do filtro PIJB como `HIGH_AND_ABOVE` nas configurações do modelo do Model Armor.

Documentação incluída

Consulte a referência de corpus para ver a lista completa de produtos do Google e repositórios de documentação indexados pelo servidor.

Limitações conhecidas

Somente documentação pública: o servidor indexa apenas a documentação disponível publicamente listada na Referência de corpus. Documentos internos, repositórios particulares e recursos de terceiros não estão incluídos.
Idioma inglês: o servidor indexa e retorna documentação apenas em inglês.
Dependência de rede e VPC Service Controls: como o servidor MCP do Developer Knowledge é um serviço hospedado remotamente, seu cliente precisa ter conectividade de rede para acessar https://developerknowledge.googleapis.com.
- Nas redes VPC do Google Cloud: a saída de dados para a Internet pública não é necessária. É possível acessar developerknowledge.googleapis.com de forma particular sem endereços IP externos ou Cloud NAT roteando o tráfego usando o Acesso privado do Google (private.googleapis.com / 199.36.153.8/30) ou um endpoint do Private Service Connect (PSC) direcionado ao pacote all-apis.
- VPC Service Controls (VPC-SC): developerknowledge.googleapis.com não é compatível com o VIP restrito (restricted.googleapis.com / 199.36.153.4/30) nem com os endpoints vpc-sc do PSC. Se a VPC rotear *.googleapis.com para restricted.googleapis.com, configure uma política de resposta específica do Cloud DNS ou um registro DNS particular para developerknowledge.googleapis.com para resolver para private.googleapis.com (199.36.153.8/30).

Conectar-se ao servidor MCP de conhecimento do desenvolvedor Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Recursos do servidor MCP

Escolha o método de autenticação

Chave de API

Pré-requisitos

Ativar a API e criar uma chave de API

Console do Google Cloud

CLI da gcloud

OAuth e ADC

Pré-requisitos

Ativar a API

Escolher o tipo de credencial OAuth

ADC

ID do cliente OAuth

Escopos do OAuth

Configurar o ambiente de desenvolvimento integrado ou o agente de programação

Google Antigravity

IDE do Antigravity e extensões

credenciais do Google

Chave de API

CLI do Antigravity

credenciais do Google

Chave de API

Claude Code

Cursor

GitHub Copilot

Configurações do espaço de trabalho

Configurações globais do usuário

Codex

Outro

Chave de API

Token do portador do ADC

ID do cliente OAuth

Verifique a conexão

Usar a habilidade de agente de conhecimento do desenvolvedor

Instalar a habilidade do agente

Google Antigravity

Claude Code

Cursor

Codex

Outro

Otimizar a janela de contexto e o uso de tokens

Configurações opcionais de segurança

Usar o Model Armor

Encaminhamento de solicitações do MCP para o Model Armor

Ativar o Model Armor

Configurar a proteção para servidores MCP remotos

Desativar a verificação do tráfego do MCP com o Model Armor

Ajustar as configurações do Model Armor

Solução de problemas

Erros de configuração e conexão

Erros de chave de API

Erros de OAuth e ADC

Erros de cota e filtro de segurança

Documentação incluída

Limitações conhecidas

Conectar-se ao servidor MCP de conhecimento do desenvolvedor