O servidor do Protocolo de Contexto de Modelo (MCP) para desenvolvedores do Google Health permite que ferramentas para desenvolvedores e agentes com tecnologia de IA pesquisem e recuperem documentação atualizada e fundamentada para a API Google Health, sem precisar de uma chave de API ou configuração de autenticação.
Um servidor MCP atua como um proxy entre um serviço externo que fornece contexto ou dados e um aplicativo de IA (o host). O servidor MCP do Google Health Developer expõe ferramentas executáveis que permitem que modelos de linguagem grandes (LLMs) encontrem respostas precisas diretamente na documentação indexada. Para saber mais sobre servidores MCP, consulte O que é o MCP e como ele funciona?.
O servidor opera no transporte HTTP transmissível padrão do MCP em:
https://healthdevelopers.googleapis.com/mcp
Ferramentas disponíveis
O servidor oferece duas ferramentas principais para descoberta e recuperação de documentação técnica:
search_health_docs: pesquisa na documentação da API Google Health por trechos de conteúdo técnico relevantes que correspondam à sua consulta. Cada bloco inclui o título da página, o URL de origem, o conteúdo de texto relevante e o nome do recurso do documento canônico.get_health_docs: recupera o conteúdo completo em Markdown de uma ou mais páginas de documentação usando os nomes de recursos retornados porsearch_health_docs.
Para ver os esquemas completos de entrada e saída, consulte a
referência do MCP para desenvolvedores do Google Health. Todo o conteúdo é
limitado estritamente à documentação técnica pública hospedada em
https://developers.google.com/health/.
Pré-requisitos
Para se conectar ao servidor, você precisa de um ambiente de desenvolvimento de IA compatível com MCP ou de uma assistência de programação, como:
- CLI do Gemini
- Google Antigravity (CLI do Antigravity, Antigravity 2.0 ou IDE do Antigravity)
- OpenAI Codex
- Claude Code
- Cursor
- CLI do Grok
- GitHub Copilot no VS Code
Configurar o cliente
Conecte-se imediatamente usando um instalador de IDE com um clique, um único comando da CLI, um arquivo de configuração do editor ou um comando de chat automatizado. Não é necessário um projeto na nuvem do Google Cloud nem uma chave de API.
Instalação do ambiente de desenvolvimento integrado com um clique
Se você usa o Google Antigravity, o Cursor ou o Visual Studio Code, selecione um dos
botões a seguir para abrir o editor e instalar o servidor MCP
HealthDevelopers:
Adicionar ao Antigravity Adicionar ao Cursor Adicionar ao VS Code
Configuração da linha de comando e do editor
Selecione seu cliente de IA nas guias a seguir para adicionar o servidor com um único comando ou entrada de configuração:
CLI do Gemini
Adicione o servidor à
CLI do Gemini
usando o comando gemini mcp add:
gemini mcp add --transport http --scope user \
HealthDevelopers https://healthdevelopers.googleapis.com/mcpGoogle Antigravity
Adicione o servidor usando a CLI do Antigravity:
agy mcp add HealthDevelopers https://healthdevelopers.googleapis.com/mcpComo alternativa, abra ~/.gemini/config/mcp_config.json (ou
.agents/mcp_config.json no seu espaço de trabalho) e adicione HealthDevelopers em
mcpServers. A CLI do Antigravity, o Antigravity 2.0 e o IDE do Antigravity compartilham o ~/.gemini/config/mcp_config.json:
{
"mcpServers": {
"HealthDevelopers": {
"serverUrl": "https://healthdevelopers.googleapis.com/mcp"
}
}
}
Codex
Adicione o servidor ao
OpenAI Codex
usando o comando codex mcp add:
codex mcp add HealthDevelopers \
--url https://healthdevelopers.googleapis.com/mcpClaude Code
Adicione o servidor ao
Claude Code
usando o comando claude mcp add:
claude mcp add HealthDevelopers \
--transport http https://healthdevelopers.googleapis.com/mcpCursor
Se preferir a configuração manual em vez do botão de um clique, adicione o servidor a ~/.cursor/mcp.json (global) ou .cursor/mcp.json
(para envolvidos no projeto):
{
"mcpServers": {
"HealthDevelopers": {
"url": "https://healthdevelopers.googleapis.com/mcp"
}
}
}
Grok
Adicione o servidor à
CLI do Grok
usando o comando grok mcp add:
grok mcp add --transport http \
HealthDevelopers https://healthdevelopers.googleapis.com/mcpGitHub Copilot
Se você preferir a configuração manual em vez do botão de um clique, edite
.vscode/mcp.json no seu espaço de trabalho (ou adicione a configuração em uma
chave raiz "mcp" nas
configurações de usuário do VS Code):
{
"servers": {
"HealthDevelopers": {
"type": "http",
"url": "https://healthdevelopers.googleapis.com/mcp"
}
}
}
Configuração automatizada usando um comando
Se o assistente de IA permitir o gerenciamento de configurações de ferramentas do MCP diretamente do chat, instrua-o a configurar o servidor colando o seguinte comando:
Please configure the Google Health Developer MCP server for me: - Name: HealthDevelopers - Server URL: https://healthdevelopers.googleapis.com/mcp - Transport: http
Verifique sua conexão
Confirme se o HealthDevelopers está conectado na CLI do Gemini ou no Google
Antigravity:
CLI do Gemini
Execute gemini mcp list no terminal (ou insira /mcp em uma
sessão interativa):
gemini mcp listConfirme se HealthDevelopers informa Connected:
Configured MCP servers:
✓ HealthDevelopers: https://healthdevelopers.googleapis.com/mcp (http) - Connected
Google Antigravity
CLI do Antigravity: digite
/mcpno painel de comando para abrir o Gerenciador de MCP e confirme seHealthDevelopersmostra um anel de status ativo ou executeagy mcp listno terminal:NAME TYPE STATUS COMMAND/URL HealthDevelopers http enabled https://healthdevelopers.googleapis.com/mcpIDE do Antigravity: clique em ... na parte de cima do painel lateral do agente, selecione Servidores MCP > Gerenciar servidores MCP e confirme se
HealthDevelopersestá ativado.Antigravity 2.0: abra Configurações > Personalizações > Servidores MCP instalados e confirme se
HealthDevelopersestá listado.
Exemplos de comandos
Depois de conectado, o assistente chama automaticamente search_health_docs e
get_health_docs quando você pergunta sobre a API Google Health:
What OAuth scopes are needed to read steps and heart rate data in the Google Health API, and how do I query daily step rollups?
Migrate my Fitbit Web API /1/user/-/activities/steps endpoint call to the Google Health API v4.
How do I set up webhook subscriptions in the Google Health API to receive updates when new sleep or workout data arrives?
Testar com curl
Também é possível testar o endpoint diretamente usando curl. O transporte HTTP transmissível do MCP
exige os cabeçalhos Content-Type: application/json e
Accept: application/json, text/event-stream.
Listar ferramentas disponíveis
Execute o comando a seguir para listar as ferramentas expostas pelo servidor:
curl -s -X POST "https://healthdevelopers.googleapis.com/mcp" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {}
}'Pesquisar documentação
Execute o seguinte comando para testar search_health_docs:
curl -s -X POST "https://healthdevelopers.googleapis.com/mcp" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "search_health_docs",
"arguments": {
"query": "steps scope",
"pageSize": 2
}
}
}'Recuperar o Markdown do documento completo
Execute o seguinte comando para testar get_health_docs:
curl -s -X POST "https://healthdevelopers.googleapis.com/mcp" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "get_health_docs",
"arguments": {
"names": [
"documents/developers.google.com/health/data-types/steps"
]
}
}
}'Feedback e suporte
Para informar problemas, sugerir melhorias ou receber ajuda com o servidor MCP para desenvolvedores do Google Health, use os canais de feedback e suporte na página de suporte da API Google Health.