experiment Esta é uma versão experimental da API destinada apenas a testes e feedback.

Conectar-se ao servidor MCP de conhecimento do desenvolvedor

O servidor MCP do Google Developer Knowledge permite que ferramentas de desenvolvimento com tecnologia de IA pesquisem a documentação oficial para desenvolvedores do Google e recuperem informações sobre produtos do Google, como Firebase, Google Cloud, Android, Maps e muito mais. Ao conectar seu aplicativo de IA diretamente à nossa biblioteca oficial de documentação, você garante que o código e as orientações recebidas estejam atualizados e baseados em um contexto confiável.

Depois de configurar o servidor, as ferramentas integradas podem ajudar com solicitações como:

Diretrizes para implementação
- Por exemplo: Qual é a melhor maneira de implementar notificações push usando o Firebase Cloud Messaging em um app Android?
Geração e explicação de código
- Por exemplo: Pesquise na documentação do Google um exemplo em Python para listar todos os buckets em um projeto do Cloud Storage.
Solução de problemas e depuração
- Por exemplo: Por que minha chave de API Google Maps está mostrando uma marca d'água "Somente para fins de desenvolvimento"?
Análise comparativa e resumo
- Por exemplo: Ajude-me a escolher entre o Cloud Run e o Cloud Functions para um novo microsserviço. Crie uma tabela Markdown que compare aspectos importantes, como caso de uso principal, simultaneidade e modelo de preços.

Recursos do servidor MCP

O servidor MCP do Google Developer Knowledge fornece as seguintes ferramentas para seu aplicativo de IA:

Nome da ferramenta	Descrição
`search_documents`	Pesquisa na documentação para desenvolvedores do Google (Firebase, Google Cloud, Android, Maps e muito mais) para encontrar páginas e snippets relevantes para sua consulta. Use `get_documents` com o `parent` dos resultados da pesquisa para acessar o conteúdo completo da página.
`get_documents`	Acessa o conteúdo completo de vários documentos usando `parent`s dos resultados de `search_documents`.

A ferramenta search_documents divide a documentação em blocos de texto menores otimizados para pesquisa e recuperação com tecnologia de IA. Ao pesquisar, a ferramenta retorna um ou mais snippets de documentos relevantes para sua consulta. Se você precisar conferir o conteúdo completo da página que envolve um snippet, use get_documents com o parent fornecido nos resultados da pesquisa para recuperar o conteúdo completo da página.

Instalação

O servidor MCP do Google Developer Knowledge é um servidor MCP remoto que usa a API Developer Knowledge para pesquisar e recuperar documentação. É possível autenticar usando o OAuth ou uma chave de API.

Autenticar usando o OAuth

Esta seção orienta você no processo de autenticação do aplicativo de IA com o servidor MCP do Developer Knowledge usando o OAuth.

Pré-requisito: configurar a CLI do Google Cloud

Antes de continuar, verifique se você tem:

Etapa 1: ativar a API Developer Knowledge em um projeto

Abra a página da API Developer Knowledge na biblioteca de APIs do Google.
Verifique se você selecionou o projeto correto em que pretende usar a API.
Clique em Ativar. Não é necessário ter papéis específicos do IAM para ativar ou usar a API.

Etapa 2: escolher seu método de autenticação

O método de autenticação escolhido depende de o assistente de IA oferecer suporte ao Application Default Credentials (ADC) usando a CLI gcloud ou exigir um ID do cliente OAuth independente. Assistentes como a CLI do Gemini podem usar seu login atual do Google Cloud para uma configuração perfeita, enquanto outros, como o Antigravity, exigem que você crie e forneça manualmente suas próprias credenciais para estabelecer uma conexão segura.

Selecione a guia que corresponde aos requisitos de configuração do seu assistente de IA específico.

ADC

Conectar sua conta

Para conceder ao servidor MCP a capacidade de agir em seu nome, execute o comando a seguir, substituindo PROJECT_ID pelo ID do projeto do Google Cloud:
```
gcloud auth application-default login
--project=PROJECT_ID
```
Quando solicitado, escolha uma conta e clique em Continuar.

