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 ve Gemini Code Assist
- Android Studio
- Google Antigravity (Antigravity CLI, Antigravity 2.0 veya Antigravity IDE)
- Diğer Streamable HTTP MCP istemcileri (ör. Claude, Cursor, Visual Studio Code, OpenAI Codex veya JetBrains IDE'leri)
İ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 ve Code Assist
gemini mcp add komutunu kullanarak sunucuyu Gemini CLI'ya ekleyin:
gemini mcp add --transport http --scope user \
HealthDevelopers https://healthdevelopers.googleapis.com/mcpVS Code'da Gemini Code Assist Temsilci Modu'nu yapılandırmak (veya paylaşılan Gemini CLI ayarları dosyasını doğrudan düzenlemek) için ~/.gemini/settings.json dosyasına HealthDevelopers satırını ekleyin ve Komut Paleti'nden Developer: Reload Window komutunu çalıştırın:
{
"mcpServers": {
"HealthDevelopers": {
"httpUrl": "https://healthdevelopers.googleapis.com/mcp"
}
}
}
JetBrains IDE'lerinde Gemini Code Assist için mcp.json dosyasını, Gemini Code Assist MCP kılavuzunda açıklandığı şekilde IDE yapılandırma dizininizde yapılandırın.
Android Studio
Android Studio'da Gemini'ı bağlamak için Dosya (macOS'te Android Studio) > Ayarlar > Araçlar > Yapay Zeka > MCP Sunucuları'nı açın, JSON ile ekle'yi seçin ve HealthDevelopers öğesini mcp.json konumuna ekleyin (Android Studio, akış yapılabilir HTTP sunucuları için httpUrl gerektirir):
{
"mcpServers": {
"HealthDevelopers": {
"httpUrl": "https://healthdevelopers.googleapis.com/mcp"
}
}
}
Kaydettikten sonra, search_health_docs ve get_health_docs'nin kullanılabilir olduğunu doğrulamak için Android Studio'daki Gemini sohbet paneline /mcp yazın.
Google Antigravity
Kabuğunuzdan resmi google-health-developer eklentisini (HealthDevelopers MCP sunucusunu ve doküman temellendirme kuralını içerir) yükleyin veya etkileşimli bir oturumda /plugin install google-health-developer@antigravity-plugins-official komutunu çalıştırın:
agy plugin install google-health-developer@antigravity-plugins-officialEklenti olmadan yalnızca MCP sunucusunu kaydetmek için Antigravity CLI'yı kullanın:
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"
}
}
}
Diğer MCP istemcileri
Streamable HTTP'yi destekleyen herhangi bir üçüncü taraf MCP istemcisini (ör. Claude, Cursor, Visual Studio Code, OpenAI Codex veya JetBrains IDE'leri) bağlamak için aşağıdaki uç noktayı kullanarak kimlik doğrulama başlıkları gerektirmeyen uzak bir HTTP MCP sunucusu yapılandırın:
https://healthdevelopers.googleapis.com/mcp
Standart JSON yapılandırma şablonu (Tam dosya yolları, anahtarlar ve biçimler istemciye göre değişir). İstemciye özel kurulum ayrıntıları için istemcinizin MCP belgelerine veya Google Cloud MCP istemci kılavuzuna bakın:
{
"mcpServers": {
"HealthDevelopers": {
"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, Gemini Code Assist veya Google Antigravity'ye bağlı olduğunu onaylayın:
Gemini CLI ve Code Assist
Gemini CLI'da, terminalinizden gemini mcp list komutunu çalıştırın (veya etkileşimli bir oturumda /mcp komutunu girin). VS Code'da Gemini Code Assist temsilci modunda,
sohbet paneline /mcp yazın:
gemini mcp listHealthDevelopers, Connected raporu veriyor:
Configured MCP servers:
✓ HealthDevelopers: https://healthdevelopers.googleapis.com/mcp (http) - Connected
Google Antigravity
- Eklenti yükleme: Terminalinizden
agy plugin listkomutunu çalıştırın (veya Antigravity 2.0'da Customizations > Installed'ı açın) vegoogle-health-developereklentisinin etkin olarak listelendiğini doğrulayın. 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.