قبل‌از شروع، مطمئن شوید موارد زیر را داشته باشید:
سرور MCP مستقرشده با نقطه پایان HTTPS ایمن
سرور MCP شما باید ازطریق HTTPS بااستفاده از انتقال Streamable HTTP (برای مثال،
https://api.yourdomain.com/v1/mcp) به‌طور عمومی دردسترس باشد.برای جزئیات پیاده‌سازی، به راهنمای توسعه‌دهنده سرور MCP پلاتفرم برنامه‌های متصل‌شده مراجعه کنید.
مطمئن شوید سرورتان می‌تواند درخواست‌ها را از Google دریافت کند
اگر سرورتان دسترسی خارجی را براساس IP منبع محدود می‌کند، نشانی‌های IP زیر را در فهرست مجاز قرار دهید:
108.177.64.0/20142.250.88.0/22172.217.80.0/20192.178.20.0/22192.179.0.0/2074.125.232.0/24136.121.40.0/21
محدوده‌های IP برون‌مرزی Google ممکن است درطول زمان تغییر کند، بنابراین توصیه می‌کنیم آن‌ها را از فهرست‌های منتشرشده Google بخوانید و فهرست مجازتان را به‌طور منظم بازآوری کنید:
- واکشی‌های راه‌اندازی‌شده توسط کاربر: https://developers.google.com/static/crawling/ipranges/user-triggered-fetchers-google.json
- عوامل راه‌اندازی‌شده توسط کاربر: https://developers.google.com/static/crawling/ipranges/user-triggered-agents.json
دسترسی به حساب توسعه‌دهنده ثبت‌شده در کنسول یکپارچه Google
پس‌از ورود به سیستم، مطمئن شوید یکی از اجازه‌های «برنامه‌های متصل» زیر را در «کنسول یکپارچه Google» دارید:
- مشاهده «برنامه‌های متصل‌شده»
- ایجاد و مدیریت «برنامه‌های متصل‌شده»
«شروط خدمات برنامه‌های متصل‌شده» نیز باید توسط صاحب حساب یا سرپرست پذیرفته شود. اولین باری که سازمانتان به برنامه‌های متصل‌شده در «کنسول یکپارچه Google» دسترسی پیدا می‌کند، مالک یا سرپرست حساب باید به سیستم وارد شود و قرارداد برنامه را بپذیرد تا اعضای دعوت‌شده تیم بتوانند ادامه دهند.
اگر فکر می‌کنید دسترسی دارید اما نمی‌توانید برنامه متصل‌شده ایجاد کنید، از صاحب حساب یا سرپرستتان بخواهید اجازه «مشاهده برنامه‌های متصل‌شده» یا «ایجاد و مدیریت برنامه‌های متصل‌شده» را در صفحه کاربران و اجازه‌ها به حساب کاربری شما اعطا کند.
امکان میزبانی فایل درستی‌سنجی
.well-knownدر دامنه سرور MCPبرای به‌تأیید رساندن مالکیت دامنه، باید بتوانید فایل JSON کد چالش را مستقیماً (با
HTTP 200 OKو بدون هدایت مجدد) درhttps://<your-domain>/.well-known/google-connected-appsارائه دهید.بازبینی کردن دسته‌های برنامه متصل‌شده دردسترس
دسته برنامه متصل‌شده شما با قابلیت‌های خاصی مرتبط است که باید از آن‌ها پشتیبانی کند تا تجربه کاربری باکیفیتی تضمین شود. پس‌از انتخاب دسته برای برنامه متصل‌شده، نمی‌توان آن را تغییر داد. بیشتر بدانید.
سرور MCP مستقرشده با نشانی وب نقطه پایان معتبر
برای جزئیات بیشتر، به راهنمای توسعه‌دهنده سرور MCP برنامه‌های متصل‌شده مراجعه کنید.
فراداده عمومی و دارایی‌های نمانام برای برنامه متصل‌شده شما
- نام برنامه متصل‌شده: نام نمایشی برنامه متصل‌شده شما که به کاربران در سراسر محصولات Google نشان داده می‌شود و زمانی استفاده می‌شود که کاربران با
@از برنامه شما نام می‌برند. - شرح: خلاصه‌ای مختصر و تک‌جمله‌ای (کمتر از ۳۰ کلمه) از کارهایی که برنامه متصل‌شده شما می‌تواند برای کاربران انجام دهد، مثلاً «خریدهای اخیرتان را پیگیری کنید، وضعیت ارسال را بررسی کنید، و سابقه سفارشتان را مشاهده کنید».
- نماد: نماد برنامه ۵۱۲ پیکسل × ۵۱۲ پیکسل در قالب JPEG یا PNG، با حداکثر اندازه فایل ۱ مگابایت (۱۰۲۴ کیلوبایت).
- قابلیت‌ها: حداقل ۳ تکلیف باارزش که برنامه متصل‌شده شما می‌تواند انجام دهد، مانند «جستجوی سابقه سفارش» یا «بررسی وضعیت ارسال زنده»، علاوه‌بر قابلیت‌های پیش‌فرضی که براساس دسته برنامه‌تان تعریف شده‌اند. این اطلاعات به کاربران نشان داده می‌شود تا به‌کمک آن تصمیم بگیرند برنامه را متصل کنند یا نه. در ابتدای توانمندی‌هایتان عدد قرار ندهید.
- پیام‌واره‌های نمونه: حداقل ۳ پُرسمان نمونه که به کاربران کمک می‌کند متوجه شوند چه سؤالاتی می‌توانند بپرسند. حداقل ۲ پیام‌واره نمونه را با نام برنامه متصل‌شده‌تان شروع کنید. در حداقل ۱ پیام‌واره به‌طور طبیعی از نام برنامه‌تان نام ببرید (یعنی بدون شروع کردن با نام برنامه‌تان). در ابتدای پیام‌واره‌های نمونه‌تان عدد قرار ندهید.
- نشانی وب «شرایط خدمات»: نشانی وب دردسترس عموم برای «شرایط خدمات» برنامه متصل‌شده شما.
- نشانی وب خط‌مشی رازداری: نشانی وب قابل‌دسترس عمومی برای «خط‌مشی رازداری» برنامه متصل‌شده شما.
- نشانی وب‌سایت (اختیاری): وب‌سایتی برای برنامه متصل‌شده شما.
- نام برنامه متصل‌شده: نام نمایشی برنامه متصل‌شده شما که به کاربران در سراسر محصولات Google نشان داده می‌شود و زمانی استفاده می‌شود که کاربران با