Configurar o aplicativo de IA

Depois de autenticado, a etapa final é fornecer ao aplicativo de IA os detalhes de configuração do servidor. Embora a estrutura JSON exata varie de acordo com o aplicativo, você pode usar o exemplo a seguir como modelo.

Para configurar a CLI do Gemini ou o Gemini Code Assist, edite ou crie um dos seguintes arquivos de configuração:

No seu projeto: .gemini/settings.json
No diretório principal: ~/.gemini/settings.json

{
  "mcpServers": {
    "google-developer-knowledge": {
      "httpUrl": "https://developerknowledge.googleapis.com/mcp",
      "authProviderType": "google_credentials",
      "oauth": {
        "scopes": [
          "https://www.googleapis.com/auth/cloud-platform"
        ]
     },
      "timeout": 30000,
      "headers": {
        "X-goog-user-project": "PROJECT_ID"
      }
    }
  }
}

Para verificar se o servidor MCP está funcionando conforme o esperado, continue para verificar a instalação.

Credenciais manuais

Configurar a tela de permissão OAuth

Configure a tela de permissão OAuth do projeto e adicione-se como um usuário de teste. Se você já concluiu esta etapa para o projeto na nuvem do Google Cloud, pule para a próxima etapa.

Abra a página de visão geral da autenticação do console do Google Cloud, e clique em Começar.
Insira um Nome do app, selecione seu e-mail de suporte e clique Próxima.
Em Público-alvo, selecione Externo e clique em Próxima.
Insira seu endereço de e-mail em Dados de contato e clique Próxima.
Leia e concorde com a Política de Dados do Usuário dos Serviços de API do Google e clique em Continuar.
Clique em Criar.

Adicionar usuários de teste

Na plataforma de autenticação do Google, clique em Público-alvo.
Em Usuários de teste, clique em Adicionar usuários.
Insira seu endereço de e-mail e os outros usuários de teste autorizados e clique em Salvar.

Criar um cliente OAuth

Para fazer a autenticação como usuário final e acessar os dados do usuário no app, crie um ID do cliente OAuth 2.0. Um ID do cliente é usado para identificar um único app nos servidores OAuth do Google.

Na plataforma de autenticação do Google, clique em Clientes.
Clique em Criar cliente.
No seletor Tipo de aplicativo, escolha App para computador.
No campo Nome, digite um nome para a credencial. Esse nome é mostrado apenas no console do Google Cloud.
Clique em Criar. A tela Cliente OAuth criado aparece, mostrando o novo ID do cliente e a chave secreta do cliente.
Clique em OK. A credencial recém-criada aparece em IDs do cliente do OAuth 2.0.
Clique no ID do cliente recém-criado. Na seção Chaves secretas do cliente , clique no ícone de download para salvar o arquivo JSON. Você vai usar os client_id e client_secret valores nesse arquivo em uma etapa posterior.

Configurar o aplicativo de IA

Em seguida, você precisa fornecer ao aplicativo de IA os detalhes de configuração do servidor. Embora a série exata de etapas varie de acordo com o aplicativo, você pode usar o exemplo a seguir como modelo.

Para configurar Antigravity para usar o servidor MCP:

No Antigravity, clique no menu Opções adicionais no painel do agente > Servidores MCP > Gerenciar servidores MCP.

Na parte de cima do painel "Gerenciar servidores MCP" que é aberto, clique Conferir configuração bruta para editar o arquivo mcp_config.json:

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

Volte para Gerenciar servidores MCP e clique em Atualizar.

Adicionar credenciais OAuth

Na primeira vez que você tentar usar o servidor MCP do Developer Knowledge, o assistente de IA vai pedir que você conclua a configuração:

