پیکربندی سرور اسلایدها MCP

گوگل اسلایدز یک سرور پروتکل زمینه مدل (MCP) از راه دور ارائه می‌دهد که به عوامل هوش مصنوعی اجازه می‌دهد تا به طور ایمن با داده‌های گوگل اسلایدز تعامل داشته باشند. با پیکربندی سرور MCP گوگل اسلایدز، برنامه‌های هوش مصنوعی مانند گوگل آنتی‌گراویتی و کلود را قادر می‌سازید تا در گوگل اسلایدز اقداماتی را انجام دهند.

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

  • خواندن داده‌ها : ساختارها، سبک‌ها و طرح‌بندی‌های ارائه شفاهی را بخوانید.
  • اقدام کنید : طرح‌بندی‌ها، اسلایدها، عناصر را تغییر دهید و به‌روزرسانی‌های دسته‌ای ساختاری بصری را اجرا کنید.
  • به امنیت احترام بگذارید : همان مجوزها و کنترل‌های مدیریت داده‌ها را به عنوان کاربر به ارث ببرید.

پیش‌نیازها

پیکربندی سرور MCP گوگل اسلایدز

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

فعال کردن APIها

برای استفاده از سرور MCP گوگل اسلایدز، باید API زیر را در پروژه گوگل کلود خود فعال کنید:

  • رابط برنامه‌نویسی کاربردی گوگل اسلایدز

رابط خط فرمان 

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

به جای PROJECT_ID ، شناسه پروژه گوگل کلود خود را وارد کنید.

کنسول

فعال کردن APIها در کنسول Google Cloud:

فعال کردن APIها

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

برای فعال کردن اجزای MCP برای اسلایدهای گوگل، باید سرویس زیر را در پروژه گوگل کلود خود فعال کنید:

  • رابط برنامه‌نویسی کاربردی MCP اسلایدهای گوگل

رابط خط فرمان 

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

به جای PROJECT_ID ، شناسه پروژه گوگل کلود خود را وارد کنید.

کنسول

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

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

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

  1. در کنسول گوگل کلود، به مسیر Google Auth Platform > Branding بروید.

    به بخش برندسازی بروید

  2. اگر قبلاً پلتفرم احراز هویت گوگل (Google Auth Platform) را پیکربندی کرده‌اید، می‌توانید تنظیمات زیر را برای صفحه رضایت OAuth در بخش‌های Branding ، Audience و Data Access پیکربندی کنید. اگر پیامی مبنی بر اینکه پلتفرم احراز هویت گوگل هنوز پیکربندی نشده است مشاهده کردید، روی Get Started کلیک کنید:

    1. در قسمت اطلاعات برنامه ، در قسمت نام برنامه ، عبارت Slides MCP Server تایپ کنید.
    2. در ایمیل پشتیبانی کاربر ، آدرس ایمیل خود یا یک گروه گوگل مناسب را انتخاب کنید.
    3. روی بعدی کلیک کنید.
    4. در قسمت مخاطبان ، گزینه داخلی (Internal) را انتخاب کنید. اگر نمی‌توانید داخلی (Internal) را انتخاب کنید، خارجی (External) را انتخاب کنید.
    5. روی بعدی کلیک کنید.
    6. در قسمت اطلاعات تماس ، یک آدرس ایمیل وارد کنید که از طریق آن بتوانید از هرگونه تغییر در پروژه خود مطلع شوید.
    7. روی بعدی کلیک کنید.
    8. در قسمت Finish ، سیاست داده‌های کاربر سرویس‌های API گوگل را مرور کنید و در صورت موافقت، گزینه «من با سیاست‌های داده‌های کاربر سرویس‌های API گوگل موافقم» را انتخاب کنید.
    9. روی ادامه کلیک کنید.
    10. روی ایجاد کلیک کنید.
    11. اگر نوع کاربر را External انتخاب کرده‌اید، کاربران آزمایشی را اضافه کنید:
      1. روی مخاطب کلیک کنید.
      2. در قسمت کاربران آزمایشی ، روی افزودن کاربران کلیک کنید.
      3. آدرس ایمیل خود و سایر کاربران آزمایشی مجاز را وارد کنید، سپس روی ذخیره کلیک کنید.

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

    1. در قسمت «افزودن دستی محدوده‌ها» ، محدوده‌های مربوط به سرور MCP گوگل اسلایدز را وارد کنید:

      • https://www.googleapis.com/auth/drive.readonly
      • https://www.googleapis.com/auth/presentations.readonly

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

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

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

کلاینت MCP خود را پیکربندی کنید

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

ضد جاذبه

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

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

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

      به ایجاد مشتری بروید

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

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

    4. در بخش Authorized redirect URIs ، روی + Add URI کلیک کنید و سپس https://antigravity.google/oauth-callback در فیلد URIs اضافه کنید.

    5. روی «ایجاد» کلیک کنید و شناسه کلاینت و رمز کلاینت خود را کپی کنید.

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

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

    {
  "mcpServers": {
    "slides": {
      "serverUrl": "https://slidesmcp.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 احراز هویت کنید:

    • برای محیط برنامه‌نویسی یا رابط کاربری گرافیکی آنتی‌گراویتی (آنتی‌گراویتی ۲.۰):

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

    • برای رابط خط فرمان ضد جاذبه:

      1. شروع رابط خط فرمان آنتی‌گراویتی:

        agy

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

        /mcp

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

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

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

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

کلود

برای استفاده از سرور MCP از راه دور گوگل اسلایدز با Claude.ai یا Claude Desktop، باید پلن‌های Claude Enterprise، Pro، Max یا Team را داشته باشید.

برای افزودن سرور MCP از راه دور Google Slides به Claude، یک کانکتور سفارشی با شناسه و رمز کلاینت OAuth پیکربندی کنید.

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

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

      به ایجاد مشتری بروید

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

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

    4. در بخش Authorized redirect URIs ، روی + Add URI کلیک کنید و سپس https://claude.ai/api/mcp/auth_callback را در فیلد URIs اضافه کنید.

    5. روی «ایجاد» کلیک کنید و شناسه کلاینت و رمز کلاینت خود را کپی کنید.

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

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

دیگران

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

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

سرور MCP گوگل اسلایدز را آزمایش کنید

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

سعی کنید از مشتری MCP خود سوالات زیر را بپرسید:

  • «طرح‌بندی شفاهی ارائه abcd123 در گوگل اسلاید را به من نشان بده.»

    کلاینت با استفاده از slides.read_presentation ساختارهای طرح‌بندی بصری ارائه را دریافت می‌کند.

  • "در ارائه abcd123 گوگل اسلاید، فهرست اسلاید ۱ کپی شده است."

    کلاینت برای کپی کردن صفحه، slides.update_presentation را اجرا می‌کند.

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

عیب‌یابی

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

مرجع ابزار

ابزارهای زیر برای سرور MCP گوگل اسلایدز در دسترس هستند:

  • read_presentation
  • update_presentation

نکته امنیتی مهم: تزریق غیرمستقیم و سریع

وقتی یک مدل زبانی را در معرض داده‌های غیرقابل اعتماد قرار می‌دهید، خطر حمله تزریق غیرمستقیم کد (prompt injection) وجود دارد. از آنجا که کلاینت‌های MCP مانند Google Antigravity از طریق سرور Google Slides MCP به ابزارها و APIهای قدرتمندی دسترسی دارند، می‌توانند داده‌های حساب گوگل شما را بخوانند، تغییر دهند و حذف کنند.

برای کاهش این خطرات، این بهترین شیوه‌ها را دنبال کنید:

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