Server MCP per gli sviluppatori di Google Health

Il server Model Context Protocol (MCP) di Google Health Developer offre agli strumenti per sviluppatori e agli agenti basati sull'AI la possibilità di cercare e recuperare documentazione aggiornata e con grounding per l'API Google Health, senza bisogno di una chiave API o di una configurazione di autenticazione.

Un server MCP funge da proxy tra un servizio esterno che fornisce contesto o dati e un'applicazione AI (l'host). Il server MCP per sviluppatori di Google Health espone strumenti eseguibili che consentono ai modelli linguistici di grandi dimensioni (LLM) di trovare risposte precise direttamente dalla documentazione indicizzata. Per scoprire di più sui server MCP, consulta Che cos'è l'MCP e come funziona?.

Il server opera tramite il trasporto HTTP Streamable MCP standard all'indirizzo:

https://healthdevelopers.googleapis.com/mcp

Strumenti disponibili

Il server fornisce due strumenti principali per il rilevamento e il recupero della documentazione tecnica:

  • search_health_docs: cerca nella documentazione dell'API Google Health i blocchi di contenuti tecnici pertinenti che corrispondono alla tua query. Ogni segmento include il titolo della pagina, l'URL di origine, i contenuti di testo pertinenti e il nome della risorsa del documento canonico.
  • get_health_docs: recupera i contenuti Markdown completi di una o più pagine della documentazione utilizzando i nomi delle risorse restituiti da search_health_docs.

Per gli schemi di input e output completi, consulta il riferimento MCP per gli sviluppatori di Google Health. Tutti i contenuti sono limitati rigorosamente alla documentazione tecnica pubblica ospitata in https://developers.google.com/health/.

Prerequisiti

Per connetterti al server, devi disporre di un ambiente di sviluppo AI o di un assistente al coding compatibile con MCP, ad esempio:

Configura il client

Connettiti immediatamente utilizzando un programma di installazione dell'IDE con un solo clic, un singolo comando CLI, un file di configurazione dell'editor o un prompt di chat automatico. Non è richiesto alcun progetto cloud Google Cloud o chiave API.

Installazione dell'IDE con un solo clic

Se utilizzi Google Antigravity, Cursor o Visual Studio Code, seleziona uno dei seguenti pulsanti per aprire l'editor e installare il server MCP HealthDevelopers:

Aggiungi ad Antigravity Aggiungi a Cursor Aggiungi a VS Code

Configurazione della riga di comando e dell'editor

Seleziona il tuo client AI dalle seguenti schede per aggiungere il server con un singolo comando o una singola voce di configurazione:

Gemini CLI

Aggiungi il server a Gemini CLI utilizzando il comando gemini mcp add:

gemini mcp add --transport http --scope user \
  HealthDevelopers https://healthdevelopers.googleapis.com/mcp

Google Antigravity

Aggiungi il server utilizzando l'Antigravity CLI:

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

In alternativa, apri ~/.gemini/config/mcp_config.json (o .agents/mcp_config.json nella tua area di lavoro) e aggiungi HealthDevelopers in mcpServers. Antigravity CLI, Antigravity 2.0 e Antigravity IDE condividono tutte ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "HealthDevelopers": {
      "serverUrl": "https://healthdevelopers.googleapis.com/mcp"
    }
  }
}

Codex

Aggiungi il server a OpenAI Codex utilizzando il comando codex mcp add:

codex mcp add HealthDevelopers \
  --url https://healthdevelopers.googleapis.com/mcp

Claude Code

Aggiungi il server a Claude Code utilizzando il comando claude mcp add:

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

Cursore

Se preferisci la configurazione manuale anziché il pulsante con un solo clic, aggiungi il server a ~/.cursor/mcp.json (globale) o .cursor/mcp.json (a livello di progetto):

{
  "mcpServers": {
    "HealthDevelopers": {
      "url": "https://healthdevelopers.googleapis.com/mcp"
    }
  }
}

Grok

Aggiungi il server all'interfaccia a riga di comando Grok utilizzando il comando grok mcp add:

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

GitHub Copilot

Se preferisci la configurazione manuale anziché il pulsante con un solo clic, modifica .vscode/mcp.json nel tuo workspace (o aggiungi la configurazione sotto una chiave root "mcp" nelle impostazioni utente di VS Code):

{
  "servers": {
    "HealthDevelopers": {
      "type": "http",
      "url": "https://healthdevelopers.googleapis.com/mcp"
    }
  }
}

Configurazione automatica tramite un prompt

Se l'assistente AI supporta la gestione delle configurazioni degli strumenti MCP direttamente dalla chat, chiedigli di configurare il server incollando il seguente prompt:

Please configure the Google Health Developer MCP server for me:
- Name: HealthDevelopers
- Server URL: https://healthdevelopers.googleapis.com/mcp
- Transport: http

Verifica la connessione

Verifica che HealthDevelopers sia connesso in Gemini CLI o Google Antigravity:

Gemini CLI

Esegui gemini mcp list dal terminale (o inserisci /mcp all'interno di una sessione interattiva):

gemini mcp list

Verifica che HealthDevelopers riporti Connected:

Configured MCP servers:

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

Google Antigravity

  • Antigravity CLI: inserisci /mcp nel riquadro dei prompt per aprire MCP Manager e verifica che HealthDevelopers mostri un anello di stato attivo oppure esegui agy mcp list dal terminale:

    NAME              TYPE  STATUS   COMMAND/URL
    HealthDevelopers  http  enabled  https://healthdevelopers.googleapis.com/mcp
    
  • Antigravity IDE: fai clic su … nella parte superiore del riquadro laterale dell'agente, seleziona Server MCP > Gestisci server MCP e verifica che HealthDevelopers sia abilitato.

  • Antigravity 2.0: apri Impostazioni > Personalizzazioni > Server MCP installati e verifica che HealthDevelopers sia presente nell'elenco.

Prompt di esempio

Una volta connesso, l'assistente chiama automaticamente search_health_docs e get_health_docs quando chiedi informazioni sull'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?

Esegui il test con curl

Puoi anche testare l'endpoint direttamente utilizzando curl. Il trasporto HTTP trasmissibile in streaming MCP richiede le intestazioni Content-Type: application/json e Accept: application/json, text/event-stream.

Elenca gli strumenti disponibili

Esegui questo comando per elencare gli strumenti esposti dal server:

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": {}
  }'

Cerca nella documentazione

Esegui questo comando per testare 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
      }
    }
  }'

Recupera il Markdown del documento completo

Esegui questo comando per testare 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 assistenza

Per segnalare problemi, suggerire miglioramenti o ricevere assistenza con il server MCP per sviluppatori di Google Health, utilizza i canali di feedback e assistenza nella pagina di assistenza dell'API Google Health.