پیکربندی سرور MCP گپ

Google Chat یک سرور Model Context Protocol (MCP) از راه دور ارائه می‌دهد که به عامل‌های هوشواره امکان می‌دهد به‌صورت امن با داده‌های Google Chat تعامل داشته باشند. با پیکربندی سرور MCP در Google Chat، به برنامه‌های هوش مصنوعی مثل Google Antigravity و Claude امکان می‌دهید کنش‌هایی را در Google Chat انجام دهند.

سرور Google Chat MCP روشی استاندارد برای عامل‌های هوش مصنوعی فراهم می‌کند تا:

  • خواندن داده‌ها: فهرست کردن و جستجوی مکالمه‌ها، و خواندن پیام‌ها.
  • رعایت امنیت: همان اجازه‌ها و کنترل‌های حاکمیت داده کاربر را به ارث می‌برد.

پیش‌نیازها

پیکربندی سرور MCP در Google Chat

برای استفاده از سرور MCP در Google Chat، باید آن را در پروژه Google Cloud خود فعال کنید و سپس کارخواه MCP خود را برای اتصال به آن پیکربندی کنید.

فعال کردن میاناهای برنامه‌سازی کاربردی

برای استفاده از سرور MCP در Google Chat، باید میاناهای برنامه‌سازی کاربردی زیر را در پروژه Google Cloud خود فعال کنید:

  • Google Chat API

CLI

gcloud services enable chat.googleapis.com --project=PROJECT_ID

PROJECT_ID را با شناسه پروژه Google Cloud خودتان جایگزین کنید.

کنسول

میاناهای برنامه‌سازی کاربردی را در کنسول Google Cloud فعال کنید:

فعال کردن میاناهای برنامه‌سازی کاربردی

فعال کردن سرویس‌های MCP

برای فعال کردن مؤلفه‌های MCP برای Google Chat، باید سرویس زیر را در پروژه Google Cloud خود فعال کنید:

  • Google Chat MCP API

CLI

gcloud services enable chatmcp.googleapis.com --project=PROJECT_ID

PROJECT_ID را با شناسه پروژه Google Cloud خودتان جایگزین کنید.

کنسول

سرویس‌های MCP را در کنسول Google Cloud فعال کنید:

فعال کردن سرویس‌های MCP

پیکربندی برنامه Chat

برای استفاده از سرور MCP در Google Chat برای انجام عملیات فقط خواندنی، مانند جستجوی مکالمه‌ها، باید API را فعال کنید و یک کارخواه OAuth ایجاد کنید. برنامه Chat پیکربندی‌شده لازم نیست.

برای انجام عملیات نوشتن، مثل ارسال پیام، باید برنامه Chat را در پروژه Google Cloud خود پیکربندی کنید.

  1. در کنسول Google Cloud، Google Chat API را جستجو کنید و روی Google Chat API > مدیریت > پیکربندی کلیک کنید.

    به Google Chat API بروید

  2. راه‌اندازی برنامه Chat:

    1. در فیلد نام برنامه، Chat MCP را وارد کنید.
    2. در فیلد نشانی وب چهره‌نما، https://developers.google.com/chat/images/quickstart-app-avatar.png را وارد کنید.
    3. در شرح، Chat MCP server را وارد کنید.
    4. در بخش عملکرد، ویژگی‌های تعاملی را با خاموش کردن فعال کردن ویژگی‌های تعاملی غیرفعال کنید.
    5. در بخش گزارش‌ها، گزارش کردن خطاها در Logging را انتخاب کنید.

  3. روی ذخیره کلیک کنید.

برای کسب اطلاعات بیشتر درباره ساختن برنامه Chat، انتخاب معماری برنامه Google Chat را ببینید.

