MCP Tools Reference: people.googleapis.com

도구: search_directory_people

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

따라야 하는 중요 규칙:

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

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

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

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

다음 샘플은 curl를 사용하여 search_directory_people 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/call",
  "params": {
    "name": "search_directory_people",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

SearchDirectoryPeople 요청 메시지입니다.

SearchDirectoryPeopleMcpRequest

JSON 표현 
{
  "query": string,
  "pageSize": integer,
  "pageToken": string,
  "sources": [
    enum (DirectorySourceType)
  ]
}
필드
query

string

검색할 쿼리 문자열입니다.
pageSize

integer

페이지 크기. 기본값은 10이고 허용되는 최댓값은 500입니다.
pageToken

string

페이지 토큰입니다.
sources[]

enum (DirectorySourceType)

반환할 디렉터리 소스입니다. 설정하지 않으면 기본값은 DOMAIN_PROFILE입니다.

출력 스키마

SearchDirectoryPeople의 응답 메시지입니다.

SearchDirectoryPeopleMcpResponse

JSON 표현 
{
  "results": [
    {
      object (SearchDirectoryResult)
    }
  ],
  "nextPageToken": string
}
필드
results[]

object (SearchDirectoryResult)

쿼리와 일치하는 사용자 목록입니다.
nextPageToken

string

결과의 다음 페이지를 검색하는 토큰입니다.

SearchDirectoryResult

JSON 표현 
{
  "name": string,
  "email": string
}
필드
name

string

사용자의 표시 이름입니다.
email

string

사용자의 계정 이메일 주소입니다.

도구 주석

파괴적 힌트: ❌ | 동일한 힌트: ✅ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