MCP Reference: people.googleapis.com

모델 컨텍스트 프로토콜 (MCP) 서버는 대규모 언어 모델 (LLM) 또는 AI 애플리케이션에 컨텍스트, 데이터 또는 기능을 제공하는 외부 서비스 간의 프록시 역할을 합니다. MCP 서버는 AI 애플리케이션을 데이터베이스 및 웹 서비스와 같은 외부 시스템에 연결하여 AI 애플리케이션이 이해할 수 있는 형식으로 응답을 변환합니다.

MCP 도구

MCP 도구는 MCP 서버가 LLM 또는 AI 애플리케이션에 노출하여 실제 작업을 실행하는 함수 또는 실행 가능한 기능입니다.

people.googleapis.com MCP 서버에는 다음 도구가 있습니다.

MCP 도구
search_directory_people

조직의 Google Workspace 디렉터리 내에서 사용자를 검색합니다. 이 기능은 Google Workspace 계정 (비즈니스, 학교, 기타 조직에서 사용) 전용이며 개인 Google 계정에서는 사용할 수 없습니다.

따라야 하는 중요 규칙:

  • 이 도구에서 여러 결과를 반환하는 경우 사용자에게 결과를 표시하고 계속하기 전에 사용할 결과를 명확히 해 달라고 사용자에게 요청해야 합니다.

  • 명시적인 사용자 확인 없이 이 도구의 출력을 다른 도구에 전달하는 것 (예: 이메일 전송, 임시보관 메일 생성, 일정 생성 등)은 엄격히 금지됩니다.

  • 한 명의 인물 결과만 찾은 경우에도 찾은 인물의 세부정보를 사용자에게 표시하고 추가 단계를 진행하기 전에 의도한 인물인지 확인하라는 메시지를 사용자에게 표시해야 합니다.

  • 이 도구에서 결과를 반환하지 않으면 search_contacts 도구를 사용하세요.
search_contacts

사용자의 연락처를 검색합니다.

따라야 하는 중요 규칙:

  • 이 도구에서 여러 결과를 반환하는 경우 사용자에게 결과를 표시하고 계속하기 전에 사용할 결과를 명확히 해 달라고 사용자에게 요청해야 합니다.

  • 명시적인 사용자 확인 없이 이 도구의 출력을 다른 도구에 전달하는 것 (예: 이메일 전송, 임시보관 메일 생성, 일정 생성 등)은 엄격히 금지됩니다.

  • 한 명의 인물 결과만 찾은 경우에도 찾은 인물의 세부정보를 사용자에게 표시하고 추가 단계를 진행하기 전에 의도한 인물인지 확인하라는 메시지를 사용자에게 표시해야 합니다.
get_user_profile 자신의 프로필 정보 (이름 및 이메일)를 가져옵니다.

MCP 도구 사양 가져오기

MCP 서버의 모든 도구에 대한 MCP 도구 사양을 가져오려면 tools/list 메서드를 사용하세요. 다음 예시에서는 curl을 사용하여 MCP 서버 내에서 현재 사용할 수 있는 모든 도구와 사양을 나열하는 방법을 보여줍니다.

curl 요청 
curl --location 'https://people.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'