سرور MCP در Google Chat از OAuth 2.0 برای اصالت‌سنجی و مجوزدهی استفاده می‌کند. قبل‌از اینکه بتوانید شناسه کارخواه OAuth ایجاد کنید، باید صفحه رضایت OAuth را پیکربندی کنید.

  1. در کنسول Google Cloud، به پلاتفرم Google Auth > نمانام‌سازی بروید.

    رفتن به نمانام‌سازی

  2. اگر قبلاً پلاتفرم Google Auth را پیکربندی کرده‌اید، می‌توانید تنظیمات «صفحه رضایت OAuth» زیر را در نام‌گذاری تجاری، مخاطب، و دسترسی به داده پیکربندی کنید. اگر پیامی دیدید که می‌گوید پلاتفرم Google Auth هنوز پیکربندی نشده است، روی شروع به کار کلیک کنید:

    1. در بخش اطلاعات برنامه، در نام برنامه، Chat MCP Server را تایپ کنید.
    2. در ایمیل پشتیبانی کاربر، نشانی ایمیل خودتان یا گروه Google مناسبی را انتخاب کنید.
    3. روی بعدی کلیک کنید.
    4. در بخش مخاطبان، داخلی را انتخاب کنید. اگر نمی‌توانید داخلی را انتخاب کنید، خارجی را انتخاب کنید.
    5. روی بعدی کلیک کنید.
    6. در بخش اطلاعات تماس، نشانی ایمیلی را وارد کنید که بتوانید ازطریق آن از هرگونه تغییر در پروژه‌تان مطلع شوید.
    7. روی بعدی کلیک کنید.
    8. در بخش پایان، خط‌مشی داده‌های کاربر Google API Services را مرور کنید و اگر موافق هستید، با خط‌مشی داده‌های کاربر Google API Services موافقم را انتخاب کنید.
    9. روی ادامه کلیک کنید.
    10. روی ایجاد کردن کلیک کنید.
    11. اگر خارجی را برای نوع کاربر انتخاب کردید، کاربران آزمایشی را اضافه کنید:
      1. روی مخاطبان کلیک کنید.
      2. در بخش کاربران آزمایشی، روی افزودن کاربران کلیک کنید.
      3. نشانی ایمیل خودتان و هر کاربر آزمایشی مجاز دیگری را وارد کنید، سپس روی ذخیره کلیک کنید.

  3. روی دسترسی به داده‌ها > افزودن یا برداشتن دامنه‌ها کلیک کنید. پانلی با فهرست دامنه‌های هر میانای برنامه‌سازی کاربردی که در پروژه Google Cloud فعال کرده‌اید ظاهر می‌شود.

    1. در بخش افزودن دستی دامنه‌ها، دامنه‌های سرور MCP در Google Chat را جای‌گذاری کنید:

      • https://www.googleapis.com/auth/chat.spaces.readonly
      • https://www.googleapis.com/auth/chat.memberships.readonly
      • https://www.googleapis.com/auth/chat.messages.readonly
      • https://www.googleapis.com/auth/chat.messages.create
      • https://www.googleapis.com/auth/chat.users.readstate
      • https://www.googleapis.com/auth/chat.users.spacesettings

    2. روی افزودن به جدول کلیک کنید.

    3. روی به‌روزرسانی کلیک کنید.

    4. پس‌از انتخاب کردن دامنه‌های موردنیاز برنامه‌تان، در صفحه دسترسی به داده‌ها، روی ذخیره کلیک کنید.

پیکربندی کردن کارخواه MCP

برای افزودن سرور MCP راه دور Google Chat به کارخواه MCP خود، دستورالعمل‌های کارخواه خود را دنبال کنید.

Antigravity

