Servidor MCP do Google Health para desenvolvedores

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 por search_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:

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/mcp

Google Antigravity

Adicione o servidor usando a CLI do Antigravity:

agy mcp add HealthDevelopers https://healthdevelopers.googleapis.com/mcp

Como 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/mcp

Claude Code

Adicione o servidor ao Claude Code usando o comando claude mcp add:

claude mcp add HealthDevelopers \
  --transport http https://healthdevelopers.googleapis.com/mcp

Cursor

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/mcp

GitHub 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 list

Confirme se HealthDevelopers informa Connected:

Configured MCP servers:

✓ HealthDevelopers: https://healthdevelopers.googleapis.com/mcp (http) - Connected

Google Antigravity

  • CLI do Antigravity: digite /mcp no painel de comando para abrir o Gerenciador de MCP e confirme se HealthDevelopers mostra um anel de status ativo ou execute agy mcp list no terminal:

    NAME              TYPE  STATUS   COMMAND/URL
    HealthDevelopers  http  enabled  https://healthdevelopers.googleapis.com/mcp
    
  • IDE do Antigravity: clique em ... na parte de cima do painel lateral do agente, selecione Servidores MCP > Gerenciar servidores MCP e confirme se HealthDevelopers está ativado.

  • Antigravity 2.0: abra Configurações > Personalizações > Servidores MCP instalados e confirme se HealthDevelopers está 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.