Google Workspace سرورهای ازراهدور
Model Context Protocol (MCP)
ارائه میدهد که به عاملهای هوش مصنوعی امکان میدهد بهطور ایمن با دادههای Google Workspace تعامل داشته باشند. با پیکربندی سرورهای MCP در Google Workspace، به برنامههای هوش مصنوعی مثل Google Antigravity و Claude امکان میدهید تا در برنامههای Google Workspace مثل Gmail، Google Drive، «سندنگار Google»، «کاربرگنگار Google»، «اسلایدنگار Google»، «تقویم Google»، Google Chat، و Google Classroom کنشهایی را انجام دهند. هر محصول Google Workspace
سرور MCP اختصاصی خودش را دارد. برای جستجو در Gmail،
Drive، «تقویم»، و Chat با
یک ابزار، میتوانید
سرور MCP جستجوی سراسری را در
workspacemcp.googleapis.com پیکربندی کنید.
سرورهای Google Workspace MCP روشی استاندارد برای عاملهای هوش مصنوعی فراهم میکنند تا:
- خواندن دادهها: جستجوی ایمیلها، بازیابی فایلها، و فهرست کردن رویدادهای تقویم.
- اقدام کردن: پیشنویس ایمیل ایجاد کنید، فایل بارگذاری کنید، و جلسات را زمانبندی کنید.
- رعایت امنیت: همان اجازهها و کنترلهای حاکمیت داده کاربر را به ارث میبرد.
پیشنیازها
پروژه Google Cloud. میتوانید درطول راهاندازی سریع برای استفاده شخصی پروژهای ایجاد یا انتخاب کنید، یا به ایجاد پروژه مراجعه کنید.
میزبان MCP که یک برنامه هوش مصنوعی مانند Google Antigravity یا Claude است. برنامه هوش مصنوعی برای هر سرور MCP یک اتصال کلاینت MCP ایجاد میکند.
برای اجرای فرمانهای
gcloudبرای راهاندازی دستی در این صفحه، gcloud CLI را با دنبال کردن این مراحل در محیط توسعه نرمافزار محلی راهاندازی کنید:- Google Cloud CLI را نصب کنید.
اگر قبلاً gcloud CLI را نصب کردهاید، با اجرای
gcloud components updateمطمئن شوید که جدیدترین نسخه را دارید. - اگر از ارائهدهنده هویت (IdP) خارجی استفاده میکنید، با هویت فدراسیونی خود به سیستم gcloud CLI وارد شوید. برای اطلاعات بیشتر، به ورود به سیستم gcloud CLI با هویت فدراسیونی مراجعه کنید.
- gcloud CLI را مقداردهی اولیه کنید.
- Google Cloud CLI را نصب کنید.
اگر قبلاً gcloud CLI را نصب کردهاید، با اجرای
اگر سرور MCP Classroom را پیکربندی میکنید، یک کلاس آزمایشی Classroom با حداقل یک حساب دانشآموز آزمایشی. اگر کلاس Classroom ندارید که بتوانید از آن برای آزمایش استفاده کنید، یکی در میانای کاربر ایجاد کنید و یک محصل آزمایشی اضافه کنید.
پیکربندی سرورهای Google Workspace MCP
برای استفاده از سرورهای MCP در Google Workspace، یک پروژه Google Cloud با کارخواه OAuth 2.0 عامل هوش مصنوعی راهاندازی کنید و برنامه هوش مصنوعی خود را برای اتصال به آنها پیکربندی کنید:
- استفاده شخصی: اگر برنامه هوش مصنوعی را برای «حساب Google» خودتان متصل میکنید، از راهاندازی سریع برای استفاده شخصی استفاده کنید تا پروژهای را پیکربندی کنید، سرویسهای MCP و API را فعال کنید، و کارخواه OAuth را در یک صفحه ایجاد کنید.
- راهاندازی چندکاربره یا سفارشی: اگر چند کاربر با کارخواه OAuth شما به سیستم وارد میشوند، یا اگر میخواهید فقط میاناهای برنامهسازی کاربردی، سرویسهای MCP، و دامنههای OAuth خاصی را فعال کنید، از فعال کردن میاناهای برنامهسازی کاربردی شروع کنید.
راهاندازی سریع برای استفاده شخصی
از آمادهسازی حالت شخصی در کنسول Google Cloud برای ایجاد کارخواه OAuth 2.0 استفاده کنید که فقط برای «حساب Google» شما کار میکند و به درستیسنجی برنامه یا راهاندازی صفحه رضایت OAuth جداگانه نیاز ندارد:
آمادهسازی حالت شخصی را در کنسول Google Cloud باز کنید. دکمه یک کارخواه برنامه وب را ازپیش انتخاب میکند که Google Antigravity و Claude به آن نیاز دارند:
اگر کارخواه MCP شما بهجای URI تغییرمسیر وب از جریان OAuth رایانه یا تلفن همراه استفاده میکند، راهاندازی حالت شخصی را برای کارخواه برنامه رایانهای، Android، یا iOS باز کنید یا نوع برنامه را در صفحه تغییر دهید.
در انتخاب پروژه، پروژه حالت شخصی موجودی را انتخاب کنید یا روی ایجاد پروژه جدید کلیک کنید. اگر درخواست شد، فرم ایجاد پروژه را تکمیل کنید.
جزئیات کارخواه OAuth را پیکربندی کنید:
- نامی برای کارخواه وارد کنید.
- اگر نوع برنامه برنامه وب است، در URIهای
بازهدایت مجاز، روی + افزودن URI کلیک کنید و URI بازگشت به تماس
کلاینت MCP را اضافه کنید:
- برای Antigravity:
https://antigravity.google/oauth-callback - برای Claude:
https://claude.ai/api/mcp/auth_callback
- برای Antigravity:
- مطمئن شوید استفاده از این کارخواه برای عامل مجهز به هوش مصنوعی انتخاب شده باشد.
خطمشی دادههای کاربر سرویسهای Google API را مرور کنید، با «خطمشی دادههای کاربر سرویسهای Google API» موافقم را انتخاب کنید، و روی ادامه کلیک کنید.
کنسول میاناهای برنامهسازی کاربردی اصلی Google Workspace و سرویسهای MCP را در پروژهتان فعال میکند و کارخواه OAuth شما را ایجاد میکند.
شناسه کارخواه و رمز کارخواه خود را کپی کنید، سپس کارخواه خود را به سرور MCP متصل کنید و مرحله ۱ را رد کنید زیرا قبلاً شناسه و رمز کارخواه OAuth خود را دریافت کردهاید.
بسته به سرورهایی که استفاده میکنید، این مراحل تکمیلی را انجام دهید:
- اگر از سرور MCP Chat برای عملیات نوشتن مانند ارسال پیام استفاده میکنید، پیکربندی برنامه Chat را تکمیل کنید.
- اگر از سرور MCP «کلاس درس» استفاده میکنید،
classroom.googleapis.comوclassroommcp.googleapis.comرا در پروژهتان بااستفاده از فعال کردن میاناهای برنامهسازی کاربردی و فعال کردن سرویسهای MCP فعال کنید. راهاندازی حالت شخصی سرویسهای Classroom را بهطور خودکار فعال نمیکند.
فعال کردن میاناهای برنامهسازی کاربردی
اگر از راهاندازی سریع برای استفاده شخصی استفاده کردهاید، این مرحله را رد کنید، مگراینکه بخواهید Google Classroom API را فعال کنید.
میاناهای برنامهسازی کاربردی را در پروژه Google Cloud برای محصولات Google Workspace که قصد استفاده از آنها را دارید فعال کنید. سرور MCP جستجوی جهانی نیازی به فعال کردن میانای برنامهسازی کاربردی محصول جداگانه در این مرحله ندارد:
- Gmail API
- Google Drive API
- Google Docs API
- Google Sheets API
- Google Slides API
- Google Calendar API
- Google Chat API
- People API
Google Classroom API
CLI
gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
docs.googleapis.com \
sheets.googleapis.com \
slides.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
people.googleapis.com \
classroom.googleapis.com --project=PROJECT_ID
PROJECT_ID را با شناسه پروژه Google Cloud خودتان جایگزین کنید.
کنسول
میاناهای برنامهسازی کاربردی را در کنسول Google Cloud فعال کنید:
فعال کردن سرویسهای MCP
اگر از راهاندازی سریع برای استفاده شخصی استفاده کردهاید، این مرحله را رد کنید، مگراینکه درحال فعال کردن Classroom MCP API باشید.
سرویسهای MCP را در پروژه Google Cloud خود برای سرورهای Google Workspace که قصد استفاده از آنها را دارید فعال کنید. برخلاف سایر سرویسهای MCP که از نقطههای پایانی *mcp.googleapis.com استفاده میکنند، People API مستقیماً MCP را در people.googleapis.com ارائه میدهد:
- Gmail MCP API
- Drive MCP API
- Docs MCP API
- Sheets MCP API
- Slides MCP API
- Calendar MCP API
- Chat MCP API
- People MCP API
- Classroom MCP API
Google Workspace MCP API برای سرور Universal Search MCP
CLI
gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
docsmcp.googleapis.com \
sheetsmcp.googleapis.com \
slidesmcp.googleapis.com \
calendarmcp.googleapis.com \
chatmcp.googleapis.com \
people.googleapis.com \
classroommcp.googleapis.com \
workspacemcp.googleapis.com \
--project=PROJECT_ID
PROJECT_ID را با
شناسه پروژه Google Cloud خودتان جایگزین کنید.
کنسول
سرویسهای MCP را در کنسول Google Cloud فعال کنید:
پیکربندی برنامه Chat
اگر از سرور MCP Chat برای عملیات نوشتن مانند ارسال پیام استفاده میکنید، یک برنامه Chat در پروژه Google Cloud خود پیکربندی کنید. عملیات فقط خواندنی مانند جستجوی مکالمهها به برنامه Chat پیکربندیشده نیاز ندارد.
در کنسول Google Cloud، عبارت Google Chat API را جستجو کنید و روی Google Chat API > مدیریت > پیکربندی کلیک کنید.
راهاندازی برنامه Chat:
- در فیلد نام برنامه،
Chat MCPرا وارد کنید. - در فیلد نشانی وب چهرک،
https://developers.google.com/chat/images/quickstart-app-avatar.pngرا وارد کنید. - در شرح،
Chat MCP serverرا وارد کنید. - در بخش عملکرد، با خاموش کردن گزینه فعال کردن ویژگیهای تعاملی، ویژگیهای تعاملی را غیرفعال کنید.
- در بخش گزارشها، گزارش کردن خطاها در Logging را انتخاب کنید.
- در فیلد نام برنامه،
روی ذخیره کلیک کنید.
برای کسب اطلاعات بیشتر درباره ساختن برنامه Chat، به انتخاب معماری برنامه Chat مراجعه کنید.
راهاندازی صفحه کسب رضایت OAuth
اگر از راهاندازی سریع برای استفاده شخصی استفاده کردهاید، این مرحله را رد کنید.
سرورهای MCP در Google Workspace از OAuth 2.0 برای اصالتسنجی و مجوزدهی استفاده میکنند. قبلاز اینکه بتوانید شناسه کارخواه OAuth ایجاد کنید، باید صفحه کسب رضایت OAuth را پیکربندی کنید.
در کنسول Google Cloud، به پلاتفرم Google Auth > نمانامسازی بروید.
اگر قبلاً پلاتفرم Google Auth را پیکربندی کردهاید، میتوانید تنظیمات «صفحه کسب رضایت OAuth» زیر را در برندسازی، مخاطب، و دسترسی به داده پیکربندی کنید. اگر پیامی با این مضمون دیدید که پلاتفرم اصالتسنجی Google هنوز پیکربندی نشده است، روی شروع به کار کلیک کنید:
- در بخش اطلاعات برنامه، در نام برنامه،
Workspace MCP Serversرا تایپ کنید. - در ایمیل پشتیبانی کاربر، نشانی ایمیل خودتان یا گروه Google مناسبی را انتخاب کنید.
- روی بعدی کلیک کنید.
- در بخش مخاطبان، داخلی را انتخاب کنید. اگر نمیتوانید داخلی را انتخاب کنید، خارجی را انتخاب کنید.
- روی بعدی کلیک کنید.
- در بخش اطلاعات تماس، نشانی ایمیلی را وارد کنید که بتوانید ازطریق آن از هرگونه تغییر در پروژهتان مطلع شوید.
- روی بعدی کلیک کنید.
- در بخش پایان، خطمشی دادههای کاربر سرویسهای Google API را مرور کنید و اگر موافقید، با «خطمشی دادههای کاربر سرویسهای Google API» موافقم را انتخاب کنید.
- روی ادامه کلیک کنید.
- روی ایجاد کردن کلیک کنید.
- اگر خارجی را برای نوع کاربر انتخاب کردهاید، کاربران آزمایشی را اضافه کنید:
- روی مخاطبان کلیک کنید.
- در بخش کاربران آزمایشی، روی افزودن کاربران کلیک کنید.
- نشانی ایمیل خودتان و هر کاربر آزمایشی مجاز دیگری را وارد کنید، سپس روی ذخیره کلیک کنید.
- در بخش اطلاعات برنامه، در نام برنامه،
روی دسترسی به دادهها > افزودن یا برداشتن دامنهها کلیک کنید. پانلی با فهرستی از دامنهها برای هر میانای برنامهسازی کاربردی که در پروژه Google Cloud فعال کردهاید ظاهر میشود.
در بخش افزودن دستی دامنهها، دامنههای سرورهای MCP را که قصد دارید استفاده کنید جایگذاری کنید:
- Gmail:
https://www.googleapis.com/auth/gmail.readonlyhttps://www.googleapis.com/auth/gmail.composehttps://www.googleapis.com/auth/gmail.modify
- Drive:
https://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.file
- سندنگار:
https://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/documents.readonlyhttps://www.googleapis.com/auth/documents
- کاربرگنگار:
https://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/spreadsheets.readonlyhttps://www.googleapis.com/auth/spreadsheets
- اسلایدنگار:
https://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/presentations.readonlyhttps://www.googleapis.com/auth/presentations
- تقویم:
https://www.googleapis.com/auth/calendar.calendarlist.readonlyhttps://www.googleapis.com/auth/calendar.events.freebusyhttps://www.googleapis.com/auth/calendar.events.readonlyhttps://www.googleapis.com/auth/calendar.events
- گپ:
https://www.googleapis.com/auth/chat.spaces.readonlyhttps://www.googleapis.com/auth/chat.memberships.readonlyhttps://www.googleapis.com/auth/chat.messages.readonlyhttps://www.googleapis.com/auth/chat.messages.createhttps://www.googleapis.com/auth/chat.users.readstatehttps://www.googleapis.com/auth/chat.users.spacesettings
- People API:
https://www.googleapis.com/auth/directory.readonlyhttps://www.googleapis.com/auth/userinfo.profilehttps://www.googleapis.com/auth/contacts.readonly
- Classroom:
https://www.googleapis.com/auth/classroom.announcementshttps://www.googleapis.com/auth/classroom.courses.readonlyhttps://www.googleapis.com/auth/classroom.coursework.studentshttps://www.googleapis.com/auth/classroom.guardianlinks.students.readonlyhttps://www.googleapis.com/auth/classroom.profile.emailshttps://www.googleapis.com/auth/classroom.rosters.readonlyhttps://www.googleapis.com/auth/classroom.student-submissions.students.readonlyhttps://www.googleapis.com/auth/classroom.topics.readonlyhttps://www.googleapis.com/auth/classroom.topics
- جستجوی همگانی:
https://www.googleapis.com/auth/gmail.readonlyhttps://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/calendar.readonlyhttps://www.googleapis.com/auth/chat.messages.readonlyhttps://www.googleapis.com/auth/chat.spaces.readonlyhttps://www.googleapis.com/auth/chat.memberships.readonly
- Gmail:
روی افزودن به جدول کلیک کنید.
روی بهروزرسانی کلیک کنید.
پساز انتخاب کردن دامنههای موردنیاز برنامهتان، در صفحه دسترسی به دادهها، روی ذخیره کلیک کنید.
پیکربندی برنامه هوش مصنوعی
برای افزودن سرورهای MCP راه دور Google Workspace به برنامه هوش مصنوعیتان، دستورالعملهای مربوط به برنامهتان را دنبال کنید. فقط سرورهایی را اضافه کنید که در پروژه Google Cloud خود فعال کردهاید.
شناسههای کارخواه OAuth 2.0 واگذارشده به کاربر که سرورهای Google Workspace MCP را فراخوانی میکنند باید استفاده از این کارخواه برای نماینده مجهز به هوش مصنوعی را در پلاتفرم Google Auth > کارخواهها انتخاب کرده باشند. برای بهروزرسانی شناسه کارخواه OAuth 2.0 موجود، این تنظیم را در پلاتفرم Google Auth > کارخواهها انتخاب کنید، همانطور که در مدیریت کارخواههای OAuth شرح داده شده است. اگر نمیتوانید این تنظیم را در کارخواه موجود تغییر دهید، یا اگر کارخواه از ویژگیهای غیرعامل نیز پشتیبانی میکند، شناسه کارخواه OAuth 2.0 جدیدی برای عامل هوش مصنوعی خود ایجاد کنید. برای درخواستهای ردشده، حسابهای سرویس با واگذاری در سراسر دامنه، یا Google Apps Script، به عیبیابی مراجعه کنید.
Antigravity
برای افزودن سرورهای MCP راه دور Google Workspace به Antigravity،
پیکربندی سرور را به فایل mcp_config.json خود اضافه کنید. این
دستورالعملها از Antigravity 2.0، Antigravity IDE، و Antigravity CLI پشتیبانی میکنند.
یک شناسه و رمز کارخواه OAuth 2.0 ایجاد کنید، یا اگر قبلاً یکی در راهاندازی سریع برای استفاده شخصی ایجاد کردهاید، به مرحله بعدی بروید:
در کنسول Google Cloud، به پلاتفرم Google Auth > کارخواهها > ایجاد کارخواه بروید.
برنامه وب را بهعنوان نوع برنامه انتخاب کنید.
نام را وارد کنید.
در بخش URIهای تغییرمسیر مجاز، روی + افزودن URI کلیک کنید، و سپس
https://antigravity.google/oauth-callbackرا در فیلد URIها اضافه کنید.استفاده از این کارخواه برای عامل مجهز به هوش مصنوعی را انتخاب کنید.
روی ایجاد کلیک کنید و شناسه کارخواه و رمز کارخواه خود را کپی کنید.
فایل پیکربندی
~/.gemini/config/mcp_config.jsonرا باز یا ایجاد کنید.پیکربندی
mcpServersرا بهmcp_config.jsonاضافه کنید:{ "mcpServers": { "gmail": { "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "drive": { "serverUrl": "https://drivemcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "docs": { "serverUrl": "https://docsmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "sheets": { "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "slides": { "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "calendar": { "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "chat": { "serverUrl": "https://chatmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "people": { "serverUrl": "https://people.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "classroom": { "serverUrl": "https://classroommcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "workspace-universal": { "serverUrl": "https://workspacemcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } } } }موارد زیر را جایگزین کنید:
-
OAUTH_CLIENT_ID: شناسه کارخواهی که ایجاد کردید. -
OAUTH_CLIENT_SECRET: رمز کارخواهی که ایجاد کردید.
-
mcp_config.jsonصرفهجویی کنید.سرورهای MCP را اصالتسنجی کنید. میتوانید بااستفاده از تنظیمات GUI یا CLI اصالتسنجی کنید:
برای Antigravity IDE یا GUI (Antigravity 2.0):
- صفحه تنظیمات را باز کنید (مثلاً روی تنظیمات در پایین سمت راست کلیک کنید یا تنظیمات کاربر Antigravity را باز کنید).
- به سفارشیسازیها بروید.
- در بخش سرورهای MCP نصبشده، روی بازآوری کلیک کنید.
- برای هر سرور Google Workspace که پیکربندی کردهاید، روی اصالتسنجی کلیک کنید، به سیستم «حساب Google» خود وارد شوید، کد مجوز را کپی کنید، آن را در کادر گفتگوی ورودی جایگذاری کنید، و روی ارسال کلیک کنید.
برای Antigravity CLI:
شروع کردن Antigravity CLI:
agyبا اجرای دستور زیر، پانل مدیریت تعاملی MCP را باز کنید:
/mcpهر سرور MCP را اصالتسنجی کنید:
- بااستفاده از کلیدهای جهتنما، سرور را انتخاب کنید، به کنش اصالتسنجی بروید، و کلید ورود را فشار دهید. جریان ورود به سیستم را در مرورگرتان تکمیل کنید، کد مجوز را کپی کنید، آن را در پیامواره پایانه جایگذاری کنید، و کلید ورود را فشار دهید.
- این مراحل را برای هر سرور Google Workspace که پیکربندی کردهاید تکرار کنید.
تأیید کنید که سرورها بهدرستی پیکربندی شدهاند و درحال اجرا هستند:
- برای Antigravity IDE یا GUI: دکمه خروج از سیستم در کنار هر سرور در بخش سفارشیسازیها > سرورهای MCP نصبشده نمایش داده میشود.
- برای Antigravity CLI: پانل
/mcpرا باز کنید تا سرورهای MCP پیکربندیشدهتان را ببینید. سرورهای درستیسنجیشده و اصالتسنجیشده اصالتسنجیشده را در کنار نامشان در پانل تعاملی TUI نمایش میدهند. میتوانید هر سروری را در نمای داشبورد انتخاب کنید تا وضعیت آن را بررسی کنید و همه ابزارهای دردسترس آن را فهرست کنید.
سرورهای MCP راه دور برای استفاده در Antigravity آمادهاند.
Claude
برای استفاده از سرورهای MCP ازراهدور Google Workspace با Claude.ai یا Claude Desktop، باید طرح Claude Enterprise، Pro، Max، یا Team داشته باشید.
برای افزودن سرورهای MCP راه دور Google Workspace به Claude، یک متصلکننده سفارشی با شناسه کارخواه OAuth و رمز پیکربندی کنید.
یک شناسه و رمز کارخواه OAuth 2.0 ایجاد کنید، یا اگر قبلاً یکی در راهاندازی سریع برای استفاده شخصی ایجاد کردهاید، به مرحله بعدی بروید:
در کنسول Google Cloud، به پلاتفرم Google Auth > کارخواهها > ایجاد کارخواه بروید.
برنامه وب را بهعنوان نوع برنامه انتخاب کنید.
نام را وارد کنید.
در بخش URIهای تغییرمسیر مجاز، روی + افزودن URI کلیک کنید، و سپس
https://claude.ai/api/mcp/auth_callbackرا در فیلد URIها اضافه کنید.استفاده از این کارخواه برای عامل مجهز به هوش مصنوعی را انتخاب کنید.
روی ایجاد کلیک کنید و شناسه کارخواه و رمز کارخواه خود را کپی کنید.
سرور MCP را در Claude پیکربندی کنید:
- در Claude.ai یا Claude Desktop، به تنظیمات > رابطها یا تنظیمات سرپرست > رابطها بروید.
- روی افزودن متصلکننده سفارشی کلیک کنید.
جزئیات اتصال را برای سرور Google Workspace که میخواهید اضافه کنید وارد کنید:
- نام سرور: نامی برای سرور، مثل
Gmail. - نشانی وب سرور MCP راه دور: نشانی وب برای
سرور Google Workspace، مانند یکی از موارد زیر:
- Gmail:
https://gmailmcp.googleapis.com/mcp/v1 - Drive:
https://drivemcp.googleapis.com/mcp/v1 - سندنگار:
https://docsmcp.googleapis.com/mcp/v1 - Sheets:
https://sheetsmcp.googleapis.com/mcp/v1 - اسلایدها:
https://slidesmcp.googleapis.com/mcp/v1 - تقویم:
https://calendarmcp.googleapis.com/mcp/v1 - گپ:
https://chatmcp.googleapis.com/mcp/v1 - People API:
https://people.googleapis.com/mcp/v1 - Classroom:
https://classroommcp.googleapis.com/mcp/v1 - جستجوی همگانی:
https://workspacemcp.googleapis.com/mcp/v1
- Gmail:
- نام سرور: نامی برای سرور، مثل
در تنظیمات پیشرفته، شناسه کارخواه OAuth و رمز کارخواه OAuth را وارد کنید.
روی افزودن کلیک کنید.
این مراحل را برای هر سرور Google Workspace که میخواهید اضافه کنید تکرار کنید.
موارد دیگر
بسیاری از برنامههای هوش مصنوعی روشهایی برای متصل شدن به سرور MCP ازراهدور دارند. معمولاً باید جزئیات مربوط به سرور، مانند نام، نقاط پایانی، پروتکل انتقال، و روش اصالتسنجی را وارد کنید. برای سرورهای MCP راه دور Google Workspace، موارد زیر را وارد کنید:
نام سرور:
googleworkspaceسرورها: هر سرور Google Workspace MCP نشانی وب سرور خودش را دارد:
- Gmail:
https://gmailmcp.googleapis.com/mcp/v1 - Drive:
https://drivemcp.googleapis.com/mcp/v1 - سندنگار:
https://docsmcp.googleapis.com/mcp/v1 - برگنگار:
https://sheetsmcp.googleapis.com/mcp/v1 - اسلایدها:
https://slidesmcp.googleapis.com/mcp/v1 - تقویم:
https://calendarmcp.googleapis.com/mcp/v1 - گپ:
https://chatmcp.googleapis.com/mcp/v1 - People API:
https://people.googleapis.com/mcp/v1 - Classroom:
https://classroommcp.googleapis.com/mcp/v1 - جستجوی همگانی:
https://workspacemcp.googleapis.com/mcp/v1
- Gmail:
انتقال: HTTP قابلجاریسازی
اصالتسنجی: سرورهای MCP ازراهدور Google Workspace از OAuth 2.0 استفاده میکنند. هنگام ایجاد کارخواه OAuth 2.0، استفاده از این کارخواه برای عامل مجهز به هوش مصنوعی را انتخاب کنید. برای راهاندازیهای شخصی تککاربره، میتوانید بااستفاده از راهاندازی سریع برای استفاده شخصی، کارخواه وب، رایانه، Android، یا iOS ایجاد کنید. برای جزئیات، به آشنایی با اصالتسنجی و صدور مجوز مراجعه کنید.
برای جلوگیری از پیاموارههای ورود به سیستم ساعتی با کارخواه OAuth برنامه وب، کارخواه MCP خود را پیکربندی کنید تا بااستفاده از
access_type=offlineیا گسترهoffline_access، دسترسی آفلاین درخواست کند. برای جزئیات بیشتر، پیاموارههای ورود به سیستم ساعتی تکراری را ببینید.
برای جزئیات بیشتر درباره متصل کردن انواع مختلف برنامههای هوش مصنوعی، به پیکربندی MCP در برنامه هوش مصنوعی مراجعه کنید.
افزودن سرور MCP «دانش توسعهدهنده»
سرور Developer Knowledge MCP
یک سرور راه دور است که مستندات رسمی و زنده توسعهدهنده Google، ازجمله developers.google.com/workspace، را جستجو میکند تا عامل هوشوارهای شما بتواند بهجای تکیه صرف بر دادههای آموزشی خود، روشهای API فعلی، دامنههای OAuth، و نمونههای کد را جستجو کند. این سرور ابزارهای search_documents، get_documents، و answer_query را ارائه میدهد و سرورهای MCP در Google Workspace را تکمیل میکند، که به نماینده شما اجازه میدهد روی دادههای Google Workspace اقدام کند. افزودن سرور MCP «دانش توسعهدهنده»
در کنار آنها به نماینده شما کمک میکند تا به سؤالات مربوط به ساخت با
Google Workspace API از اسناد فعلی پاسخ دهد.
برای افزودن این سرور به برنامه هوش مصنوعی خود،
پیکربندی IDE یا عامل کدنویسی
را دنبال کنید و برنامه هوش مصنوعی خود را انتخاب کنید. برای کمک به نمایندهتان در تصمیمگیری درباره زمان جستجوی
اسناد و اینکه از کدام ابزار استفاده کند،
مهارت نماینده retrieving-developer-knowledge را نیز نصب کنید.
آزمایش کردن سرورهای Google Workspace MCP
پساز پیکربندی برنامه هوش مصنوعی، میتوانید با اجرای چند پیامواره آزمایشی، اتصال را درستیسنجی کنید.
سؤالات زیر را از برنامه هوش مصنوعی بپرسید:
«آریل در آخرین ایمیلش درباره طرح بازاریابی ما چه گفت؟»
کارخواه ایمیلهای Ariel را بااستفاده از
gmail.search_threadsفیلتر میکند، محتوای جدیدترین رشته را باgmail.get_threadبازیابی میکند، و سپس آن را برای شما خلاصه میکند.«ایمیلی به ariel@example.com پیشنویس کن و بگو که طرح بازاریابی را تأیید میکنم.»
کارخواه از
gmail.create_draftبرای ایجاد ایمیل در پوشه پیشنویسهای شما استفاده میکند، و به شما امکان میدهد آن را در Gmail مرور و ارسال کنید.«فایل Marketing Plan (طرح بازاریابی) را خلاصه کن.»
کارخواه
drive.search_filesرا برای یافتن «طرح بازاریابی» فرامیخواند، سپس ازdrive.read_file_contentبرای بازیابی و خلاصه کردن محتوای آن استفاده میکند.«محتوای ساختاری یادداشتهای جلسه «سندنگار Google» را به من نشان بده.»
مشتری ساختار و محتوای سند را بااستفاده از
docs.read_docواکشی میکند.«Read sheet Sheet1 from Google Sheet Quarterly Sales.» (برگه Sheet1 را از «کاربرگنگار Google» با عنوان «فروش فصلی» بخوان.)
کارخواه مقادیر جدول را بااستفاده از
sheets.get_valuesواکشی میکند.«چیدمان کلامیشده ارائه «نمای کلی محصول» در «اسلایدنگار Google» را به من نشان بده.»
کارخواه ساختارهای چیدمان دیداری ارائه را بااستفاده از
slides.read_presentationواکشی میکند.«جلسه بعدی من با آریل چه زمانی است؟»
مشتری بااستفاده از
calendar.list_eventsبرنامه زمانی شما را بررسی میکند و جزئیات جلسه بعدیتان با Ariel را ارائه میدهد.«آخرین پیام در فضای «پروژه X» چه بود؟»
کارخواه فضا را بااستفاده از
chat.search_conversationsپیدا میکند و سپس پیامها را بااستفاده ازchat.list_messagesبازیابی میکند.«طبق نمایه Google من، نامم چیست؟»
این کارخواه از
people.get_user_profileبرای بازیابی اطلاعات نمایه Google Workspace شما استفاده میکند.«درحالحاضر چه کلاسهایی را تدریس میکنم؟»
مشتری بااستفاده از
classroom.list_coursesبرنامه زمانی شما را بررسی میکند و دورههای فعالی را که در آنها نقش معلم دارید خلاصه میکند.«برای کلاس زمینشناسی من، اعلانی درباره سفر علمی پیشرو پیشنویس کن.»
مشتری از
classroom.create_announcementبرای پیشنویس کردن اطلاعیه استفاده میکند، که میتوانید آن را در برنامه Classroom مرور و پست کنید.«هر چیزی را که به پروژه X مربوط میشود در ایمیل، فایلها، و پیامهای گپ من پیدا کن.»
کارخواه
search_corpusرا در سرور MCP «جستجوی جهانی» فراخوانی میکند تا در Gmail، Drive، «تقویم»، و Chat با یک درخواست جستجو کند.«اسناد رسمی Google Workspace را برای دامنه OAuth که ابزار Gmail
create_draftنیاز دارد بررسی کن، سپس پیشنویس ایمیلی به ariel@example.com برای تأیید طرح بازاریابی بنویس.»اگر سرور MCP «دانش توسعهدهنده» را اضافه کرده باشید، کارخواه
search_documentsرا فراخوانی میکند تا دامنه را در سند مرجع Gmail MCP پیدا کند، و سپس ازgmail.create_draftبرای ایجاد پیشنویس استفاده میکند.
اگر ابزارها با موفقیت اجرا شوند و پاسخهای مربوط دریافت کنید، سرورهای MCP در Google Workspace شما بهدرستی پیکربندی شدهاند.
عیبیابی
از بخشهای زیر برای حل مشکلات رایج اصالتسنجی و اتصال با سرورهای MCP در Google Workspace استفاده کنید.
بررسی رویدادهای گزارش OAuth
اگر در اتصال به سرورهای MCP با مشکل مواجه شدید، گزارشهای OAuth را برای یافتن خطا بررسی کنید. از سرپرست Google Workspace خود بخواهید رویدادهای ثبتشده OAuth را در ابزار بررسی امنیتی بازبینی کند.
درخواستهای ردشده از کارخواههای OAuth واگذارشده به کاربر
اگر درخواستهای شما به سرورهای MCP رد میشود، مطمئن شوید که شناسه کارخواه OAuth 2.0 واگذارشده به کاربر برای جریان OAuth سهپایه شما دارای استفاده از این کارخواه برای نماینده مجهز به هوش مصنوعی انتخابشده در پلاتفرم Google Auth > کارخواهها باشد:
- کارخواه موجود از این تنظیم پشتیبانی میکند: استفاده از این کارخواه برای عامل مجهز به هوش مصنوعی را در کارخواه OAuth موجود انتخاب کنید.
- کارخواه موجود بهروز نمیشود: کارخواه OAuth جدیدی ایجاد کنید و گزینه استفاده از این کارخواه برای عامل مجهز به هوش مصنوعی را انتخاب کنید و برنامهتان را بهروز کنید تا از آن استفاده کند.
- کارخواه موجود از ویژگیهای غیرعامل نیز پشتیبانی میکند: یک کارخواه OAuth جداگانه برای عامل هوش مصنوعی ایجاد کنید و کارخواه موجود را برای ویژگیهای غیرعامل خود نگه دارید.
برای دستورالعملها، به پیکربندی برنامه هوش مصنوعی و مدیریت کارخواههای OAuth مراجعه کنید.
حسابهای سرویس با تفویض اختیار در سراسر دامنه
اگر برنامهتان از حساب سرویس با واگذاری در سطح دامنه برای OAuth دوطرفه استفاده میکند، نمیتوانید استفاده از این کارخواه برای نماینده مجهز به هوش مصنوعی را انتخاب کنید زیرا حسابهای سرویس در پلاتفرم Google Auth > کارخواهها مدیریت نمیشوند:
- کنترل دسترسی: درخواستهای ارسالشده به سرورهای MCP از این حسابهای سرویس بهدلیل نداشتن تنظیمات عامل رد نمیشوند. درعوض، دسترسی توسط تنظیمات واگذاری در سراسر دامنه که سرپرست Google Workspace شما مدیریت میکند کنترل میشود. برای جزئیات مربوط به تنظیمات سرپرست، کنترل دسترسی به API با واگذاری سراسر دامنه را ببینید.
- کنشهای حساس: سرورهای Google Workspace MCP همچنان پیاموارههای استخراج فرم را برای تأیید مشارکت انسانی در حلقه در تماسهای ابزار حساس که ازطریق جعل هویت کاربر واگذاری در سراسر دامنه انجام میشوند، برمیگردانند.
درخواستها از Apps Script
اگر سرورهای MCP را از Apps Script فراخوانی کنید، نمیتوانید از این کارخواه برای نماینده مجهز به هوش مصنوعی در کارخواه OAuth پیشفرض که Apps Script برای اسکریپت شما ایجاد و مدیریت میکند استفاده کنید. این موضوع حتی اگر اسکریپت شما از پروژه استاندارد Google Cloud استفاده کند نیز اعمال میشود.
برای فراخوانی سرورهای MCP از Apps Script، کارهای زیر را انجام دهید:
- در کنسول Google Cloud، به پلاتفرم Google Auth > کارخواهها بروید، یک کارخواه OAuth ایجاد کنید، و استفاده از این کارخواه برای نماینده مجهز به هوش مصنوعی را انتخاب کنید.
- در اسکریپت خود، از OAuth2 برای کتابخانه Apps Script استفاده کنید تا کاربران را با آن کارخواه OAuth مجاز کنید.
- وقتی سرورهای MCP را فراخوانی میکنید، کد دسترسی را که کتابخانه برمیگرداند بهجای کد از
ScriptApp.getOAuthTokenارسال کنید.
پروژههای Apps Script که سرورهای MCP را فراخوانی نمیکنند تحتتأثیر قرار نمیگیرند.
پیاموارههای ورود به سیستم ساعتی تکراری
اگر تقریباً هر ساعت از شما خواسته میشود دوباره به سیستم وارد شوید، کارخواه MCP شما ژتون بازآوری را دریافت یا استفاده نمیکند. این اتفاق معمولاً در شرایط زیر رخ میدهد:
- دسترسی آفلاین در کارخواه OAuth برنامه وب وجود ندارد: برخلاف کارخواههای OAuth برنامه رایانهای، کارخواههای OAuth برنامه وب بهطور پیشفرض دسترسی آنلاین دارند. برای درخواست ژتون بازآوری،
access_type=offlineرا اضافه کنید یاoffline_accessOpenID Connect (OIDC) را در کنار حداقل یک دامنه API اضافه کنید وaccess_type=onlineرا تنظیم نکنید. - صدور مجدد مجوز برای برنامهای که قبلاً با آن موافقت شده است: سرور OAuth 2.0 Google
اولین باری که کاربر دسترسی آفلاین اعطا میکند، یک ژتون بازآوری صادر میکند. اگر
کاربری قبلاً کارخواه OAuth شما را بدون دسترسی آفلاین مجاز کرده باشد، یا اگر
کارخواه MCP شما ژتون بازآوری ذخیرهشده خود را ازدست داده باشد، ممکن است ورودهای بعدی به سیستم
ژتون بازآوری جدیدی برنگرداند.
prompt=consentرا در درخواست مجوز اضافه کنید، یا دسترسی برنامه را در اتصالهای «حساب Google» بردارید و دوباره به سیستم وارد شوید. - رمزیاب دارنده ثابت: اگر کد دسترسی خام را در
سرصفحه
Authorizationارسال کنید، مثلاً خروجی ازgcloud auth print-access-token، رمزیاب پساز یک ساعت منقضی میشود مگراینکه کارخواه شما آن را بازآوری کند.
برای جزئیات، بازآوری کد دسترسی را ببینید.
محصولات پشتیبانیشده
جدول زیر هر سرور MCP پشتیبانیشده Google Workspace، راهنمای راهاندازی آن، نشانی وب نقطه پایان MCP راه دور آن، و مرجع ابزار MCP تولیدشده آن را فهرست میکند:
| راهنمای محصول و راهاندازی | نشانی وب سرور MCP راه دور | مرجع ابزار |
|---|---|---|
| Gmail | https://gmailmcp.googleapis.com/mcp/v1 |
مرجع Gmail MCP |
| Drive | https://drivemcp.googleapis.com/mcp/v1 |
مرجع MCP در Drive |
| سندنگار | https://docsmcp.googleapis.com/mcp/v1 |
مرجع MCP «سندنگار» |
| کاربرگنگار | https://sheetsmcp.googleapis.com/mcp/v1 |
مرجع MCP «کاربرگنگار» |
| اسلایدنگار | https://slidesmcp.googleapis.com/mcp/v1 |
مرجع MCP «اسلایدنگار» |
| تقویم | https://calendarmcp.googleapis.com/mcp/v1 |
مرجع MCP تقویم |
| گپ | https://chatmcp.googleapis.com/mcp/v1 |
مرجع Chat MCP |
| People API | https://people.googleapis.com/mcp/v1 |
مرجع People API MCP |
| Classroom | https://classroommcp.googleapis.com/mcp/v1 |
مرجع Classroom MCP |
| جستجوی همگانی | https://workspacemcp.googleapis.com/mcp/v1 |
مرجع MCP جستجوی همگانی |
ملاحظه امنیتی مهم: تزریق پیامواره غیرمستقیم
وقتی مدل زبانی را درمعرض دادههای غیرقابلاعتماد قرار میدهید، خطر حمله تزریق پیامواره غیرمستقیم وجود دارد. چون برنامههای کاربردی هوش مصنوعی مثل Google Antigravity ازطریق سرورهای MCP در Google Workspace به ابزارها و میاناهای برنامهسازی کاربردی قدرتمند دسترسی دارند، میتوانند دادههای «حساب Google» شما را بخوانند، اصلاح کنند، و حذف کنند.
برای کاهش این خطرات، باید پیاموارهها و پاسخها را ازنظر محتوای مخرب یا حملات تزریق پیامواره غربال کنید. میتوانید از Model Armor ارائهشده توسط Google استفاده کنید، یا میتوانید از راهکار خودتان استفاده کنید، بهشرطی که آن را مستند کنید تا کاربران بتوانند آن خطر را بپذیرند. برای دریافت دستورالعملها، به پیکربندی امنیت برای سرورهای «پروتکل زمینهای مدل» Google Workspace مراجعه کنید.
این روالهای مطلوب را دنبال کنید:
- فقط از ابزارهای مورداعتماد استفاده کنید. هرگز سرورهای MCP در Google Workspace را به برنامههای غیرقابلاعتماد یا تأییدنشده متصل نکنید.
- دربرابر ورودیهای غیرقابلاعتماد احتیاط کنید. از برنامه هوش مصنوعی خود نخواهید که ایمیلها، اسناد، یا منابع دیگر را از منابع تأییدنشده پردازش کند. این ورودیها ممکن است حاوی دستورالعملهای پنهانی باشند که میتوانند جلسه شما را بربایند و به مهاجم اجازه دهند دادههایتان را تغییر دهد، بهسرقت ببرد، یا حذف کند.
- همه کنشها را مرور کنید. همیشه کنشهایی را که برنامه هوش مصنوعی ازجانب شما انجام میدهد بهدقت بازبینی کنید تا مطمئن شوید که دقیق هستند و با اهداف شما مطابقت دارند.