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 dasearch_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:
- Gemini CLI
- Google Antigravity (Antigravity CLI, Antigravity 2.0 o Antigravity IDE)
- Codex di OpenAI
- Claude Code
- Cursore
- Grok CLI
- GitHub Copilot in VS Code
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/mcpGoogle Antigravity
Aggiungi il server utilizzando l'Antigravity CLI:
agy mcp add HealthDevelopers https://healthdevelopers.googleapis.com/mcpIn 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/mcpClaude Code
Aggiungi il server a Claude Code utilizzando il comando claude mcp add:
claude mcp add HealthDevelopers \
--transport http https://healthdevelopers.googleapis.com/mcpCursore
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/mcpGitHub 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 listVerifica che HealthDevelopers riporti Connected:
Configured MCP servers:
✓ HealthDevelopers: https://healthdevelopers.googleapis.com/mcp (http) - Connected
Google Antigravity
Antigravity CLI: inserisci
/mcpnel riquadro dei prompt per aprire MCP Manager e verifica cheHealthDevelopersmostri un anello di stato attivo oppure eseguiagy mcp listdal terminale:NAME TYPE STATUS COMMAND/URL HealthDevelopers http enabled https://healthdevelopers.googleapis.com/mcpAntigravity IDE: fai clic su … nella parte superiore del riquadro laterale dell'agente, seleziona Server MCP > Gestisci server MCP e verifica che
HealthDeveloperssia abilitato.Antigravity 2.0: apri Impostazioni > Personalizzazioni > Server MCP installati e verifica che
HealthDeveloperssia 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.