Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

Google Home MCP 서버

사전 체험판

Google Home 모델 컨텍스트 프로토콜 (MCP) 서버를 사용하면 AI 기반 개발 도구와 가상 어시스턴트가 스마트 홈 환경과 직접 상호작용할 수 있습니다. 표준 MCP 도구와 RPC 인터페이스를 노출함으로써 서버는 대규모 언어 모델 (LLM)이 홈 구조를 검사하고, 기기 상태를 모니터링하고, 제어 작업을 실행하고, 이전 이벤트를 분석할 수 있도록 지원합니다.

경고!

실제 홈을 AI 에이전트에 연결하면 에이전트가 사용자를 대신하여 기기를 제어할 수 있습니다. 홈 MCP는 문 잠금 해제와 같은 민감한 작업을 금지하는 등 처리율 제한과 안전 보호를 적용합니다. 하지만 에이전트에 따라 Home MCP에 연결하면 예기치 않거나 원치 않는 동작이 발생할 수 있습니다. 개발자 정책 및 서비스 약관을 주의 깊게 검토합니다.

다른 가족 구성원이 사용하는 Google Home을 Home MCP에 연결하는 경우, 에이전트가 기기를 제어하고 홈 데이터에 액세스할 수 있음을 알려야 합니다. 또는 홈을 추가로 만들어 개발 및 테스트용 기기를 설정할 수 있습니다.

Google Home app (GHA) 또는 내 계정 페이지에서 언제든지 상담사의 Home MCP 액세스 권한을 취소할 수 있습니다.

개요

MCP 서버는 스마트 홈 인프라와 AI 애플리케이션 간의 프록시 역할을 합니다. 홈 MCP 서버는 AI 클라이언트가 실시간 홈 원격 분석을 쿼리하고 명령을 실행할 수 있는 실행 가능한 도구를 노출합니다.

주요 기능

Home MCP 서버는 다음과 같은 여러 핵심 기능 영역을 제공합니다.

구조 검색: list_homes를 사용하여 액세스 가능한 홈과 구조를 가져옵니다.
리소스 검색: list_home_resources를 사용하여 기기, 영역 레이아웃, 특성, 속성, 명령 스키마를 나열합니다.
상태 모니터링: list_home_states를 사용하여 실시간 기기 연결 상태와 트레이트 상태를 확인합니다.
기기 제어: run_home_actions를 사용하여 타겟 기기에서 매개변수화된 작업 명령어를 실행합니다.
이전 분석: list_home_history를 사용하여 특정 기간의 이전 상태 변경사항 및 이벤트 로그를 쿼리합니다.

기본 요건

홈 MCP 서버를 설정하기 전에 다음 사항을 확인하세요.

연결된 기기가 있는 Google Home의 활성 스마트 홈 설정
활성 Google Home Premium Advanced 구독
Google Cloud 프로젝트에 대한 액세스 권한
Google Antigravity, Claude Cowork, OpenClaw와 같은 MCP 호환 AI 클라이언트 또는 애플리케이션

MCP 서버 구성

MCP 서버를 설정하려면 Google Cloud 프로젝트를 만들고, 액세스 승인을 받고, Home API를 사용 설정하고, OAuth 사용자 인증 정보를 생성해야 합니다.

Google Cloud 프로젝트 만들기

아직 Google Cloud가 없으면 만들어야 합니다.

Google Cloud 콘솔을 엽니다.
새 Google Cloud 프로젝트를 만듭니다.

자세한 내용은 Google Cloud 문서의 프로젝트 만들기 도움말을 참고하세요.

Home API 사용 설정

Google Cloud 콘솔 탐색 메뉴에서 API 및 서비스 > 사용 설정된 API 및 서비스를 선택합니다.
Home API를 검색하고 사용 설정을 클릭합니다.

OAuth 동의 및 사용자 인증 정보 구성

OAuth 동의 화면을 구성합니다.
1. API 및 서비스 > OAuth 동의 화면을 엽니다.
2. 외부 잠재고객을 선택하고 시작하기를 클릭한 다음 필수 앱 정보와 연락처 이메일을 입력합니다.
OAuth 클라이언트 ID를 만듭니다.
1. API 및 서비스 > 사용자 인증 정보를 엽니다.
2. + 사용자 인증 정보 만들기를 클릭하고 OAuth 클라이언트 ID를 선택합니다.
3. 애플리케이션 유형을 웹 애플리케이션으로 설정합니다.
4. 타겟 AI 클라이언트에 해당하는 승인된 리디렉션 URI를 추가합니다.
  - Google Antigravity: https://antigravity.google/oauth-callback
  - Claude Cowork: https://claude.ai/api/mcp/auth_callback
  - OpenClaw: 로컬 OpenClaw 설치에 의해 지정된 리디렉션 URI
5. 만들기를 클릭하고 클라이언트 ID와 클라이언트 보안 비밀번호를 안전한 위치에 복사합니다.
애플리케이션을 게시합니다.
1. Google 인증 플랫폼 > 잠재고객을 엽니다.
2. 게시 상태에서 앱 게시를 클릭합니다.