Peça ao agente para usar o servidor MCP do Developer Knowledge com um comando como:
```
How do I list Cloud Storage buckets?
```
Se você receber uma mensagem pedindo para registrar um ou mais URIs de redirecionamento, clique na opção para continuar. Como você configurou o ID do cliente como um app para computador, não é necessário adicionar esses URIs específicos na plataforma de autenticação do Google.
Quando o assistente de IA solicitar o ID do cliente e a chave secreta do cliente, cole cada chave correspondente do arquivo JSON da chave secreta do cliente que você salvou anteriormente.
Quando solicitado, escolha uma conta e clique em Continuar.
Volte ao assistente de IA. O agente vai processar sua solicitação usando o servidor recém-autenticado.

Autenticar usando uma chave de API

Esta seção orienta você no processo de autenticação do aplicativo de IA com o servidor MCP do Developer Knowledge usando uma chave de API.

Etapa 1: criar uma chave de API

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

Console do Google Cloud

Ativar a API

Abra a página da API Developer Knowledge na biblioteca de APIs do Google.
Verifique se você selecionou o projeto correto em que pretende usar a API.
Clique em Ativar. Não é necessário ter papéis específicos do IAM para ativar ou usar a API.

Criar e proteger a chave de API

No console do Google Cloud do projeto em que você ativou a API, acesse a página Credenciais.
Clique em Criar credenciais e selecione Chave de API no menu. A caixa de diálogo Chave de API criada mostra a string da chave recém-criada.
Clique em Editar chave de API.
No campo Nome, forneça um nome para a chave.
Em Restrições da API, selecione Restringir chave.
Na lista Selecionar APIs, ative a API Developer Knowledge e clique em OK.
- Observação: se você acabou de ativar a API Developer Knowledge, pode haver um atraso antes que ela apareça na lista Selecionar APIs.
Clique em Salvar.

Depois que a chave for criada, clique em Mostrar chave para conferir. Anote para usar ao configurar seu aplicativo de IA.

CLI gcloud

Se ainda não tiver feito isso, faça o download e instale a CLI gcloud.
Ative a API Developer Knowledge, substituindo PROJECT_ID pelo ID do projeto do Google Cloud:
```
gcloud services enable developerknowledge.googleapis.com --project=PROJECT_ID
```
Crie uma chave de API usando o mesmo ID do projeto na nuvem do Google Cloud:
```
gcloud services api-keys create --project=PROJECT_ID --display-name="DK API Key"
```
Esse comando retorna uma string de chave de API. Anote para usar ao configurar o aplicativo de IA.
Proteja a chave de API adicionando restrições de chave de API. Para maior segurança, restrinja a chave de API à API Developer Knowledge.

Etapa 2: ativar o servidor MCP do Developer Knowledge em um projeto

Para ativar o servidor MCP do Developer Knowledge no projeto do Google Cloud, faça o download e instale a CLI gcloud, e execute o comando a seguir, substituindo PROJECT_ID pelo ID do projeto do Google Cloud:

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

Se o serviço Developer Knowledge não estiver ativado para o projeto do Google Cloud, você vai receber uma solicitação para ativar o serviço antes de ativar o servidor MCP remoto.

Como prática recomendada de segurança, recomendamos que você ative os servidores MCP apenas para os serviços necessários para que o aplicativo de IA funcione.

Etapa 3: configurar o aplicativo de IA

Configure aplicativos de IA populares usando estas instruções. Substitua YOUR_API_KEY pela chave de API Developer Knowledge que você gerou na etapa anterior:

CLI do Gemini

Para configurar a CLI do Gemini, execute o seguinte comando:

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

Como alternativa, edite ou crie um dos seguintes arquivos de configuração:

No seu projeto: .gemini/settings.json
No diretório principal: ~/.gemini/settings.json

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

Gemini Code Assist

Para configurar Gemini Code Assist, edite ou crie um dos seguintes arquivos de configuração:

No seu projeto: .gemini/settings.json
No diretório principal: ~/.gemini/settings.json

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

Claude Code

Para configurar o Claude Code, execute o comando a seguir na pasta do app.

