Google Home 개발자 MCP 서버

Google Home 개발자 모델 컨텍스트 프로토콜 (MCP) 서버를 사용하면 AI 기반 개발 도구가 다음을 검색하고 도메인별 실시간 정보를 가져올 수 있습니다.

• Google Home 개발자 센터
• OpenThread
• Matter 사양: 버전 1.5.1에서 사용 가능

이를 통해 AI 에이전트 및 도구가 Google Home 개발자 프로그램 및 기술과 관련된 정확한 기술 답변을 제공할 수 있습니다.

MCP 서버는 컨텍스트 또는 데이터를 제공하는 외부 서비스와 AI 애플리케이션 (호스트) 간의 프록시 역할을 합니다. Home 개발자 MCP 서버는 대규모 언어 모델 (LLM)이 색인된 코퍼스에서 직접 정확한 답변을 찾을 수 있도록 하는 실행 가능한 도구를 노출합니다. MCP 서버에 대한 자세한 내용은 MCP란 무엇이며 어떻게 작동하나요?를 참고하세요.

기본 요건

Home 개발자 MCP 서버를 사용하려면 MCP 호환 AI 클라이언트 또는 편집기가 설치되어 있어야 합니다.

Google Antigravity

Google의 AI 개발 환경을 사용하는 경우 다음 중 하나를 설치합니다.

• Antigravity CLI: Antigravity CLI 시작하기 가이드 참고
• Antigravity 2.0: Google Antigravity 문서 참고
• Antigravity IDE: Antigravity IDE 시작하기 가이드 참고

서드 파티 AI 어시스턴트

다음과 같은 다른 AI 애플리케이션, 명령줄 도구, 코드 편집기와 MCP를 통합할 수도 있습니다.

• Claude Code
• 커서
• GitHub Copilot (VS Code)

인증 경로 선택

통합 요구사항에 따라 인증되지 않은 평가판 경로 또는 인증된 API 키를 사용하여 Home 개발자 MCP 서버에 연결할 수 있습니다.

인증되지 않은 연결 테스트

이 방법에는 API 키 또는 Google Cloud 구성이 필요하지 않습니다. 공유 공개 할당량을 사용하므로 서버를 평가판으로 사용하고 핵심 메커니즘을 즉시 테스트하는 가장 쉬운 방법입니다.

프로덕션을 위한 인증된 연결

공유 공개 할당량에서 비율 제한을 방지하려면 지속적인 개발을 위해 환경을 인증하는 것이 좋습니다.

이 경로를 사용하려면 활성 Google Cloud 프로젝트가 있어야 합니다.

1. Google Cloud 콘솔에서 프로젝트의 API를 사용 설정합니다.
   1. Google API 라이브러리에서 Home Developers API 페이지를 엽니다.
   2. API를 사용하려는 올바른 프로젝트가 선택되어 있는지 확인합니다.
   3. 사용 설정 을 클릭합니다.

2. API 키를 만듭니다.

   1. 사용자 인증 정보 페이지로 이동합니다.
   2. 사용자 인증 정보 만들기 를 클릭한 후 메뉴에서 API 키를 선택합니다.
   3. 이름 필드에 키 이름을 입력합니다.

   4. API 제한사항 선택 드롭다운을 클릭한 후 Home Developers API 를 입력합니다. 결과를 클릭한 후 확인 을 클릭합니다.

   5. 만들기 를 클릭합니다.

   6. 키가 생성되면 키 표시 를 클릭하여 키를 확인하고 다음 단계를 위해 키를 복사합니다.

클라이언트 구성

인증되지 않은 구성 또는 인증 구성을 사용하여 Home 개발자 MCP 서버에 연결할 수 있는 여러 개발 환경이 있습니다. 각 환경의 안내에 따라 서버를 설정하세요.

Enter your API key: YOUR_API_KEY

{
  "mcpServers": {
    "HomeDevelopers": {
      "serverUrl": "https://homedevelopers.googleapis.com/mcp"
    }
  }
}

{
 "mcpServers": {
    "HomeDevelopers": {
      "serverUrl": "https://homedevelopers.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

claude mcp add HomeDevelopers --transport http https://homedevelopers.googleapis.com/mcp

claude mcp add HomeDevelopers --transport http https://homedevelopers.googleapis.com/mcp --header "X-Goog-Api-Key: "YOUR_API_KEY"

{
  "mcpServers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

{
  "servers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp"
    }
  }
}

{
  "servers": {
    "HomeDevelopers": {
      "url": "https://homedevelopers.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

설치 및 실행 확인

도구 구성이 업데이트되면 에이전트 작업공간에 프롬프트를 표시하여 연결을 확인합니다.

확인 예 (Antigravity CLI)

1. 대화형 작업공간 세션을 시작합니다.

   agy
   

   

2. 검색 체크리스트 매크로를 실행하여 활성 MCP 서버를 검사합니다.

   /mcp
   

3. HomeDevelopers (또는 선택한 서버 이름 키)가 활성 연결 목록에 표시되는지 확인합니다.

   

4. 다음과 같이 Google Home에 질문합니다.

   How do I create an Automation using Home APIs?
   

5. Antigravity는 Google Home 개발자 문서를 읽는 것이 도움이 된다고 판단되면 Home 개발자 MCP 서버의 search_documents 도구를 사용할 수 있는 권한을 요청합니다. 허용 옵션 중 하나를 선택하여 계속합니다.

   

6. 도구를 호출하고 생각한 후 Antigravity는 그라운딩된 응답으로 쿼리에 답변합니다.

   

동영상 튜토리얼

Home 개발자 MCP 설치에 대한 단계별 안내는 동영상을 시청하세요.

직접 HTTP API 테스트 프로토콜 (cURL)

클라이언트 래퍼 환경 외부에서 파이프라인을 테스트하는 경우 표준 JSON-RPC 페이로드를 curl 채널을 통해 전송할 수 있습니다.

활성 시스템 도구 검색

curl --location "https://homedevelopers.googleapis.com/mcp" \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "id": 1
}'

기능 검색 쿼리 실행

curl --location "https://homedevelopers.googleapis.com/mcp" \
--header 'Content-Type: application/json' \
--data '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "id": 2,
    "params": {
        "name": "search_documents",
        "arguments": {
            "query": "How to create an automation?"
        }
    }
}'

curl --location "https://homedevelopers.googleapis.com/mcp" \
--header 'Content-Type: application/json' \
--header 'Accept: application/json, text/event-stream' \
--header "X-Goog-Api-Key: "YOUR_API_KEY" \
--data '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "id": 2,
    "params": {
        "name": "search_documents",
        "arguments": {
            "query": "How to create an automation?"
        }
    }
}'

의견 보내기

의견 양식을 사용하여 Home 개발자 MCP 또는 도구 사용 경험을 개선할 수 있는 방법에 관한 의견과 제안을 제출하세요.

의견 보내기