שרת Model Context Protocol (MCP) של Google Health Developer מאפשר לכלים למפתחים ולסוכנים שמבוססים-AI לחפש ולאחזר מאמרי עזרה עדכניים ומעוגנים בנתונים של Google Health API, בלי צורך במפתח API או בהגדרת אימות.
שרת MCP פועל כשרת proxy בין שירות חיצוני שמספק הקשר או נתונים לבין אפליקציית AI (המארח). שרת Google Health Developer MCP חושף כלים שניתנים להפעלה ומאפשרים למודלים גדולים של שפה (LLM) למצוא תשובות מדויקות ישירות מהמסמכים שנוספו לאינדקס. מה זה MCP ואיך הוא עובד?
השרת פועל באמצעות פרוטוקול התעבורה הסטנדרטי של MCP, Streamable HTTP, בכתובת:
https://healthdevelopers.googleapis.com/mcp
באילו כלים אפשר להשתמש
השרת מספק שני כלים עיקריים לחיפוש ולאחזור של מסמכים טכניים:
-
search_health_docs: חיפוש במאמרי העזרה של Google Health API כדי למצוא קטעי תוכן טכניים רלוונטיים שתואמים לשאילתה. כל קטע כולל את כותרת הדף, כתובת ה-URL של המקור, תוכן הטקסט הרלוונטי ושם המשאב הקנוני של המסמך. -
get_health_docs: מאחזר את תוכן ה-Markdown המלא של דף תיעוד אחד או יותר באמצעות שמות המשאבים שהוחזרו על ידיsearch_health_docs.
סכימות מלאות של קלט ופלט מפורטות במסמכי העזרה של Google Health Developer MCP. כל התוכן מוגבל אך ורק לתיעוד טכני שגלוי לכולם ומאוחסן בכתובת https://developers.google.com/health/.
דרישות מוקדמות
כדי להתחבר לשרת, צריך סביבת פיתוח של AI או עזרה בתכנות שתואמים ל-MCP, כמו:
- Gemini CLI
- Google Antigravity (Antigravity CLI, Antigravity 2.0, או Antigravity IDE)
- OpenAI Codex
- Claude Code
- Cursor
- Grok CLI
- GitHub Copilot ב-VS Code
הגדרת הלקוח
אפשר להתחבר מיד באמצעות תוכנת התקנה של סביבת פיתוח משולבת (IDE) בלחיצה אחת, פקודת CLI אחת, קובץ תצורה של עורך או הנחיה אוטומטית בצ'אט. לא צריך פרויקט בענן של Google או מפתח API.
התקנת IDE בלחיצה אחת
אם אתם משתמשים ב-Google Antigravity, ב-Cursor או ב-Visual Studio Code, בחרו באחד מהכפתורים הבאים כדי לפתוח את הכלי לעריכת קוד ולהתקין את שרת ה-MCP של HealthDevelopers:
הוספה ל-Antigravity הוספה ל-Cursor הוספה ל-VS Code
הגדרת שורת הפקודה והעורך
בוחרים את לקוח ה-AI מהכרטיסיות הבאות כדי להוסיף את השרת באמצעות פקודה אחת או רשומת הגדרה אחת:
Gemini CLI
מוסיפים את השרת ל-Gemini CLI באמצעות הפקודה gemini mcp add:
gemini mcp add --transport http --scope user \
HealthDevelopers https://healthdevelopers.googleapis.com/mcpGoogle Antigravity
מוסיפים את השרת באמצעות Antigravity CLI:
agy mcp add HealthDevelopers https://healthdevelopers.googleapis.com/mcpלחלופין, פותחים את ~/.gemini/config/mcp_config.json (או את .agents/mcp_config.json בסביבת העבודה) ומוסיפים את HealthDevelopers בקטע mcpServers. Antigravity CLI, Antigravity 2.0 ו-Antigravity IDE חולקים את ~/.gemini/config/mcp_config.json:
{
"mcpServers": {
"HealthDevelopers": {
"serverUrl": "https://healthdevelopers.googleapis.com/mcp"
}
}
}
Codex
מוסיפים את השרת ל-OpenAI Codex באמצעות הפקודה codex mcp add:
codex mcp add HealthDevelopers \
--url https://healthdevelopers.googleapis.com/mcpClaude Code
מוסיפים את השרת ל-Claude Code באמצעות הפקודה claude mcp add:
claude mcp add HealthDevelopers \
--transport http https://healthdevelopers.googleapis.com/mcpסמן
אם אתם מעדיפים הגדרה ידנית במקום לחיצה על הכפתור, הוסיפו את השרת ל-~/.cursor/mcp.json (גלובלי) או ל-.cursor/mcp.json (ברמת הפרויקט):
{
"mcpServers": {
"HealthDevelopers": {
"url": "https://healthdevelopers.googleapis.com/mcp"
}
}
}
Grok
מוסיפים את השרת ל-Grok CLI באמצעות הפקודה grok mcp add:
grok mcp add --transport http \
HealthDevelopers https://healthdevelopers.googleapis.com/mcpGitHub Copilot
אם אתם מעדיפים להגדיר באופן ידני במקום ללחוץ על הכפתור, ערכו את .vscode/mcp.json בסביבת העבודה שלכם (או הוסיפו את ההגדרות מתחת למפתח הבסיס "mcp" בהגדרות המשתמש של VS Code):
{
"servers": {
"HealthDevelopers": {
"type": "http",
"url": "https://healthdevelopers.googleapis.com/mcp"
}
}
}
הגדרה אוטומטית באמצעות הנחיה
אם העוזר האישי מבוסס-AI שלכם תומך בניהול הגדרות של כלי MCP ישירות מהצ'אט, הנחו את העוזר האישי מבוסס-AI להגדיר את השרת על ידי הדבקת הפרומפט הבא:
Please configure the Google Health Developer MCP server for me: - Name: HealthDevelopers - Server URL: https://healthdevelopers.googleapis.com/mcp - Transport: http
אימות החיבור
מוודאים ש-HealthDevelopers מחובר ב-Gemini CLI או ב-Google Antigravity:
Gemini CLI
מריצים את הפקודה gemini mcp list מהטרמינל (או מזינים את הפקודה /mcp בסשן אינטראקטיבי):
gemini mcp listמוודאים ש-HealthDevelopers מדווח על Connected:
Configured MCP servers:
✓ HealthDevelopers: https://healthdevelopers.googleapis.com/mcp (http) - Connected
Google Antigravity
Antigravity CLI: מזינים
/mcpבחלונית ההנחיות כדי לפתוח את מנהל ה-MCP, ומוודאים שמוצגת טבעת סטטוס פעיל לידHealthDevelopers. לחלופין, מריצים את הפקודהagy mcp listבטרמינל:NAME TYPE STATUS COMMAND/URL HealthDevelopers http enabled https://healthdevelopers.googleapis.com/mcpAntigravity IDE: לוחצים על … בחלק העליון של החלונית הצדדית של הנציג, בוחרים באפשרות שרתי MCP > ניהול שרתי MCP ומוודאים שהאפשרות
HealthDevelopersמופעלת.Antigravity 2.0: פותחים את Settings (הגדרות) > Customizations (התאמות אישיות) > Installed MCP Servers (שרתי MCP מותקנים) ומוודאים ש-
HealthDevelopersמופיע ברשימה.
הנחיות לדוגמה
אחרי החיבור, Assistant תבצע שיחות אוטומטיות אל search_health_docs ואל get_health_docs כשתשאלו על Google Health API:
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
אפשר גם לבדוק את נקודת הקצה ישירות באמצעות curl. כדי להשתמש ב-MCP Streamable HTTP, צריך להוסיף את הכותרות Content-Type: application/json ו-Accept: application/json, text/event-stream.
רשימת הכלים הזמינים
מריצים את הפקודה הבאה כדי להציג את הכלים שהשרת חושף:
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": {}
}'חיפוש בתיעוד
מריצים את הפקודה הבאה כדי לבדוק את 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
}
}
}'אחזור של Markdown של מסמך מלא
מריצים את הפקודה הבאה כדי לבדוק את 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"
]
}
}
}'משוב ותמיכה
כדי לדווח על בעיות, להציע שיפורים או לקבל עזרה לגבי שרת ה-MCP למפתחים של Google Health, אתם יכולים להשתמש בערוצי התמיכה והמשוב בדף התמיכה של Google Health API.