«سندنگار» یک سرور راه دور «پروتکل بافتار مدل» (MCP) ارائه میدهد که به عاملهای هوش مصنوعی اجازه میدهد بهطور ایمن با دادههای «سندنگار» تعامل داشته باشند. با پیکربندی سرور MCP «سندنگار»، به برنامههای هوش مصنوعی مثل Google Antigravity و Claude امکان میدهید کنشهایی را در «سندنگار» انجام دهند.
سرور MCP Docs روشی استاندارد برای عاملهای هوش مصنوعی فراهم میکند تا:
- خواندن دادهها: خواندن اطلاعات ساختاری و محتوای نوشتاری سند.
- اقدام کردن: بهروزرسانی سبک و ساختار سند بااستفاده از بهروزرسانیهای دستهای.
- رعایت امنیت: همان اجازهها و کنترلهای حاکمیت داده کاربر را به ارث میبرد.
پیشنیازها
پروژه Google Cloud. برای ایجاد پروژه، ایجاد پروژه را ببینید.
میزبان MCP که یک برنامه هوش مصنوعی مانند Google Antigravity یا Claude است. برنامه هوش مصنوعی برای هر سرور MCP یک اتصال کلاینت MCP ایجاد میکند.
برای اجرای فرمانهای موجود در این صفحه، gcloud CLI را در یکی از محیطهای توسعه نرمافزار زیر راهاندازی کنید:
Cloud Shell
برای استفاده از ترمینال آنلاین با gcloud CLI که قبلاً راهاندازی شده است، Cloud Shell را فعال کنید:
پوسته محلی
برای استفاده از محیط توسعه نرمافزار محلی، این مراحل را دنبال کنید:
- Google Cloud CLI را نصب کنید.
اگر قبلاً gcloud CLI را نصب کردهاید، با اجرای
gcloud components updateمطمئن شوید که جدیدترین نسخه را دارید. - اگر از ارائهدهنده هویت (IdP) خارجی استفاده میکنید، با هویت فدراسیونی خود به سیستم gcloud CLI وارد شوید. برای اطلاعات بیشتر، به ورود به سیستم gcloud CLI با هویت فدراسیونی مراجعه کنید.
- gcloud CLI را مقداردهی اولیه کنید.
- Google Cloud CLI را نصب کنید.
اگر قبلاً gcloud CLI را نصب کردهاید، با اجرای
پیکربندی سرور MCP «سندنگار»
برای استفاده از سرور MCP «سندنگار»، آن را در پروژه Google Cloud خود فعال کنید و برنامه هوش مصنوعیتان را برای اتصال به آن پیکربندی کنید.
فعال کردن میاناهای برنامهسازی کاربردی
برای استفاده از سرور MCP «سندنگار»، میانای برنامهسازی کاربردی زیر را در پروژه Google Cloud خود فعال کنید:
Google Docs API
CLI
gcloud services enable docs.googleapis.com --project=PROJECT_ID
PROJECT_ID
را با شناسه پروژه Google Cloud خودتان جایگزین کنید.
کنسول
میاناهای برنامهسازی کاربردی را در کنسول Google Cloud فعال کنید:
فعال کردن سرویسهای MCP
برای فعال کردن مؤلفههای MCP برای «سندنگار»، سرویس زیر را در پروژه Google Cloud خود فعال کنید:
Docs MCP API
CLI
gcloud services enable docsmcp.googleapis.com --project=PROJECT_ID
PROJECT_ID
را با شناسه پروژه Google Cloud خودتان جایگزین کنید.
کنسول
سرویسهای MCP را در کنسول Google Cloud فعال کنید:
راهاندازی صفحه کسب رضایت OAuth
سرور MCP «سندنگار» از OAuth 2.0 برای اصالتسنجی و مجوزدهی استفاده میکند. قبلاز اینکه بتوانید شناسه کارخواه OAuth ایجاد کنید، باید صفحه کسب رضایت OAuth را پیکربندی کنید.
در کنسول Google Cloud، به پلاتفرم Google Auth > نمانامسازی بروید.
اگر قبلاً پلاتفرم Google Auth را پیکربندی کردهاید، میتوانید تنظیمات «صفحه کسب رضایت OAuth» زیر را در برندسازی، مخاطب، و دسترسی به داده پیکربندی کنید. اگر پیامی دیدید که میگوید پلاتفرم Google Auth هنوز پیکربندی نشده است، روی شروع به کار کلیک کنید:
- در بخش اطلاعات برنامه، در نام برنامه،
Docs MCP Serverرا تایپ کنید. - در ایمیل پشتیبانی کاربر، نشانی ایمیل خودتان یا گروه Google مناسبی را انتخاب کنید.
- روی بعدی کلیک کنید.
- در بخش مخاطبان، داخلی را انتخاب کنید. اگر نمیتوانید داخلی را انتخاب کنید، خارجی را انتخاب کنید.
- روی بعدی کلیک کنید.
- در بخش اطلاعات تماس، نشانی ایمیلی را وارد کنید که بتوانید ازطریق آن از هرگونه تغییر در پروژهتان مطلع شوید.
- روی بعدی کلیک کنید.
- در بخش پایان، خطمشی دادههای کاربر سرویسهای Google API را مرور کنید و اگر موافقید، با «خطمشی دادههای کاربر سرویسهای Google API» موافقم را انتخاب کنید.
- روی ادامه کلیک کنید.
- روی ایجاد کردن کلیک کنید.
- اگر خارجی را برای نوع کاربر انتخاب کردهاید، کاربران آزمایشی را اضافه کنید:
- روی مخاطبان کلیک کنید.
- در بخش کاربران آزمایشی، روی افزودن کاربران کلیک کنید.
- نشانی ایمیل خودتان و هر کاربر آزمایشی مجاز دیگری را وارد کنید، سپس روی ذخیره کلیک کنید.
- در بخش اطلاعات برنامه، در نام برنامه،
روی دسترسی به دادهها > افزودن یا برداشتن دامنهها کلیک کنید. پانلی با فهرستی از دامنهها برای هر میانای برنامهسازی کاربردی که در پروژه Google Cloud فعال کردهاید ظاهر میشود.
در بخش افزودن دستی دامنهها، دامنههای سرور MCP «سندنگار» را جایگذاری کنید:
https://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/documents.readonlyhttps://www.googleapis.com/auth/documents
روی افزودن به جدول کلیک کنید.
روی بهروزرسانی کلیک کنید.
پساز انتخاب کردن دامنههای موردنیاز برنامهتان، در صفحه دسترسی به دادهها، روی ذخیره کلیک کنید.
پیکربندی برنامه هوش مصنوعی
برای افزودن سرور MCP راه دور «سندنگار» به برنامه هوش مصنوعی خود، دستورالعملهای مربوط به برنامهتان را دنبال کنید.
شناسههای کارخواه OAuth 2.0 واگذارشده به کاربر که سرور Docs MCP را فراخوانی میکنند باید از این کارخواه برای عامل مجهز به هوش مصنوعی استفاده شود را در پلاتفرم Google Auth > کارخواهها انتخاب کرده باشند. برای بهروزرسانی شناسه کارخواه OAuth 2.0 موجود، این تنظیم را در پلاتفرم Google Auth > کارخواهها انتخاب کنید، همانطور که در مدیریت کارخواههای OAuth شرح داده شده است. اگر نمیتوانید این تنظیم را در کارخواه موجود تغییر دهید، یا اگر کارخواه از ویژگیهای غیرعامل نیز پشتیبانی میکند، شناسه کارخواه OAuth 2.0 جدیدی برای عامل هوش مصنوعی خود ایجاد کنید. برای درخواستهای ردشده، حسابهای سرویس با واگذاری در سراسر دامنه، یا Google Apps Script، به عیبیابی مراجعه کنید.
Antigravity
برای افزودن سرور MCP راه دور «سندنگار» به 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": { "docs": { "serverUrl": "https://docsmcp.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 نصبشده، روی بازآوری کلیک کنید.
docsرا در فهرست پیدا کنید، روی اصالتسنجی کلیک کنید، به سیستم «حساب Google» خود وارد شوید، کد مجوز را کپی کنید، آن را در کادر گفتگوی ورودی جایگذاری کنید، و روی ارسال کلیک کنید.
برای Antigravity CLI:
شروع کردن Antigravity CLI:
agyبا اجرای دستور زیر، پانل مدیریت تعاملی MCP را باز کنید:
/mcpبااستفاده از کلیدهای جهتنما،
docsرا انتخاب کنید، به کنش اصالتسنجی بروید، و کلید ورود را فشار دهید. جریان ورود به سیستم را در مرورگرتان تکمیل کنید، کد مجوز را کپی کنید، آن را در پیامواره پایانه جایگذاری کنید، و کلید ورود را فشار دهید.
تأیید کنید که سرور بهدرستی پیکربندی شده است و درحال اجرا است:
- برای Antigravity IDE یا GUI: دکمه خروج از سیستم در کنار سرور در بخش سفارشیسازیها > سرورهای MCP نصبشده نمایش داده میشود.
- برای Antigravity CLI: پانل
/mcpرا باز کنید تا سرورهای MCP پیکربندیشدهتان را ببینید. سرورهای درستیسنجیشده و اصالتسنجیشده اصالتسنجیشده را در کنار نامشان در پانل تعاملی TUI نمایش میدهند. میتوانید هر سروری را در نمای داشبورد انتخاب کنید تا وضعیت آن را بررسی کنید و همه ابزارهای دردسترس آن را فهرست کنید.
سرور MCP راه دور برای استفاده در Antigravity آماده است.
Claude
برای استفاده از سرور MCP ازراهدور «سندنگار» با Claude.ai یا Claude Desktop، باید طرح Claude Enterprise، Pro، Max، یا Team داشته باشید.
برای افزودن سرور MCP راه دور «سندنگار» به 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، به تنظیمات > رابطها یا تنظیمات سرپرست > رابطها بروید.
- روی افزودن متصلکننده سفارشی کلیک کنید.
- جزئیات اتصال را برای محصول «سندنگار» وارد کنید:
- نام سرور:
Docs. - نشانی وب سرور MCP راه دور:
https://docsmcp.googleapis.com/mcp/v1
- نام سرور:
- در تنظیمات پیشرفته، شناسه کارخواه OAuth و رمز کارخواه OAuth را وارد کنید.
- روی افزودن کلیک کنید.
موارد دیگر
بسیاری از برنامههای هوش مصنوعی روشهایی برای متصل شدن به سرور MCP ازراهدور دارند. معمولاً باید جزئیات مربوط به سرور را وارد کنید، مانند نام، نقاط پایانی، پروتکل انتقال، و روش اصالتسنجی. برای سرور MCP ازراهدور «سندنگار»، موارد زیر را وارد کنید:
نام سرور:
docsنشانی وب سرور:
https://docsmcp.googleapis.com/mcp/v1انتقال: HTTP قابلجاریسازی
اصالتسنجی: سرور MCP ازراهدور «سندنگار» از OAuth 2.0 استفاده میکند. هنگام ایجاد کارخواه OAuth 2.0، استفاده از این کارخواه برای عامل مجهز به هوش مصنوعی را انتخاب کنید. برای جزئیات، به آشنایی با اصالتسنجی و صدور مجوز مراجعه کنید.
برای جلوگیری از پیاموارههای ورود به سیستم ساعتی با کارخواه OAuth برنامه وب، کارخواه MCP خود را پیکربندی کنید تا بااستفاده از
access_type=offlineیا گسترهoffline_access، دسترسی آفلاین درخواست کند. برای جزئیات بیشتر، پیاموارههای ورود به سیستم ساعتی تکراری را ببینید.
برای جزئیات بیشتر درباره متصل کردن انواع مختلف برنامههای هوش مصنوعی، به پیکربندی MCP در برنامه هوش مصنوعی مراجعه کنید.
آزمایش کردن سرور MCP «سندنگار»
پساز پیکربندی برنامه هوش مصنوعی، میتوانید با اجرای چند پیامواره آزمایشی، اتصال را درستیسنجی کنید.
سؤالات زیر را از برنامه هوش مصنوعی بپرسید:
«محتوای ساختاری سند Google
abcd123را به من نشان بده.»کارخواه ساختار و محتوای سند را بااستفاده از
docs.read_docواکشی میکند.«عنوان «طرح بازاریابی من» را در «سندنگار Google»
abcd123درج کن.»کارخواه
docs.update_docرا برای بهروزرسانی عناصر ساختاری و درج نوشتار انجام میدهد.
اگر ابزارها با موفقیت اجرا شوند و پاسخهای مرتبط دریافت کنید، سرور MCP «سندنگار» شما بهدرستی پیکربندی شده است.
عیبیابی
برای حل مشکلات رایج اصالتسنجی و اتصال با سرور MCP «سندنگار»، از بخشهای زیر استفاده کنید.
بررسی رویدادهای گزارش OAuth
اگر در اتصال به سرور MCP با مشکل مواجه شدید، گزارشهای OAuth را برای یافتن خطا بررسی کنید. از سرپرست Google Workspace خود بخواهید رویدادهای ثبتشده OAuth را در ابزار بررسی امنیتی بازبینی کند.
درخواستهای ردشده از کارخواههای OAuth واگذارشده به کاربر
اگر درخواستهای شما به سرور MCP رد میشود، مطمئن شوید که شناسه کارخواه OAuth 2.0 واگذارشده به کاربر برای جریان OAuth سهطرفه شما، گزینه از این کارخواه برای نماینده مجهز به هوش مصنوعی استفاده شود را در پلاتفرم اصالتسنجی Google > کارخواهها انتخاب کرده باشد:
- کارخواه موجود از این تنظیم پشتیبانی میکند: استفاده از این کارخواه برای عامل مجهز به هوش مصنوعی را در کارخواه 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 در Google Workspace را فراخوانی نمیکنند تحتتأثیر قرار نمیگیرند.
پیاموارههای ورود به سیستم ساعتی تکراری
اگر تقریباً هر ساعت از شما خواسته میشود دوباره به سیستم وارد شوید، کارخواه 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 «سندنگار» دردسترس است. برای طرحوارههای ورودی و خروجی، به مرجع MCP سندنگار مراجعه کنید:
ملاحظه امنیتی مهم: تزریق پیامواره غیرمستقیم
وقتی مدل زبانی را درمعرض دادههای غیرقابلاعتماد قرار میدهید، خطر حمله تزریق پیامواره غیرمستقیم وجود دارد. چون برنامههای کاربردی هوش مصنوعی مثل Google Antigravity ازطریق سرور MCP «سندنگار» به ابزارها و میاناهای برنامهسازی کاربردی قدرتمند دسترسی دارند، میتوانند دادههای «حساب Google» شما را بخوانند، اصلاح کنند، و حذف کنند.
برای کاهش این خطرات، باید پیاموارهها و پاسخها را ازنظر محتوای مخرب یا حملات تزریق پیامواره غربال کنید. میتوانید از Model Armor ارائهشده توسط Google استفاده کنید، یا میتوانید از راهکار خودتان استفاده کنید، بهشرطی که آن را مستند کنید تا کاربران بتوانند آن خطر را بپذیرند. برای دریافت دستورالعملها، به پیکربندی امنیت برای سرورهای «پروتکل زمینهای مدل» Google Workspace مراجعه کنید.
این روالهای مطلوب را دنبال کنید:
- فقط از ابزارهای مورداعتماد استفاده کنید. هرگز سرور MCP «سندنگار» را به برنامههای غیرقابلاعتماد یا تأییدنشده متصل نکنید.
- دربرابر ورودیهای غیرقابلاعتماد احتیاط کنید. از برنامه هوش مصنوعی خود نخواهید که اسناد یا منابع دیگر را از منابع تأییدنشده پردازش کند. این ورودیها ممکن است حاوی دستورالعملهای پنهانی باشند که میتوانند جلسه شما را بربایند و به مهاجم اجازه دهند دادههایتان را تغییر دهد، بهسرقت ببرد، یا حذف کند.
- همه کنشها را مرور کنید. همیشه کنشهایی را که برنامه هوش مصنوعی ازجانب شما انجام میدهد بهدقت بازبینی کنید تا مطمئن شوید که دقیق هستند و با اهداف شما مطابقت دارند.