AI 클라이언트 구성

OAuth 인증을 사용하여 홈 MCP 서버에 연결하도록 여러 AI 개발 환경을 구성할 수 있습니다. 여기에 OAuth 클라이언트 ID와 클라이언트 보안 비밀번호를 입력한 다음 원하는 설정 안내를 따르세요.

Enter your Client ID: YOUR_CLIENT_ID
Enter your Client Secret: YOUR_CLIENT_SECRET

프롬프트를 사용한 자동 설정

AI 어시스턴트가 채팅에서 직접 MCP 도구 구성을 관리하는 기능을 지원하는 경우 다음 프롬프트를 붙여넣어 어시스턴트에게 서버를 구성하도록 지시할 수 있습니다.

Please configure the Home MCP server for me with these settings:
- Name: home_mcp
- Server URL: https://preprod-home.sandbox.googleapis.com/mcp
- Transport: sse
- OAuth Scope: https://www.googleapis.com/auth/home.platform.v2
- Client ID: YOUR_CLIENT_ID
- Client Secret: YOUR_CLIENT_SECRET

수동 설정

수동 설정 안내를 보려면 원하는 AI 도구를 선택하세요.

Antigravity

Google Antigravity는 CLI, IDE, 데스크톱 환경 전반에서 MCP 서버를 위한 기본 제공 통합을 제공합니다.

애플리케이션 구성 메뉴를 엽니다(설정 > 고급 설정 > 맞춤설정 > MCP 구성 열기).

mcpServers 구성 객체 아래에 home_mcp 항목을 추가합니다.

{
  "mcpServers": {
    "home_mcp": {
      "serverUrl": "https://home.googleapis.com/mcp",
      "oauth": {
        "clientId": "YOUR_CLIENT_ID",
        "clientSecret": "YOUR_CLIENT_SECRET"
      }
    }
  }
}

인증 완료: 설정 > 고급 설정 > 맞춤설정 > home_mcp > 인증으로 이동합니다.
웹브라우저에서 Google Home 권한 부여 흐름을 완료하고 홈 구조를 선택한 다음 승인 코드를 Antigravity에 다시 복사합니다.

자세한 내용은 Google Antigravity 문서를 참고하세요.

Claude

커스텀 홈 MCP 서버에 연결하도록 Claude Cowork를 구성합니다.

