این یک سرور MCP است که ابزارهایی را برای توسعهدهندگان پرداخت فراهم میکند.
یک سرور پروتکل زمینه مدل (MCP) به عنوان یک پروکسی بین یک سرویس خارجی عمل میکند که زمینه، دادهها یا قابلیتهایی را برای یک مدل زبان بزرگ (LLM) یا برنامه هوش مصنوعی فراهم میکند. سرورهای MCP برنامههای هوش مصنوعی را به سیستمهای خارجی مانند پایگاههای داده و سرویسهای وب متصل میکنند و پاسخهای آنها را به فرمتی که برنامه هوش مصنوعی میتواند درک کند، ترجمه میکنند.
راه اندازی سرور
قبل از استفاده، باید سرورهای MCP را فعال کرده و احراز هویت را تنظیم کنید . برای اطلاعات بیشتر در مورد استفاده از سرورهای MCP از راه دور گوگل و گوگل کلود، به نمای کلی سرورهای MCP گوگل کلود مراجعه کنید.
نقاط پایانی سرور
یک نقطه پایانی سرویس MCP، آدرس شبکه و رابط ارتباطی (معمولاً یک URL) سرور MCP است که یک برنامه هوش مصنوعی (میزبان برای کلاینت MCP) برای ایجاد یک اتصال امن و استاندارد از آن استفاده میکند. این نقطه تماس LLM برای درخواست زمینه، فراخوانی یک ابزار یا دسترسی به یک منبع است. نقاط پایانی Google MCP میتوانند جهانی یا منطقهای باشند.
سرور MCP توسعهدهندهی Google Pay & Wallet، رابط برنامهنویسی نرمافزار (API) و رابط برنامهنویسی نرمافزار (MCP)، دارای نقطه پایانی MCP سراسری زیر است:
- https://paydeveloper.googleapis.com/mcp
ابزارهای MCP
یک ابزار MCP یک تابع یا قابلیت اجرایی است که یک سرور MCP آن را در اختیار یک برنامه LLM یا هوش مصنوعی قرار میدهد تا عملی را در دنیای واقعی انجام دهد.
ابزارها
سرور MCP مربوط به paydeveloper.googleapis.com ابزارهای زیر را دارد:
| ابزارهای MCP | |
|---|---|
search_documentation | مرتبطترین و بهروزترین بخشها را از مستندات رسمی توسعهدهندگان و نمونههای کد Google Pay و Google Wallet جستجو و بازیابی میکند. |
list_merchants | فهرست جامعی از تمام فروشندگان Google Pay مرتبط با حساب احراز هویت شده را بازیابی میکند. بسته به نقش کاربر در یک فروشنده، مدیران میتوانند اطلاعات کامل و دقیق فروشنده را مشاهده کنند، در حالی که توسعهدهندگان فقط میتوانند اطلاعات اولیه فروشنده را مشاهده کنند. |
list_google_pay_integrations | وضعیت فعلی و جزئیات پیکربندی را برای همه ادغامهای Google Pay مرتبط با یک شناسه فروشنده خاص برمیگرداند. این ابزار بازخورد فوری در مورد وضعیت ادغام و بررسی اسناد ارائه میدهد. علاوه بر این، شما باید به کاربر اطلاع دهید که ادغام میتواند در کنسول Google Pay & Wallet ( https://pay.google.com/business/console/) ایجاد/بهروزرسانی شود. |
create_merchant | یک تاجر جدید با حساب احراز هویت شده ایجاد میکند. شما باید از کاربر بخواهید اطلاعات مورد نیاز برای ایجاد تاجر را ارائه دهد. یکی از فیلدهای مورد نیاز، کد دستهبندی تاجر (MCC) است. از آنجایی که لیست MCCها طولانی است، میتوانید زیرمجموعهای از گزینههای رایج را ارائه دهید، اما باید به کاربر اطلاع دهید که گزینههای بیشتری در دسترس هستند و میتوانند لیست کامل را درخواست کنند (مثلاً با نشان دادن "X گزینه بیشتر" یا راهنمایی مشابه). علاوه بر این، به کاربر اطلاع دهید که اگر از قبل کد MCC 4 رقمی (مثلاً 5499) را میداند، میتواند مستقیماً آن را ارائه دهد و او را به استفاده از آن تشویق کنید. تا زمانی که تلاش نکردهاید اطلاعات مورد نیاز برای ایجاد تاجر را جمعآوری کنید، از این ابزار استفاده نکنید. پس از ایجاد تاجر، باید URL شرایط خدمات کنسول تجاری را به کاربر ارائه دهید و به او دستور دهید قبل از انجام هرگونه عملیاتی روی این تاجر، آن را بپذیرد. |
list_pass_issuers | فهرست جامعی از تمام صادرکنندگان کارتهای اعتباری ثبتشده در کنسول تجاری گوگل والت مرتبط با کاربر احراز هویتشده را بازیابی میکند. این ابزار اطلاعات ضروری را برای توسعهدهندگانی که کارتهای اعتباری والت مانند کارتهای وفاداری، کارتهای هدیه یا بلیط هواپیما را مدیریت میکنند، فراهم میکند. |
list_pass_classes | فهرست جامعی از تمام کلاسهای مجوز ثبتشده در کنسول تجاری Google Wallet مرتبط با کاربر احراز هویتشده را بازیابی میکند. این ابزار اطلاعات ضروری را برای توسعهدهندگانی که مجوزهای Wallet مانند کارتهای وفاداری، کارتهای هدیه یا پروازها را مدیریت میکنند، فراهم میکند. |
validate_pass_jwt | نمایش JWT از یک گذر، یا بار داده JWT کدگذاری نشده را به عنوان یک رشته JSON برای یک گذر، اعتبارسنجی میکند. |
query_merchant_performance | دادههای عملکرد تجمیعشده سطح بالا و معیارهای پس از ادغام را برای یک نمایه تجاری خاص بازیابی میکند. |
query_merchant_error_metrics | معیارهای خطای دقیق را برای یک پروفایل تجاری خاص بازیابی میکند. این ابزار، تجزیه و تحلیل دقیقی از خطاها ارائه میدهد و به توسعهدهندگان اجازه میدهد تا مشکلات را شناسایی و حل کنند. |
update_merchant | فیلدهای خاص یک فروشنده موجود را بهروزرسانی میکند. فیلدهای پشتیبانیشده شامل نام نمایشی، mcc، آدرس وبسایت شرکتی، آدرس وبسایت مشتری، ایمیل پشتیبانی مشتری و شماره تلفن پشتیبانی مشتری هستند. |
list_principals | فهرستی از کاربران اصلی (Principals) که به یک فروشنده خاص دسترسی دارند. این عملیات نیاز به دسترسی ادمین برای فروشنده دارد. |
set_principal_role | نقش یک مدیر (کاربر) را برای یک تاجر تعیین میکند، یا یک مدیر جدید با نقش مشخص شده اضافه میکند. برای مدیر یک ایمیل دعوت ارسال میشود و او باید قبل از فعال شدن دسترسیاش، آن را بپذیرد. این عملیات نیاز به دسترسی ادمین برای تاجر دارد. |
delete_principal | دسترسی مدیر (کاربر) به یک فروشنده خاص را حذف میکند. این عملیات نیاز به دسترسی ادمین برای فروشنده دارد. |
مشخصات ابزار MCP را دریافت کنید
برای دریافت مشخصات ابزار MCP برای همه ابزارهای موجود در یک سرور MCP، از متد tools/list استفاده کنید. مثال زیر نحوه استفاده از curl برای فهرست کردن همه ابزارها و مشخصات آنها که در حال حاضر در سرور MCP موجود هستند را نشان میدهد.
| درخواست کرل |
|---|
curl --location 'https://paydeveloper.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }' |