שרת MCP למפתחים של Google Health

שרת 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, כמו:

הגדרת הלקוח

אפשר להתחבר מיד באמצעות תוכנת התקנה של סביבת פיתוח משולבת (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/mcp

Google 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/mcp

Claude 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/mcp

GitHub 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/mcp
    
  • ‫Antigravity 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.