MCP Reference: developerknowledge.googleapis.com

Um servidor do Protocolo de Contexto de Modelo (MCP) atua como um proxy entre um serviço externo que fornece contexto, dados ou recursos para um modelo de linguagem grande (LLM) ou aplicativo de IA. Os servidores MCP conectam aplicativos de IA a sistemas externos, como bancos de dados e serviços da Web, traduzindo as respostas em um formato que o aplicativo de IA possa entender.

Configuração do servidor

É necessário ativar os servidores MCP e configurar a autenticação antes do uso. Para mais informações sobre como usar os servidores MCP remotos do Google e do Google Cloud, consulte Visão geral dos servidores MCP do Google Cloud.

Endpoints do servidor

Um endpoint de serviço MCP é o endereço de rede e a interface de comunicação (geralmente um URL) do servidor MCP que um aplicativo de IA (o host do cliente MCP) usa para estabelecer uma conexão segura e padronizada. É o ponto de contato para o LLM solicitar contexto, chamar uma ferramenta ou acessar um recurso. Os endpoints do MCP do Google podem ser globais ou regionais.

O servidor MCP da API Developer Knowledge tem o seguinte endpoint MCP global:

  • https://developerknowledge.googleapis.com/mcp

Ferramentas do MCP

Uma ferramenta MCP é uma função ou recurso executável que um servidor MCP expõe a um LLM ou aplicativo de IA para realizar uma ação no mundo real.

Ferramentas

O servidor MCP developerknowledge.googleapis.com tem as seguintes ferramentas:

Ferramentas do MCP
search_documents

Use esta ferramenta para encontrar documentação sobre os produtos do Google Developers. Os documentos contêm APIs oficiais, snippets de código, notas da versão, práticas recomendadas, guias, informações de depuração e muito mais. Ele abrange os seguintes produtos e domínios:

  • ADK: adk.dev

  • Android: developer.android.com

  • Apigee: docs.apigee.com

  • Chrome: developer.chrome.com

  • Dart: dart.dev

  • Firebase: firebase.google.com

  • Flutter: docs.flutter.dev

  • Fuchsia: fuchsia.dev

  • CLI do Gemini: geminicli.com

  • Genkit: genkit.dev

  • Go: go.dev

  • IA do Google: ai.google.dev

  • Google Antigravity: antigravity.google

  • Google Cloud: cloud.google.com e docs.cloud.google.com

  • Google Developers, Ads, Pesquisa, Google Maps, YouTube: developers.google.com

  • Google Home: developers.home.google.com

  • Plataforma Google Maps: mapsplatform.google.com

  • Google Workspace: knowledge.workspace.google.com

  • TensorFlow: www.tensorflow.org

  • Web: web.dev

Essa ferramenta retorna blocos de texto, nomes e URIs para documentos correspondentes. Prefira search_documents seguido por get_documents quando precisar de exemplos de código exatos, flags da CLI, mensagens de erro específicas, tutoriais completos ou pesquisa de palavras-chave determinística. Se os trechos retornados não forem detalhados o suficiente para responder à pergunta do usuário, use get_documents com o parent da saída dessa ferramenta para recuperar o conteúdo completo do documento. Ao responder ao usuário, sempre cite os nomes de recursos (documents/...) ou URIs do documento de origem confiável.
answer_query

Use answer_query para receber uma resposta conceitual, fundamentada e sintetizada a uma pergunta de alto nível sobre os produtos do Google Developers. Para exemplos de código exatos, flags da CLI, mensagens de erro específicas ou tutoriais completos de documentos, prefira search_documents seguido por get_documents. Essa ferramenta tem uma cota limitada. Essa ferramenta sintetiza as informações do corpus para gerar uma resposta à consulta. O answer_query embasa as respostas usando o mesmo corpus que o search_documents. Essa ferramenta retorna o answer_text gerado e uma lista de nomes de documentos (referências) usados para gerar a resposta. Sempre cite os nomes dos documentos de origem confiáveis de references (documents/...) na sua resposta final ao usuário. Use get_documents com os nomes de documentos de references para buscar todo o conteúdo do documento, se necessário.

Se você receber um erro 429 de cota excedida, use search_documents.
get_documents Use essa ferramenta para recuperar o conteúdo completo de um único documento ou de até 20 documentos em uma única chamada. Os nomes dos documentos devem ser obtidos do campo parent dos resultados de uma chamada para a ferramenta search_documents ou do campo references retornado pela ferramenta answer_query. Defina o parâmetro names como uma lista de nomes de documentos (documents/...) e cite os documentos de origem confiáveis usados na resposta final.

Receber especificações da ferramenta MCP

Para receber as especificações de todas as ferramentas em um servidor MCP, use o método tools/list. O exemplo a seguir demonstra como usar curl para listar todas as ferramentas e as especificações delas disponíveis no servidor MCP.

Solicitação curl 
curl --location 'https://developerknowledge.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'