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 de desenvolvimento com tecnologia de IA acesso direto para pesquisar e recuperar a documentação 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 raspagem.

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 na documentação do Google para encontrar as seções mais relevantes que correspondem à sua consulta. Quando você faz uma pergunta, a ferramenta retorna pequenos trechos de texto. Se o agente precisar do contexto completo da página em torno de uma passagem, ele poderá transmitir o nome do recurso do documento para get_documents e recuperar a página inteira.

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

Escolher seu 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 assistente de IA:

Chave de API: ideal para ambientes de desenvolvimento integrado (IDEs) de terceiros e agentes de linha de comando (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 Application Default Credentials (ADC), ou para fluxos de trabalho empresariais que exigem um token de acesso OAuth 2.0 ou um ID do cliente 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 do servidor MCP do 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 pela 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 seu projeto na nuvem 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 comando a seguir 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 automaticamente. Outros clientes do MCP podem usar o ADC transmitindo um token de 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 de 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 e uma chave secreta do cliente, 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 aceitos. Para URIs de redirecionamento específicos do cliente, consulte Configurar o MCP em um aplicativo de IA.
Clique em Criar e copie seu ID do cliente e a chave secreta do cliente (ou baixe o arquivo JSON com as credenciais do cliente).

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 do Google integradas (ADC) ou chave de API
Claude Code, Cursor, GitHub Copilot, Codex	Chave de API
Outro	Chave de API, token de acesso do ADC ou ID do cliente OAuth 2.0

Para usar um token de acesso 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 de posição:

Chave de API (YOUR_API_KEY): substitua pela string da chave de API bruta.
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 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 "Agente", clique no menu Outras opções () > 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 em 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 seu 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 padrão de configuração JSON:

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

Token do portador da ADC

Se o cliente do MCP não tiver suporte integrado para ADC, você poderá fazer a autenticação com 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 exige 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 e uma chave secreta do cliente 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 tecla servers de nível superior em vez de mcpServers. Adicione o servidor a .vscode/mcp.json na pasta que você abre como espaço de trabalho ou execute MCP: Open User Configuration na paleta de comandos para disponibilizar 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 aparecer uma mensagem informando que o registro dinâmico de clientes não é compatível, continue e insira seu ID do cliente e segredo 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 configurado, reinicie o assistente de IA ou recarregue os servidores MCP dele. Em seguida, envie um comando de teste para verificar se a integração da ferramenta 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 estará conectado e ativo.

Usar a habilidade do agente de conhecimento do desenvolvedor

Instale a habilidade oficial do agente retrieving-developer-knowledge para ensinar o Google Assistente quando e como usar as ferramentas principais oferecidas pelo servidor MCP do Developer Knowledge.

Uma habilidade do 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 "como fazer" 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 erros antes de responder: instrui o assistente a verificar se uma pesquisa de documentação foi concluída antes de escrever uma resposta. Assim, ele não confunde uma chave de API ou um erro de cota com documentação ausente nem volta a adivinhar com base em dados de treinamento mais antigos.
Voltar para a API REST: dá 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 skills 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 completas de documentação na janela de contexto de um modelo de IA consome muitos tokens. Ingerir vários documentos grandes pode causar custos altos de token, 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 trechos (pedaços) 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 somente quando o contexto for estritamente necessário.
Prefira answer_query para perguntas conceituais: quando 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 do desenvolvedor sem retornar páginas completas em Markdown bruto.
Escreva comandos específicos e limitados: 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 personalizadas do agente: se você não estiver usando a habilidade retrieving-developer-knowledge, adicione diretrizes para envolvidos no projeto aos arquivos de instruções do seu assistente (por exemplo, .cursorrules, CLAUDE.md ou .github/copilot-instructions.md) para restringir buscas automáticas de página inteira:
```
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 à ampla 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 das 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 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 seus registros.

Roteamento 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 a todo o projeto. Essa configuração aplica um conjunto consistente de filtros a todas as chamadas e respostas de ferramentas do MCP no projeto.

Configure uma configuração mínima do Model Armor com a sanitização da 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 aplicação que inspeciona o conteúdo do servidor MCP do Google e bloqueia solicitações 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 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 deste projeto ao tráfego de qualquer 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 filtros de injeção de comandos e jailbreak (PIJB) para níveis de confiança HIGH_AND_ABOVE e 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
Endpoint `404 NOT_FOUND` em `/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 HTTP MCP 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 chave 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 de autenticação do ADC expiraram ou não foram inicializados.	Execute `gcloud auth application-default login --project=PROJECT_ID` para atualizar as credenciais locais ou execute `gcloud auth application-default print-access-token` para gerar um novo token de acesso.
`403 PERMISSION_DENIED`: `API requires a quota project, which is not set by default`	A solicitação usa um token de autenticação 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 do 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 do 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 sem suporte ou URI de redirecionamento ausente.	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 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 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.
- Dentro das redes VPC do Google Cloud: a saída da 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 indisponível no VIP restrito (restricted.googleapis.com / 199.36.153.4/30) nem nos 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 resolver 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

Escolher seu 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

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 da ADC

ID do cliente OAuth

Verifique a conexão

Usar a habilidade do 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

Roteamento 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