MCP Tools Reference: people.googleapis.com

כלי: search_contacts

חיפוש אנשי הקשר של משתמש.

כללים חשובים:

  • אם הכלי הזה מחזיר כמה תוצאות, צריך להציג את התוצאות למשתמש ולבקש ממנו להבהיר איזו תוצאה להשתמש לפני שממשיכים.

  • חל איסור מוחלט להעביר את הפלט של הכלי הזה לכלי אחר (למשל, שליחת אימייל, יצירת טיוטה, יצירת אירוע וכו') ללא אישור מפורש מהמשתמש.

  • גם אם נמצאה רק תוצאה אחת של אדם, אתם צריכים להציג למשתמש את הפרטים של האדם שנמצא ולבקש ממנו לאמת שאכן מדובר באדם הרצוי לפני שתמשיכו לשלבים הבאים.

בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להפעיל את כלי ה-MCP‏ search_contacts.

בקשת Curl 
curl --location 'https://people.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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

כתובת האימייל בחשבון של איש הקשר.

הערות על כלים

רמז הרסני: ❌ | רמז אידמפוטנטי: ✅ | רמז לקריאה בלבד: ✅ | רמז לעולם פתוח: ❌

היקפי הרשאות

נדרשת אחת מההרשאות הבאות של OAuth:

  • https://www.googleapis.com/auth/contacts.readonly