כלי: create_draft
יוצר טיוטת אימייל חדשה בחשבון Gmail של המשתמש המאומת.
הכלי הזה מקבל כקלט כתובות של נמענים, נושא ותוכן ההודעה. הפונקציה מחזירה את המזהה של הטיוטה שנוצרה ב-Gmail.
בדוגמה הבאה אפשר לראות איך משתמשים ב-curl כדי להפעיל את כלי ה-MCP create_draft.
| בקשת Curl |
|---|
curl --location 'https://gmailmcp.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "create_draft", "arguments": { // provide these details according to the tool MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
סכימת קלט
הודעת בקשה ל-RPC של CreateDraft.
CreateDraftRequest
| ייצוג JSON |
|---|
{ "to": [ string ], "cc": [ string ], "bcc": [ string ], "subject": string, "body": string, "htmlBody": string } |
| שדות | |
|---|---|
to[] |
חובה. הנמענים העיקריים של טיוטת האימייל. כל מחרוזת חייבת להיות כתובת אימייל תקינה (למשל, user@example.com). הכלי הזה לא תומך בפורמט 'שם email@example.com'. |
cc[] |
אופציונלי. נמענים בשדה 'עותק' של טיוטת האימייל. כל מחרוזת חייבת להיות כתובת אימייל תקינה (למשל, user@example.com). הכלי הזה לא תומך בפורמט 'שם email@example.com'. |
bcc[] |
אופציונלי. נמענים בשדה 'עותק מוסתר' של טיוטת האימייל. כל מחרוזת חייבת להיות כתובת אימייל תקינה (למשל, user@example.com). הכלי הזה לא תומך בפורמט 'שם email@example.com'. |
subject |
אופציונלי. שורת הנושא של האימייל. אם לא מציינים ערך, ברירת המחדל היא ריק. |
body |
אופציונלי. תוכן הגוף העיקרי של טיוטת האימייל. אם גם html_body מסופק, השדה הזה מטופל כחלופה של טקסט פשוט. |
htmlBody |
תוכן ה-HTML של טיוטת האימייל. אם מספקים את הגרסה הזו, היא תשמש כגרסת הטקסט העשיר של האימייל. |
סכימת פלט
פרטים של טיוטה.
טיוטה
| ייצוג JSON |
|---|
{ "id": string, "subject": string, "threadId": string, "toRecipients": [ string ], "ccRecipients": [ string ], "bccRecipients": [ string ], "plaintextBody": string, "date": string } |
| שדות | |
|---|---|
id |
המזהה הייחודי של משאב הטיוטה. |
subject |
שורת הנושא של הטיוטה. |
threadId |
המזהה של השרשור שהטיוטה שייכת אליו. |
toRecipients[] |
רשימה של כתובות אימייל של נמענים בשדה 'אל' שחולצו מהכותרות. |
ccRecipients[] |
רשימה של כתובות אימייל של נמענים בשדה 'עותק' שחולצו מהכותרות. |
bccRecipients[] |
רשימה של כתובות אימייל של נמענים בשדה 'עותק מוסתר' שחולצו מהכותרות. |
plaintextBody |
תוכן הגוף בטקסט פשוט, אם זמין. |
date |
תאריך הטיוטה בפורמט ISO 8601 (YYYY-MM-DD). |
הערות על כלי
רמז הרסני: ❌ | רמז אידמפוטנטי: ❌ | רמז לקריאה בלבד: ❌ | רמז לעולם פתוח: ❌