Claude 커넥터를 엽니다.
+를 클릭하고 맞춤 커넥터 추가를 선택합니다.
서버 URL(https://home.googleapis.com/mcp)을 입력합니다.
고급 설정을 클릭하고 클라이언트 ID와 클라이언트 보안 비밀번호를 입력합니다.
추가를 클릭하고 브라우저에서 OAuth 승인 흐름을 완료합니다.
Cowork 채팅에서 왼쪽 하단의 +를 클릭하고 커넥터를 선택한 다음 home_mcp를 사용 설정합니다.

자세한 내용은 Claude 플랫폼 문서를 참고하세요.

OpenClaw

OAuth 인증으로 원격 SSE 전송에 연결하도록 OpenClaw를 구성합니다.

구성 패치 JSON 블록을 준비합니다.

{
  "mcp": {
    "servers": {
      "home_mcp": {
        "url": "https://home.googleapis.com/mcp",
        "transport": "sse",
        "auth": "oauth",
        "oauth": {
          "scope": "https://www.googleapis.com/auth/home.platform.v2",
          "redirectUrl": "[YOUR_OPENCLAW_REDIRECT_URL]"
        },
        "env": {
          "CLIENT_ID": "YOUR_CLIENT_ID",
          "CLIENT_SECRET": "YOUR_CLIENT_SECRET"
        }
      }
    }
  }
}

터미널에서 구성 패치를 적용합니다.
```
openclaw config patch --stdin
```
OpenClaw 게이트웨이를 다시 시작합니다.
```
openclaw gateway restart
```
인증 흐름을 시작합니다.
```
openclaw mcp login home_mcp
```
생성된 승인 URL을 따라 로그인하고 액세스 권한을 부여합니다.

자세한 내용은 OpenClaw 문서를 참고하세요.

아는 사람 동의

Home MCP에서 얼굴 데이터에 액세스하려면 사용자가 이 기능을 별도로 명시적으로 동의해야 합니다.

기본 요건

동의를 부여하는 사용자는 Google Home 구조의 관리자여야 합니다.
사용자의 구조에 호환되는 Google Nest 카메라 또는 초인종이 하나 이상 있어야 하며, 각 카메라 또는 초인종에 대해 아는 사람 인식이 사용 설정된 활성 Google Home Premium 구독이 있어야 합니다.
애플리케이션에 Google Cloud에서 생성된 OAuth 2.0 클라이언트 ID가 있어야 합니다. 아직 만들지 않았다면 AI 클라이언트 구성을 참고하여 OAuth 2.0 클라이언트를 만드세요.

동의 링크

애플리케이션에 액세스 권한을 부여하려면 OAuth 2.0 클라이언트 ID와 Home 구조 ID로 맞춤설정된 동의 링크를 방문해야 합니다. 동의 링크를 가져오는 방법에는 두 가지가 있습니다.

링크를 받은 후 링크를 방문하여 동의를 제공합니다.

상담사가 링크를 생성합니다.

에이전트가 이미 Home MCP에 연결되어 있으면 Home 구조 ID를 자동으로 찾아 클릭 가능한 링크를 생성할 수 있습니다.

이 페이지에서 다음 매개변수를 직접 업데이트한 다음 맞춤설정된 프롬프트를 에이전트의 채팅에 복사하여 붙여넣습니다.

CLIENT_ID - Google Cloud의 OAuth 2.0 클라이언트 ID입니다. 예를 들어 `123456789-xyz.apps.googleusercontent.com`입니다.
STRUCTURE_NAME - 대상 Home 구조의 이름입니다.

Please query my Home MCP to find the
Structure ID for my home named STRUCTURE_NAME. Once found, display
the structure name and ID, generate my clickable Familiar Faces Consent Link by
replacing <STRUCTURE_ID> in this URL with the structure ID you found:
https://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=<STRUCTURE_ID>&features=1&continue=https%3A%2F%2Fhome.google.com

링크를 만듭니다.

에이전트가 이미 Home MCP에 연결되어 있으면 Home 구조 ID를 자동으로 찾아 클릭 가능한 링크를 생성할 수 있습니다.

이 페이지에서 다음 매개변수를 직접 업데이트한 다음 웹브라우저에서 맞춤설정된 링크를 엽니다.

CLIENT_ID - Google Cloud의 OAuth 2.0 클라이언트 ID입니다. 예를 들어 `123456789-xyz.apps.googleusercontent.com`입니다.
STRUCTURE_ID - 타겟 Home 구조의 UUID입니다. 이 정보를 얻는 가장 쉬운 방법은 Home MCP를 사용하여 에이전트에게 '[구조 이름]의 구조 ID (UUID)를 알려 줘'라고 요청하는 것입니다.

https://home.google.com/connections/feature_consent?client_id=CLIENT_ID&structure_id=STRUCTURE_ID&features=1&continue=https%3A%2F%2Fhome.google.com

연결 및 기능 확인

클라이언트가 구성되고 인증되면 서버 연결을 확인합니다.

AI 어시스턴트 또는 워크스페이스 세션을 실행합니다.
활성 MCP 서버 연결을 확인합니다 (Antigravity에서 /mcp를 실행하거나 도구 목록을 검사).
home_mcp이 활성 도구와 함께 나열되는지 확인합니다.
어시스턴트에게 샘플 프롬프트를 입력하여 다양한 기능을 테스트합니다.
- 항목 검색: How many lights do I have in my house?
- 실시간 상태 모니터링: Is my home secured?
- 기기 제어: Turn off all the outside lights.
- 이전 이벤트 분석: What happened while I was out?
클라이언트에서 메시지가 표시되면 도구 실행 권한을 부여합니다. AI 어시스턴트는 실시간 상태 데이터를 가져올 수 있으며 모든 대답은 홈 원격 분석에 기반합니다.

지원

Home MCP 개발 지원이 필요한 경우 개발자를 위한 스마트 홈 도움말 커뮤니티로 이동하세요. 이곳에서 질문을 게시하여 도움을 받거나 이전에 게시된 질문을 살펴보고 질문에 대한 답변이 이미 있는지 확인할 수 있습니다.

MCP 버그 또는 기능 요청을 제출하려면 공개 Issue Tracker로 이동하세요.

알려진 문제

특성 테스트: 에이전트에 가장 광범위한 기능을 제공하기 위해 실험용으로 표시된 일부 특성이 포함되어 있습니다. 이러한 실험용 특성이 예상대로 작동하지 않는 시나리오가 발생할 수 있습니다. 이 경우 공개 Issue Tracker를 사용하여 신고해 주세요.
지연 시간 - Home MCP의 지연 시간이 예상보다 길어질 수 있습니다. Google에서는 최적화를 위해 적극적으로 노력하고 있습니다. 향후 출시에서 지연 시간 개선이 이루어질 것으로 예상됩니다.

출시 예정

자동화: 현재 Home MCP를 사용한 자동화 생성 및 관리는 지원되지 않습니다. Google에서는 이 기능을 개발하고 있으며 향후 출시에서 자동화 지원을 제공할 계획입니다.

Google Home MCP 서버 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

warning 경고!

개요

주요 기능

기본 요건

MCP 서버 구성

Google Cloud 프로젝트 만들기

Home API 사용 설정

OAuth 동의 및 사용자 인증 정보 구성

AI 클라이언트 구성

프롬프트를 사용한 자동 설정

수동 설정

Antigravity

Claude

OpenClaw

아는 사람 동의

기본 요건

동의 링크

상담사가 링크를 생성합니다.

링크를 만듭니다.

연결 및 기능 확인

지원

알려진 문제

출시 예정

Google Home MCP 서버

경고!