claude mcp add google-dev-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 (para um projeto específico) ou ~/.cursor/mcp.json (para todos os projetos).

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

GitHub Copilot

Para configurar o GitHub Copilot no VS Code para um único projeto, edite o arquivo .vscode/mcp.json no seu espaço de trabalho.

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

Para tornar o servidor disponível em todos os projetos, edite as suas configurações de utilizador. Clique no botão Abrir configurações (JSON).

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

Windsurf

Para configurar o Windsurf Editor, edite o arquivo ~/.codeium/windsurf/mcp_config.json.

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

Confirme a instalação

Depois de configurado, abra o aplicativo de IA e insira um comando como:

How do I list Cloud Storage buckets?

Se você encontrar uma chamada de ferramenta para search_documents ou outra ferramenta do servidor MCP do Developer Knowledge, o servidor estará funcionando corretamente.

Gerenciar o uso de tokens

A recuperação do conteúdo do documento, especialmente ao usar batch_get_documents, consome tokens na janela de contexto do aplicativo de IA. Como algumas páginas de documentação para desenvolvedores do Google são bastante grandes, buscar vários documentos pode levar rapidamente a custos mais altos, tempos de resposta mais lentos do modelo e estouro da janela de contexto.

Para otimizar a performance e evitar uma fatura inesperada, crie comandos específicos que segmentem apenas as informações necessárias. Evite solicitações amplas (por exemplo, "Compare todos os produtos do Firebase") que forcem o agente a ingerir grandes quantidades de dados de uma só vez.

Documentação incluída

Consulte a referência do Corpus para informações sobre quais documentos são pesquisados pelo servidor.

Limitações conhecidas

Escopo do conteúdo: apenas páginas visíveis publicamente na referência do Corpus são incluídas. O conteúdo de outras fontes, como GitHub, sites de OSS, blogs ou YouTube, não está incluído.
Resultados somente em inglês:o servidor oferece suporte apenas a resultados em inglês.
Dependente da rede: as ferramentas do servidor dependem de serviços ativos do Google Cloud. Se você tiver erros persistentes, verifique sua conexão de internet e a configuração da chave de API da API Developer Knowledge.

Solução de problemas

Se você encontrar problemas, verifique o seguinte:

O arquivo de configuração do MCP para sua ferramenta de IA está formatado corretamente.
Se você estiver usando o método de autenticação da API, use uma chave de API válida do Developer Knowledge no arquivo de configuração que tenha a API Developer Knowledge ativada.
Você não esgotou sua cota da API Developer Knowledge.

Model Armor

Se você estiver usando Model Armor para proteger seu aplicativo, poderá encontrar erros 403 PERMISSION_DENIED para 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, na sigla em inglês) para níveis de confiança HIGH_AND_ABOVE para reduzir falsos positivos. Se o caso de uso não envolver outras ferramentas que acessem dados particulares ou sensíveis, você também poderá desativar os filtros PIJB.

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

Instalação

Autenticar usando o OAuth

Pré-requisito: configurar a CLI do Google Cloud

Etapa 1: ativar a API Developer Knowledge em um projeto

Etapa 2: escolher seu método de autenticação

ADC

Conectar sua conta

Configurar o aplicativo de IA

Credenciais manuais

Configurar a tela de permissão OAuth

Adicionar usuários de teste

Criar um cliente OAuth

Configurar o aplicativo de IA

Adicionar credenciais OAuth

Autenticar usando uma chave de API

Etapa 1: criar uma chave de API

Console do Google Cloud

Ativar a API

Criar e proteger a chave de API

CLI gcloud

Etapa 2: ativar o servidor MCP do Developer Knowledge em um projeto

Etapa 3: configurar o aplicativo de IA

CLI do Gemini

Gemini Code Assist

Claude Code

Cursor

GitHub Copilot

Windsurf

Confirme a instalação

Gerenciar o uso de tokens

Documentação incluída

Limitações conhecidas

Solução de problemas

Model Armor

Conectar-se ao servidor MCP de conhecimento do desenvolvedor