Um servidor do Protocolo de Contexto de Modelo (MCP, na sigla em inglês) atua como um proxy entre um serviço externo que fornece contexto, dados ou recursos a um modelo de linguagem grande (LLM) ou aplicativo de IA. Os servidores do 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 do MCP e configurar a autenticação antes de usar. Para mais informações sobre como usar servidores do MCP remotos do Google e do Google Cloud, consulte Visão geral dos servidores do MCP do Google Cloud.
Endpoints do servidor
Um endpoint de serviço do MCP é o endereço de rede e a interface de comunicação (geralmente um URL) do servidor do MCP que um aplicativo de IA (o host do cliente do 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 do MCP da API Developer Knowledge tem o seguinte endpoint global do MCP:
- https://developerknowledge.googleapis.com/mcp
Ferramentas do MCP
Uma ferramenta do MCP é uma função ou capacidade executável que um servidor do MCP expõe a um LLM ou aplicativo de IA para realizar uma ação no mundo real.
Ferramentas
O servidor do MCP developerknowledge.googleapis.com tem as seguintes ferramentas:
| Ferramentas do MCP | |
|---|---|
search_documents |
Use essa ferramenta para encontrar documentação sobre produtos para desenvolvedores do Google. Os documentos contêm APIs oficiais, snippets de código, notas de versão, práticas recomendadas, guias, informações de depuração e muito mais. Ele abrange os seguintes produtos e domínios:
Essa ferramenta retorna blocos de texto, nomes e URLs para documentos correspondentes. Se os blocos retornados não forem detalhados o suficiente para responder à pergunta do usuário, use |
answer_query |
Use answer_query para receber uma resposta fundamentada a uma consulta sobre produtos para desenvolvedores do Google. Essa ferramenta tem uma cota limitada. Essa ferramenta vai sintetizar informações do corpus para gerar uma resposta à consulta. answer_query fundamenta as respostas usando o mesmo corpus que search_documents. Essa ferramenta retorna o answer_text gerado e uma lista de nomes de documentos (referências) usados para gerar a resposta. Use get_documents com os nomes dos documentos 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 até 20 documentos em uma única chamada. Os nomes dos documentos precisam ser extraídos do campo parent dos resultados de uma chamada para a ferramenta search_documents. Defina o parâmetro names como uma lista de nomes de documentos.
|
Receber especificações da ferramenta MCP
Para receber as especificações da ferramenta MCP de todas as ferramentas em um servidor do MCP, use o método tools/list. O exemplo a seguir demonstra como usar curl para listar todas as ferramentas e especificações disponíveis no momento no servidor do 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 }' |