Google Health Developer Model Context Protocol (MCP) sunucusu, yapay zeka destekli geliştirici araçlarına ve temsilcilerine, Google Health API için güncel ve güvenilir belgeleri arama ve alma olanağı sunar. API anahtarı veya kimlik doğrulama kurulumu gerekmez.
MCP sunucusu, bağlam veya veri sağlayan harici bir hizmet ile yapay zeka uygulaması (ana makine) arasında proxy görevi görür. Google Health Developer MCP sunucusu, büyük dil modellerinin (LLM'ler) dizine eklenmiş dokümanlardan doğrudan kesin yanıtlar bulmasını sağlayan yürütülebilir araçlar sunar. MCP sunucuları hakkında daha fazla bilgi edinmek için MCP nedir ve nasıl çalışır? başlıklı makaleyi inceleyin.
Sunucu, standart MCP Streamable HTTP aktarımı üzerinden şu adreste çalışır:
https://healthdevelopers.googleapis.com/mcp
Mevcut araçlar
Sunucu, teknik dokümanları keşfetmek ve almak için iki temel araç sağlar:
search_health_docs: Sorgunuzla eşleşen alakalı teknik içerik parçaları için Google Health API belgelerinde arama yapar. Her parça; sayfa başlığını, kaynak URL'yi, alakalı metin içeriğini ve standart doküman kaynak adını içerir.get_health_docs:search_health_docstarafından döndürülen kaynak adlarını kullanarak bir veya daha fazla doküman sayfasının tam Markdown içeriğini alır.
Giriş ve çıkış şemalarının tamamı için Google Health Developer MCP referansına bakın. Tüm içerikler, https://developers.google.com/health/ adresinde barındırılan herkese açık teknik dokümanlarla sınırlıdır.
Ön koşullar
Sunucuya bağlanmak için MCP uyumlu bir yapay zeka geliştirme ortamına veya kod yazma desteğine ihtiyacınız vardır. Örneğin:
- Gemini CLI
- Google Antigravity (Antigravity CLI, Antigravity 2.0 veya Antigravity IDE)
- OpenAI Codex
- Claude Code
- İmleç
- Grok CLI
- VS Code'da GitHub Copilot
İstemcinizi yapılandırma
Tek tıklamayla IDE yükleyici, tek bir KSA komutu, düzenleyici yapılandırma dosyası veya otomatik sohbet istemi kullanarak hemen bağlanın. Google Cloud projesi veya API anahtarı gerekmez.
Tek tıklamayla IDE kurulumu
Google Antigravity, Cursor veya Visual Studio Code kullanıyorsanız düzenleyicinizi açmak ve HealthDevelopers MCP sunucusunu yüklemek için aşağıdaki düğmelerden birini seçin:
Antigravity'ye ekle Cursor'a ekle VS Code'a ekle
Komut satırı ve düzenleyici kurulumu
Sunucuyu tek bir komut veya yapılandırma girişiyle eklemek için aşağıdaki sekmelerden yapay zeka istemcinizi seçin:
Gemini CLI
gemini mcp add komutunu kullanarak sunucuyu Gemini CLI'ya ekleyin:
gemini mcp add --transport http --scope user \
HealthDevelopers https://healthdevelopers.googleapis.com/mcpGoogle Antigravity
Antigravity CLI'yı kullanarak sunucuyu ekleyin:
agy mcp add HealthDevelopers https://healthdevelopers.googleapis.com/mcpAlternatif olarak, ~/.gemini/config/mcp_config.json (veya çalışma alanınızda .agents/mcp_config.json) dosyasını açın ve mcpServers altına HealthDevelopers ekleyin. Antigravity CLI, Antigravity 2.0 ve Antigravity IDE'nin ortak özellikleri ~/.gemini/config/mcp_config.json:
{
"mcpServers": {
"HealthDevelopers": {
"serverUrl": "https://healthdevelopers.googleapis.com/mcp"
}
}
}
Codex
codex mcp add komutunu kullanarak sunucuyu OpenAI Codex'e ekleyin:
codex mcp add HealthDevelopers \
--url https://healthdevelopers.googleapis.com/mcpClaude Code
claude mcp add komutunu kullanarak sunucuyu Claude Code'a ekleyin:
claude mcp add HealthDevelopers \
--transport http https://healthdevelopers.googleapis.com/mcpİmleç
Tek tıklamayla yapılandırma yerine manuel yapılandırmayı tercih ederseniz sunucuyu ~/.cursor/mcp.json (genel) veya .cursor/mcp.json (proje düzeyinde) ekleyin:
{
"mcpServers": {
"HealthDevelopers": {
"url": "https://healthdevelopers.googleapis.com/mcp"
}
}
}
Grok
grok mcp add komutunu kullanarak sunucuyu Grok CLI'ya ekleyin:
grok mcp add --transport http \
HealthDevelopers https://healthdevelopers.googleapis.com/mcpGitHub Copilot
Tek tıklama düğmesi yerine manuel yapılandırmayı tercih ediyorsanız çalışma alanınızda .vscode/mcp.json dosyasını düzenleyin (veya yapılandırmayı VS Code kullanıcı ayarlarınızda "mcp" kök anahtarının altına ekleyin):
{
"servers": {
"HealthDevelopers": {
"type": "http",
"url": "https://healthdevelopers.googleapis.com/mcp"
}
}
}
İstem kullanarak otomatik kurulum
Yapay zeka asistanınız, MCP aracı yapılandırmalarını doğrudan sohbetten yönetmeyi destekliyorsa aşağıdaki istemi yapıştırarak asistanınıza sunucuyu yapılandırması talimatını verin:
Please configure the Google Health Developer MCP server for me: - Name: HealthDevelopers - Server URL: https://healthdevelopers.googleapis.com/mcp - Transport: http
Bağlantınızı doğrulama
HealthDevelopers projesinin Gemini CLI veya Google Antigravity'ye bağlı olduğunu onaylayın:
Gemini CLI
Terminalinizden gemini mcp list komutunu çalıştırın (veya etkileşimli oturumda /mcp komutunu girin):
gemini mcp listHealthDevelopers, Connected raporu veriyor:
Configured MCP servers:
✓ HealthDevelopers: https://healthdevelopers.googleapis.com/mcp (http) - Connected
Google Antigravity
Antigravity CLI: MCP Manager'ı açmak için istem panelinde
/mcpkomutunu girin veHealthDeveloperskomutunun etkin bir durum halkası gösterdiğini onaylayın veya terminalinizdenagy mcp listkomutunu çalıştırın:NAME TYPE STATUS COMMAND/URL HealthDevelopers http enabled https://healthdevelopers.googleapis.com/mcpAntigravity IDE: Temsilci yan panelinin üst kısmındaki ... simgesini tıklayın, MCP Sunucuları > MCP Sunucularını Yönet'i seçin ve
HealthDevelopersaracının etkinleştirildiğini onaylayın.Antigravity 2.0: Settings (Ayarlar) > Customizations (Özelleştirmeler) > Installed MCP Servers'ı (Yüklü MCP Sunucuları) açın ve
HealthDevelopers'nin listede olduğunu onaylayın.
Örnek istemler
Bağlantı kurulduktan sonra asistanınız, Google Health API hakkında soru sorduğunuzda otomatik olarak search_health_docs ve get_health_docs hizmetlerini çağırır:
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?
curl ile test etme
Uç noktayı curl kullanarak doğrudan da test edebilirsiniz. MCP Streamable HTTP aktarımı için hem Content-Type: application/json hem de Accept: application/json, text/event-stream başlıkları gerekir.
Kullanılabilir araçları listeleme
Sunucu tarafından sunulan araçları listelemek için aşağıdaki komutu çalıştırın:
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": {}
}'Belgelerde arama yapma
search_health_docs test etmek için aşağıdaki komutu çalıştırın:
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
}
}
}'Dokümanın tamamını Markdown olarak alma
get_health_docs test etmek için aşağıdaki komutu çalıştırın:
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"
]
}
}
}'Geri bildirim ve destek
Sorunları bildirmek, iyileştirme önerilerinde bulunmak veya Google Health Developer MCP sunucusuyla ilgili yardım almak için Google Health API destek sayfasındaki geri bildirim ve destek kanallarını kullanın.