برای افزودن سرور MCP راه دور Google Chat به Antigravity، پیکربندی سرور را به فایل mcp_config.json خود اضافه کنید. این دستورالعمل‌ها از Antigravity 2.0،‏ Antigravity IDE، و Antigravity CLI پشتیبانی می‌کنند.

  1. شناسه و رمز کارخواه OAuth 2.0 ایجاد کنید:

    1. در کنسول Google Cloud، به Google Auth Platform > Clients > Create Client بروید

      رفتن به «ایجاد کارخواه»

    2. برنامه وب را به‌عنوان نوع برنامه انتخاب کنید.

    3. نامی وارد کنید.

    4. در بخش شناسه‌های URI هدایت مجاز، روی + افزودن شناسه URI کلیک کنید، و سپس https://antigravity.google/oauth-callback را در فیلد شناسه‌های URI اضافه کنید.

    5. استفاده از این کارخواه برای عامل هوشواره‌ای را انتخاب کنید.

    6. روی ایجاد کلیک کنید و شناسه کارخواه و رمز کارخواه خود را کپی کنید.

  2. فایل پیکربندی ~/.gemini/config/mcp_config.json را باز یا ایجاد کنید.

  3. پیکربندی mcpServers را به mcp_config.json اضافه کنید:

    {
  "mcpServers": {
    "chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

    موارد زیر را جایگزین کنید:

    • ‫OAUTH_CLIENT_ID: شناسه مشتری‌ای که ایجاد کردید.
    • ‫OAUTH_CLIENT_SECRET: رمز کارخواهی که ایجاد کردید.

  4. ‫mcp_config.json صرفه‌جویی کنید.

  5. سرور MCP را اصالت‌سنجی کنید. می‌توانید بااستفاده از تنظیمات GUI یا CLI اصالت‌سنجی کنید:

    • برای Antigravity IDE یا GUI‏ (Antigravity 2.0):

      1. صفحه تنظیمات را باز کنید (مثلاً روی تنظیمات در پایین سمت راست کلیک کنید یا تنظیمات کاربر Antigravity را باز کنید).
      2. به سفارشی‌سازی‌ها بروید.
      3. در بخش سرورهای MCP نصب‌شده، روی بازآوری کلیک کنید.
      4. chat را در فهرست پیدا کنید، روی اصالت‌سنجی کلیک کنید، به سیستم «حساب Google» خود وارد شوید، کد مجوز را کپی کنید، آن را در کادر گفتگوی ورودی جای‌گذاری کنید، و روی ارسال کلیک کنید.

    • برای Antigravity CLI:

      1. Antigravity CLI را شروع کنید:

        agy

      2. با اجرای دستور زیر، پانل مدیریت تعاملی MCP را باز کنید:

        /mcp

      3. بااستفاده از کلیدهای جهت‌نما، chat را انتخاب کنید، به کنش اصالت‌سنجی بروید، و کلید ورود را فشار دهید. جریان ورود به سیستم را در مرورگرتان تکمیل کنید، کد مجوز را کپی کنید، آن را در پیام‌واره پایانه جای‌گذاری کنید، و کلید ورود را فشار دهید.

  6. تأیید کنید که سرور به‌درستی پیکربندی شده است و درحال اجرا است:

    • برای Antigravity IDE یا GUI: دکمه خروج از سیستم در کنار سرور در بخش سفارشی‌سازی‌ها > سرورهای MCP نصب‌شده نمایش داده می‌شود.
    • برای Antigravity CLI: پانل /mcp را باز کنید تا سرورهای MCP پیکربندی‌شده‌تان را ببینید. سرورهای درستی‌سنجی‌شده و اصالت‌سنجی‌شده اصالت‌سنجی‌شده را در کنار نامشان در پانل تعاملی TUI نمایش می‌دهند. می‌توانید هر سروری را در نمای داشبورد انتخاب کنید تا وضعیت آن را بررسی کنید و همه ابزارهای دردسترس آن را فهرست کنید.

سرور MCP راه دور برای استفاده در Antigravity آماده است.

Claude

برای استفاده از سرور MCP ازراه‌دور Google Chat با Claude.ai یا Claude Desktop، باید طرح Claude Enterprise،‏ Pro،‏ Max، یا Team داشته باشید.

برای افزودن سرور MCP راه دور Google Chat به Claude، یک رابط سفارشی با شناسه و رمز کارخواه OAuth پیکربندی کنید.

  1. شناسه و رمز کارخواه OAuth 2.0 ایجاد کنید:

    1. در کنسول Google Cloud، به Google Auth Platform > Clients > Create Client بروید

      رفتن به «ایجاد کارخواه»

    2. برنامه وب را به‌عنوان نوع برنامه انتخاب کنید.

    3. نامی وارد کنید.

    4. در بخش شناسه‌های URI هدایت مجاز، روی + افزودن شناسه URI کلیک کنید، و سپس https://claude.ai/api/mcp/auth_callback را در فیلد شناسه‌های URI اضافه کنید.

    5. استفاده از این کارخواه برای عامل هوشواره‌ای را انتخاب کنید.

    6. روی ایجاد کلیک کنید و شناسه کارخواه و رمز کارخواه خود را کپی کنید.

  2. پیکربندی کردن سرور MCP در Claude:

    1. در Claude.ai یا Claude Desktop، به تنظیمات (یا تنظیمات سرپرست) > رابط‌ها بروید.
    2. روی افزودن متصل‌کننده سفارشی کلیک کنید.
    3. جزئیات اتصال را برای محصول Google Chat وارد کنید:
      • نام سرور: Google Chat.
      • نشانی وب سرور MCP راه دور: https://chatmcp.googleapis.com/mcp/v1
    4. در تنظیمات پیشرفته، شناسه کارخواه OAuth و رمز کارخواه OAuth را وارد کنید.
    5. روی افزودن کلیک کنید.

موارد دیگر

بسیاری از برنامه‌های هوش مصنوعی روش‌هایی برای متصل شدن به سرور MCP ازراه‌دور دارند. معمولاً باید جزئیات مربوط به سرور را وارد کنید، مانند نام، نقاط پایانی، پروتکل انتقال، و روش اصالت‌سنجی. برای سرور MCP راه دور Google Chat، موارد زیر را وارد کنید:

  • نام سرور: chat

  • نشانی وب سرور: https://chatmcp.googleapis.com/mcp/v1

  • انتقال: HTTP جاری‌سازی‌شدنی

  • اصالت‌سنجی: سرور MCP راه دور Google Chat از OAuth 2.0 استفاده می‌کند. هنگام ایجاد کارخواه OAuth 2.0، استفاده از این کارخواه برای عامل مجهز به هوش مصنوعی را انتخاب کنید. برای جزئیات، به آشنایی با اصالت‌سنجی و صدور مجوز مراجعه کنید.

برای جزئیات بیشتر درباره متصل کردن انواع مختلف کارخواه‌ها، پیکربندی MCP در برنامه هوش مصنوعی را ببینید.

آزمایش کردن سرور Google Chat MCP

پس‌از پیکربندی کردن کارخواه MCP، می‌توانید با اجرای چند پیام‌واره آزمایشی، اتصال را درستی‌سنجی کنید.

سؤالات زیر را از کارخواه MCP خود بپرسید:

  • «آخرین پیام در فضای «پروژه X» چه بود؟»

    کارخواه فضا را بااستفاده از search_conversations پیدا می‌کند و سپس پیام‌ها را بااستفاده از list_messages بازیابی می‌کند.

اگر ابزارها با موفقیت اجرا شوند و پاسخ‌های مرتبط دریافت کنید، سرور MCP شما در Google Chat به‌درستی پیکربندی شده است.

عیب‌یابی

اگر در اتصال به سرور MCP با مشکل مواجه شدید، می‌توانید خطاها را در گزارش‌های OAuth بررسی کنید. از سرپرستتان بخواهید رویدادهای گزارش OAuth را در ابزار تحقیقات امنیتی بررسی کند.

اگر درخواست‌های شما به سرور MCP رد می‌شود، مطمئن شوید که کارخواه OAuth 2.0 شما استفاده از این کارخواه برای نماینده مجهز به هوش مصنوعی را در پلاتفرم اصالت‌سنجی Google > کارخواه‌ها انتخاب کرده باشد. اگر نمی‌توانید این تنظیم را در کارخواه OAuth موجود تغییر دهید، کارخواه OAuth جدیدی ایجاد کنید و استفاده از این کارخواه برای نماینده مجهز به هوش مصنوعی را انتخاب کنید و برنامه‌تان را به‌روز کنید تا از آن استفاده کند. اگر از یک کارخواه OAuth موجود هم برای عامل هوشواره‌ای و هم برای ویژگی‌های غیرعامل استفاده می‌شود، یک کارخواه OAuth جداگانه برای عامل هوشواره‌ای ایجاد کنید و کارخواه موجود را برای ویژگی‌های غیرعامل نگه دارید. برای دستورالعمل‌ها، به پیکربندی کارخواه MCP و مدیریت کارخواه‌های OAuth مراجعه کنید.

اگر تقریباً هر ساعت از شما خواسته می‌شود دوباره به سیستم وارد شوید، کارخواه MCP شما ژتون بازآوری دریافت نمی‌کند. سرور مجوز Google فقط زمانی ژتون بازآوری صادر می‌کند که درخواست مجوز شامل access_type=offline باشد؛ درخواست کردن گستره OIDC offline_access به‌تنهایی کافی نیست. اگر کارخواه MCP شما از پارامترهای مجوز سفارشی پشتیبانی می‌کند، access_type=offline را به درخواست مجوز اضافه کنید. برای دریافت ژتون بازآوری جدید برای کاربری که قبلاً دسترسی اعطا کرده است، prompt=consent را نیز اضافه کنید.

مرجع ابزار

ابزارهای زیر برای سرور MCP در Google Chat دردسترس است:

  • search_conversations
  • list_messages
  • search_messages
  • send_message
  • mark_as_read
  • mark_as_unread
  • list_memberships
  • get_notification_settings
  • update_notification_settings

ملاحظه امنیتی مهم: تزریق پیام‌واره غیرمستقیم

وقتی مدل زبانی را درمعرض داده‌های غیرقابل‌اعتماد قرار می‌دهید، خطر حمله تزریق پیام‌واره غیرمستقیم وجود دارد. چون میزبان‌های MCP مثل Google Antigravity ازطریق سرور MCP در Google Chat به ابزارها و میاناهای برنامه‌سازی کاربردی قدرتمند دسترسی دارند، می‌توانند داده‌های «حساب Google» شما را بخوانند، اصلاح کنند، و حذف کنند.

برای کاهش این خطرات، باید پیام‌واره‌ها و پاسخ‌ها را ازنظر محتوای مخرب یا حملات تزریق پیام‌واره غربال کنید. می‌توانید از Model Armor ارائه‌شده توسط Google استفاده کنید یا می‌توانید از راهکار خودتان استفاده کنید، به‌شرطی که آن را مستند کنید تا کاربران بتوانند آن ریسک را بپذیرند. برای اطلاعات بیشتر، پیکربندی امنیت برای سرورهای MCP در Google Workspace را ببینید.

این روال‌های مطلوب را دنبال کنید:

  • فقط از ابزارهای مورداعتماد استفاده کنید. هرگز سرور MCP‏ Google Chat را به برنامه‌های غیرقابل‌اعتماد یا تأییدنشده متصل نکنید.
  • درخصوص ورودی‌های غیرقابل‌اعتماد احتیاط کنید. از درخواست از کارخواه MCP برای پردازش پیام‌ها یا منابع دیگر از منابع تأییدنشده خودداری کنید. این ورودی‌ها ممکن است حاوی دستورالعمل‌های پنهانی باشند که می‌توانند جلسه شما را بربایند، و به مهاجم اجازه دهند داده‌های شما را تغییر دهد، سرقت کند، یا حذف کند.
  • همه کنش‌ها را مرور کنید. همیشه کنش‌هایی را که مشتری هوش مصنوعی شما ازجانب شما انجام می‌دهد به‌دقت بازبینی کنید تا مطمئن شوید درست هستند و با اهداف شما مطابقت دارند.