Google Home 개발자 MCP 서버

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

• Google Home Developer Center 공개 문서
• OpenThread
• Matter 사양: 버전 1.5.1에서 사용 가능
• 스레드 사양: 버전 1.4.1에서 사용 가능

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

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

기본 요건

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

Google Antigravity

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

• Antigravity CLI 시작하기 가이드에 따라 Antigravity CLI
• Google Antigravity 문서에 따라 Antigravity 2.0
• Antigravity IDE 시작하기 가이드에 따라 Antigravity IDE

서드 파티 AI 어시스턴트

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

• Claude Code
• 커서
• VS Code의 GitHub Copilot

인증 경로 선택

통합 요구사항에 따라 인증되지 않은 체험 경로 또는 인증된 API 키를 사용하여 Home Developer 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. 키가 생성되면 키 표시를 클릭하여 키를 확인하고 다음 단계를 위해 복사합니다.

클라이언트 구성

다음 필드에 사용자 인증 정보를 입력하여 원하는 AI 개발 환경의 구성 템플릿을 채웁니다.

Enter your API key: YOUR_API_KEY

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

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

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

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

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

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

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

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

설치 및 실행 확인

도구 구성이 업데이트되면 에이전트 워크스페이스를 프롬프트하여 연결을 확인합니다.

Antigravity CLI의 확인 예

1. 대화형 워크스페이스 세션을 실행합니다.

   agy
   

   

2. 탐색 체크리스트 명령어를 실행하여 활성 MCP 서버를 검사합니다.

   /mcp
   

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

   

4. Google Home 개발 관련 질문을 합니다. 예를 들면 다음과 같습니다.

   How do I create an Automation using Home APIs?
   

5. Antigravity에서 Home Developer MCP 서버의 search_documents 도구를 호출할 권한을 요청하면 허용 옵션 중 하나를 선택하여 계속합니다.

   

6. 도구를 호출하면 Antigravity가 문서에서 그라운딩된 답변으로 질문에 답합니다.

   

동영상 튜토리얼

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

직접 HTTP curl 요청으로 테스트

AI 클라이언트 환경 외부에서 파이프라인을 테스트하는 경우 curl를 사용하여 표준 JSON-RPC 2.0 페이로드를 https://homedevelopers.googleapis.com/mcp에 직접 전송할 수 있습니다.

활성 시스템 도구 확인

tools/list 메서드를 사용하여 서버에서 노출된 도구를 검사합니다.

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

기능 검색어 실행

API 키 또는 인증되지 않은 요청을 사용하여 search_documents를 테스트할 탭을 선택합니다.

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?"
          }
      }
  }'

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

의견 보내기

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

의견 보내기