Google Health 개발자 모델 컨텍스트 프로토콜(MCP) 서버는 AI 기반 개발 도구와 에이전트가 API 키나 인증 설정 없이 Google Health API에 대한 최신의 근거 있는 문서를 검색하고 가져올 수 있는 기능을 제공합니다.
MCP 서버는 컨텍스트 또는 데이터를 제공하는 외부 서비스와 AI 애플리케이션(호스트) 간의 프록시 역할을 합니다. Google Health Developer MCP 서버는 대규모 언어 모델(LLM)이 색인 생성된 문서에서 직접 정확한 답변을 찾을 수 있는 실행 가능한 도구를 노출합니다. MCP 서버에 대한 자세한 내용은 MCP란 무엇이며 어떻게 작동하나요?를 참고하세요.
서버는 다음 위치에서 표준 MCP 스트리밍 가능 HTTP 전송을 통해 작동합니다.
https://healthdevelopers.googleapis.com/mcp
사용 가능한 도구
서버는 기술 문서 검색 및 가져오기를 위한 두 가지 핵심 도구를 제공합니다.
search_health_docs: Google Health API 참고 리소스에서 질문과 일치하는 관련 기술 콘텐츠 청크를 검색합니다. 각 청크에는 페이지 제목, 소스 URL, 관련 텍스트 콘텐츠, 표준 문서 리소스 이름이 포함됩니다.get_health_docs:search_health_docs에서 반환한 리소스 이름을 사용하여 하나 이상의 문서 페이지의 전체 마크다운 콘텐츠를 가져옵니다.
전체 입력 및 출력 스키마는 Google Health Developer MCP 참조를 확인하세요. 모든 콘텐츠는 https://developers.google.com/health/에서 호스팅되는 공개 기술 문서로 엄격하게 범위가 지정됩니다.
기본 요건
서버에 연결하려면 다음과 같은 MCP 호환 AI 개발 환경 또는 코딩 지원이 필요합니다.
- Gemini CLI
- Google Antigravity(Antigravity CLI, Antigravity 2.0 또는 Antigravity IDE)
- OpenAI Codex
- Claude Code
- Cursor
- Grok CLI
- GitHub Copilot in VS Code
클라이언트 구성
원클릭 IDE 설치 프로그램, 단일 CLI 명령어, 편집기 구성 파일 또는 자동화된 채팅 프롬프트를 사용하여 즉시 연결하세요. Google Cloud 프로젝트나 API 키가 필요하지 않습니다.
클릭 한 번으로 IDE 설치
Google Antigravity, Cursor 또는 Visual Studio Code를 사용하는 경우 다음 버튼 중 하나를 선택하여 편집기를 열고 HealthDevelopers MCP 서버를 설치합니다.
Antigravity에 추가 Cursor에 추가 VS Code에 추가
명령줄 및 편집기 설정
다음 탭에서 AI 클라이언트를 선택하여 단일 명령어 또는 구성 항목으로 서버를 추가합니다.
Gemini CLI
gemini mcp add 명령어를 사용하여 서버를 Gemini CLI에 추가합니다.
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)을 열고 mcpServers 아래에 HealthDevelopers를 추가합니다. Antigravity CLI, Antigravity 2.0, Antigravity IDE는 모두 ~/.gemini/config/mcp_config.json를 공유합니다.
{
"mcpServers": {
"HealthDevelopers": {
"serverUrl": "https://healthdevelopers.googleapis.com/mcp"
}
}
}
Codex
codex mcp add 명령어를 사용하여 서버를 OpenAI Codex에 추가합니다.
codex mcp add HealthDevelopers \
--url https://healthdevelopers.googleapis.com/mcpClaude Code
claude mcp add 명령어를 사용하여 서버를 Claude Code에 추가합니다.
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 mcp add 명령어를 사용하여 서버를 Grok CLI에 추가합니다.
grok mcp add --transport http \
HealthDevelopers https://healthdevelopers.googleapis.com/mcpGitHub Copilot
원클릭 버튼 대신 수동 구성을 선호하는 경우 작업공간에서 .vscode/mcp.json를 수정하거나 VS Code 사용자 설정의 "mcp" 루트 키 아래에 구성을 추가합니다.
{
"servers": {
"HealthDevelopers": {
"type": "http",
"url": "https://healthdevelopers.googleapis.com/mcp"
}
}
}
프롬프트를 사용한 자동 설정
AI 어시스턴트가 채팅에서 직접 MCP 도구 구성을 관리하는 것을 지원하는 경우 다음 프롬프트를 붙여넣어 어시스턴트에게 서버를 구성하도록 지시합니다.
Please configure the Google Health Developer MCP server for me: - Name: HealthDevelopers - Server URL: https://healthdevelopers.googleapis.com/mcp - Transport: http
연결 확인
Gemini CLI 또는 Google Antigravity에서 HealthDevelopers가 연결되어 있는지 확인합니다.
Gemini CLI
터미널에서 gemini mcp list를 실행하거나 대화형 세션 내에서 /mcp를 입력합니다.
gemini mcp listHealthDevelopers에서 Connected를 보고하는지 확인합니다.
Configured MCP servers:
✓ HealthDevelopers: https://healthdevelopers.googleapis.com/mcp (http) - Connected
Google Antigravity
Antigravity CLI: 프롬프트 패널에
/mcp를 입력하여 MCP Manager를 열고HealthDevelopers에 활성 상태 링이 표시되는지 확인하거나 터미널에서agy mcp list를 실행합니다.NAME TYPE STATUS COMMAND/URL HealthDevelopers http enabled https://healthdevelopers.googleapis.com/mcpAntigravity IDE: 에이전트 측면 패널 상단에서 …을 클릭하고 MCP 서버 > MCP 서버 관리를 선택한 후
HealthDevelopers가 사용 설정되어 있는지 확인합니다.Antigravity 2.0: 설정 > 맞춤설정 > 설치된 MCP 서버를 열고
HealthDevelopers가 나열되어 있는지 확인합니다.
프롬프트 예시
연결되면 Google Health API에 관해 질문할 때 어시스턴트가 자동으로 search_health_docs 및 get_health_docs를 호출합니다.
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 스트리밍 가능 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
}
}
}'전체 문서 마크다운 가져오기
다음 명령어를 실행하여 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"
]
}
}
}'의견 및 지원
문제를 신고하거나, 개선사항을 제안하거나, Google Health Developer MCP 서버에 관한 도움을 받으려면 Google Health API 지원 페이지의 의견 및 지원 채널을 사용하세요.