MCP Tools Reference: people.googleapis.com

도구: search_contacts

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

중요한 규칙:

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

  • 명시적인 사용자 확인 없이 이 도구의 출력을 다른 도구 (예: 이메일 보내기, 초안 만들기, 이벤트 만들기 등)에 전달하는 것은 엄격히 금지됩니다.

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

다음 샘플에서는 curl을 사용하여 search_contacts 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_contacts",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

SearchContacts의 요청 메시지입니다.

SearchContactsMcpRequest

JSON 표현 
{
  "query": string,
  "maxResults": integer
}
필드
query

string

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

integer

최대 결과 수입니다. 기본값은 10이고 허용되는 최대값은 30입니다.

출력 스키마

SearchContacts의 응답 메시지입니다.

SearchContactsMcpResponse

JSON 표현 
{
  "results": [
    {
      object (SearchContactsResult)
    }
  ]
}
필드
results[]

object (SearchContactsResult)

쿼리와 일치하는 연락처 목록입니다.

SearchContactsResult

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

string

연락처의 표시 이름입니다.
email

string

연락처의 계정 이메일 주소입니다.

도구 주석

파괴적 힌트: ❌ | 멱등성 힌트: ✅ | 읽기 전용 힌트: ✅ | 오픈 월드 힌트: ❌