‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

به سرور MCP توسعه‌دهندگان «کیف پول» و Google Pay متصل شوید

سرور Google Pay & Wallet Developer MCP به ابزارهای توسعه با بهره‌گیری از هوش مصنوعی امکان می‌دهد به داده‌های توسعه‌دهنده Google Pay و «کیف پول Google» دسترسی داشته باشند، اسناد رسمی را جستجو کنند، و یکپارچه‌سازی‌هایتان را مدیریت کنند.

استاندارد پروتکل زمینه‌ای مدل (MCP) نحوه اتصال مدل‌های زبانی بزرگ (LLM) و برنامه‌ها یا عامل‌های هوش مصنوعی به منابع داده خارجی را استانداردسازی می‌کند. سرورهای MCP به شما امکان می‌دهند از ابزارها، منابع، و پیام‌واره‌های آن‌ها برای انجام کنش‌ها و دریافت داده‌های به‌روز از سرویس زیرین آن‌ها استفاده کنید.

سرور MCP توسعه‌دهنده «کیف پول» و Google Pay به شما امکان می‌دهد:

جستجوی اسناد: راهنمایی‌های به‌روز و نمونه‌های کد را از اسناد رسمی Google Pay و «کیف پول Google» دریافت کنید.
مدیریت یکپارچه‌سازی‌ها: وضعیت یکپارچه‌سازی‌هایتان را بررسی کنید و میاناهای برنامه‌سازی کاربردی را برای حساب فروشنده‌تان فعال کنید.
پایش عملکرد: به داده‌های عملکرد تجمیعی و سنجه‌های خطای حساب فروشنده‌تان دسترسی پیدا کنید.
مدیریت مجوزها: فهرست صادرکنندگان مجوز و کلاس‌ها برای «کیف پول Google».

توجه: برای مشاهده جزئیات ابزارهای MCP دردسترس و توضیحات آن‌ها، به مرجع «توسعه‌دهنده کیف پول و پرداخت» مراجعه کنید.

پیام‌واره‌های نمونه

می‌توانید از پیام‌واره‌های زیر با دستیار هوشواره‌ای خود استفاده کنید:

«حساب‌های Google Pay من را فهرست کن.»
«وضعیت ادغام‌های Google Pay من چیست؟»
«چگونه می‌توانم Google Pay را با React ادغام کنم؟»
«سنجه‌های خطای Google Pay را برای یکپارچه‌سازی من در ۳۰ روز گذشته نشان بده.»
«فهرست کلاس‌های مجوز «کیف پول Google» من را نشان بده.»

قبل‌از شروع

برای استفاده از سرور Google Pay و Wallet Developer MCP، باید پروژه Google Cloud ایجاد کنید و سرور Google Pay و Wallet Developer MCP را فعال کنید.

در کنسول Cloud، در صفحه انتخابگر پروژه، پروژه Google Cloud را انتخاب یا ایجاد کنید.

رفتن به انتخابگر پروژه
اگر «میانای برنامه‌سازی کاربردی توسعه‌دهندگان Pay و کیف پول» ازقبل فعال نیست، آن را فعال کنید.
نقش‌های لازم برای فعال کردن میاناهای برنامه‌سازی کاربردی
برای فعال کردن «میاناهای برنامه‌سازی کاربردی»، به اجازه serviceusage.services.enable نیاز دارید. اگر پروژه را ایجاد کرده‌اید، احتمالاً ازقبل این اجازه را ازطریق نقش «مالک» (roles/owner) دارید. درغیراین‌صورت، می‌توانید این اجازه را ازطریق نقش «سرپرست استفاده از سرویس» (roles/serviceusage.serviceUsageAdmin) دریافت کنید. با نحوه اعطای نقش‌ها آشنا شوید.
فعال کردن میانای برنامه‌سازی کاربردی

اصالت‌سنجی و مجوز

سرور Google Pay & Wallet Developer MCP از پروتکل OAuth 2.0 با مدیریت هویت و دسترسی‌ها (IAM) برای اصالت‌سنجی و صدور مجوز استفاده می‌کند. همه هویت‌ها برای اصالت‌سنجی در سرورهای MCP پشتیبانی می‌شوند.

سرور MCP «توسعه‌دهنده کیف پول و Google Pay» کلیدهای API را نمی‌پذیرد.

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

حوزه‌های OAuth سرور MCP توسعه‌دهنده «کیف پول Google» و Google Pay

‫OAuth 2.0 از محدوده‌ها و اطلاعات اعتباری برای تعیین اینکه آیا یک عامل اصالت‌سنجی‌شده برای انجام کنش خاصی روی یک منبع مجاز است یا نه استفاده می‌کند. برای اطلاعات بیشتر درباره محدوده‌های OAuth 2.0 در Google، استفاده از OAuth 2.0 برای دسترسی به میاناهای برنامه‌سازی کاربردی Google را بخوانید.

سرور MCP «توسعه‌دهنده Google Pay و کیف پول» دارای دامنه‌های OAuth ابزار MCP زیر است:

دامنه URI برای gcloud CLI	شرح
`https://www.googleapis.com/auth/paydeveloper.merchant`	داده‌های فروشنده Google Pay را مدیریت کنید.
`https://www.googleapis.com/auth/paydeveloper.issuer.readonly`	داده‌های صادرکننده «کیف پول Google» را بخواند.

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

برای ایجاد شناسه و رمز کارخواه OAuth 2.0، این مراحل را دنبال کنید:

در «کنسول Google API»، به پلاتفرم Google Auth > کارخواه‌ها > ایجاد کارخواه بروید.

رفتن به «ایجاد مشتری»

اگر هنوز برنامه جدیدی در «پلاتفرم Google Auth» ایجاد نکرده‌اید، باید برنامه جدیدی ایجاد کنید. روی دکمه «شروع به کار» در صفحه نمای کلی کلیک کنید و اطلاعات لازم را تکمیل کنید.
در فهرست نوع برنامه، نوع مناسب را برای برنامه هوش مصنوعی خود انتخاب کنید:
- برای Cursor Desktop،‏ Claude Code،‏ Claude.ai،‏ ChatGPT، و Antigravity،‏ کاربرد وب را انتخاب کنید.
- برای Antigravity CLI، Antigravity IDE، و VS Code، برنامه رایانه را انتخاب کنید.
در فیلد نام، نامی برای برنامه‌تان وارد کنید.
اگر برنامه وب را انتخاب کردید، در بخش نشانی‌های وب هدایت مجاز، روی + افزودن نشانی وب کلیک کنید، و سپس نشانی وب هدایتگر موردنیاز را برای برنامه هوش مصنوعی خود اضافه کنید:
مکان‌نمای میز کار

http://localhost:8787/callback
کد Claude
http://localhost:CLAUDE_REDIRECT_PORT/callback
Claude.ai

https://claude.ai/api/mcp/auth_callback

ChatGPT

می‌توانید redirect_uri را فعلاً خالی بگذارید. وقتی برنامه ایجاد می‌شود، ChatGPT یک redirect_uri تولید می‌کند (پیکربندی برنامه هوش مصنوعی در زیر را ببینید).

توجه: در بخش مبدأهای مجاز جاوا اسکریپت، روی + افزودن نشانی وب کلیک کنید، و سپس https://chatgpt.com را در فیلد نشانی‌های وب اضافه کنید.

Antigravity

https://antigravity.google/oauth-callback
روی ایجاد کردن کلیک کنید. پس‌از ایجاد، رمز کارخواه یک‌بار نمایش داده می‌شود. آن را کپی کنید و به‌طور ایمن ذخیره کنید.

پیکربندی برنامه هوش مصنوعی

سپس باید جزئیات پیکربندی سرور را به برنامه هوش مصنوعی خود ارائه دهید.

VS Code

روی نماد در بالای پانل کناری گپ کلیک کنید و به سرورهای MCP پیمایش کنید.
روی دکمه افزودن سرور (add) کلیک کنید، HTTP را انتخاب کنید و نشانی وب اشاره‌کننده به سرور MCP «توسعه‌دهنده Pay و «کیف پول» را وارد کنید: https://paydeveloper.googleapis.com/mcp.
پیکربندی MCP شما در فایل .vscode/mcp.json در فضای کاری‌تان ذخیره شده است:
```
{
  "servers": {
    "google-pay-wallet-dev": {
      "url": "https://paydeveloper.googleapis.com/mcp"
    }
  }
}
```
روی سرور MCP جدید کلیک راست کنید و شروع سرور را انتخاب کنید.
به پنجره گپ برگردید و ابزاری را در سرور MCP فراخوانی کنید تا فرایند اصالت‌سنجی را راه‌اندازی کنید. برای مثال: «فهرست حساب‌های Google Pay من».
کادر گفتگوی Dynamic Client Registration (ثبت کارخواه پویا) پشتیبانی نمی‌شود طبق انتظار باز می‌شود. برای بستن کادر گفتگو، روی هر دکمه‌ای کلیک کنید.
شناسه کارخواه OAuth خود را وارد کنید و کلید Enter را فشار دهید.
وقتی از شما خواسته شد، رمز کارخواه OAuth را وارد کنید و کلید Enter را فشار دهید.
کادر گفتگویی برای اصالت‌سنجی باز می‌شود، روی اجازه دادن کلیک کنید.
می‌توانید از فهرستی از هویت‌های اصالت‌سنجی‌شده انتخاب کنید یا با حساب جدیدی به سیستم وارد شوید.
پس‌از اصالت‌سنجی، ابزار فراخوانده می‌شود و جلسه در پنجره گپ ادامه می‌یابد.

مکان‌نمای میز کار

برای پیکربندی «میز کار مکان‌نما»:

روی سفارشی‌سازی در پانل سمت راست کلیک کنید.
روی سرور MCP جدید کلیک کنید. با این کار، فایل پیکربندی mcp.json باز می‌شود.

برای افزودن سرور MCP «توسعه‌دهنده کیف پول Google و Google Pay»، جزئیات پیکربندی را وارد کنید:

{
  "mcpServers": {
    "google-pay-wallet-dev": {
      "url": "https://paydeveloper.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "CURSOR_DESKTOP_CLIENT_ID",
        "CLIENT_SECRET": "CURSOR_DESKTOP_CLIENT_SECRET"
      }
    }
  }
}

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

کد Claude

برای پیکربندی Claude Code، فرمان زیر را اجرا کنید:

MCP_CLIENT_SECRET=CLAUDE_CODE_CLIENT_SECRET claude mcp add --transport http \
  --client-id CLAUDE_CODE_CLIENT_ID --client-secret --callback-port CLAUDE_REDIRECT_PORT \
  google-pay-wallet-dev https://paydeveloper.googleapis.com/mcp

Claude.ai

برای پیکربندی Claude.ai:

به سفارشی‌سازی > رابط‌ها بروید.
روی افزودن کلیک کنید و افزودن اتصال‌دهنده سفارشی را انتخاب کنید.
جزئیات زیر را وارد کنید:
در تنظیمات پیشرفته، شناسه کارخواه OAuth و رمز کارخواه OAuth را وارد کنید.
اتصال‌دهنده جدید را انتخاب کنید و روی اتصال کلیک کنید.

ChatGPT

برای پیکربندی ChatGPT:

حالت توسعه‌دهنده را از تنظیمات > امنیت و ورود به سیستم فعال کنید.
در پانل کناری اصلی، افزایه‌ها را انتخاب کنید و روی دکمه کلیک کنید.
جزئیات زیر را وارد کنید:
به تنظیمات پیشرفته بروید و رمز کارخواه و شناسه کارخواه OAuth را وارد کنید.
نشانی وب تماس برگشتی پویا را کپی کنید و آن را به کارخواه OAuth که در مرحله قبلی ایجاد شده است اضافه کنید.

Antigravity CLI

برای پیکربندی Antigravity CLI، موارد زیر را به ~/.gemini/config/mcp_config.json فایل اضافه کنید:

{
  "mcpServers": {
    "google-pay-wallet-dev": {
      "serverUrl": "https://paydeveloper.googleapis.com/mcp",
      "oauth": {
        "clientId": "AGY_CLI_CLIENT_ID",
        "clientSecret": "AGY_CLI_CLIENT_SECRET"
      }
    }
  }
}

/mcp را اجرا کنید، سرور MCP جدیدتان را انتخاب کنید، و برای شروع فرایند اصالت‌سنجی، اصالت‌سنجی را انتخاب کنید.

Antigravity IDE

روی در بالای پانل کناری عامل ویرایشگر کلیک کنید و سرورهای MCP را انتخاب کنید.
روی مدیریت سرورهای MCP کلیک کنید.

روی مشاهده پیکربندی خام کلیک کنید و جزئیات سرور MCP خود را اضافه کنید:

{
  "mcpServers": {
    "google-pay-wallet-dev": {
      "serverUrl": "https://paydeveloper.googleapis.com/mcp",
      "oauth": {
        "clientId": "ANTIGRAVITY_IDE_CLIENT_ID",
        "clientSecret": "ANTIGRAVITY_IDE_CLIENT_SECRET"
      }
    }
  }
}

به Antigravity IDE برگردید و روی بازآوری کلیک کنید.
سرور MCP جدیدتان را انتخاب کنید و روی اصالت‌سنجی کلیک کنید و جریان اصالت‌سنجی را تکمیل کنید.
کد مجوز را کپی کنید و آن را در پنجره تنظیمات Antigravity ارسال کنید.

Antigravity

در «ضدجاذبه»، به تنظیمات > سفارشی‌سازی‌ها بروید.

در بخش سرورهای MCP نصب‌شده، روی باز کردن پیکربندی MCP کلیک کنید تا فایل mcp_config.json را ویرایش کنید:

{
  "mcpServers": {
    "google-pay-wallet-dev": {
      "serverUrl": "https://paydeveloper.googleapis.com/mcp",
      "oauth": {
        "clientId": "ANTIGRAVITY_CLIENT_ID",
        "clientSecret": "ANTIGRAVITY_CLIENT_SECRET"
      }
    }
  }
}

به Antigravity برگردید و روی بازآوری کلیک کنید.
روی اصالت‌سنجی کلیک کنید و جریان اصالت‌سنجی را تکمیل کنید.
کد مجوز را کپی کنید و آن را در پنجره تنظیمات Antigravity ارسال کنید.

محدودیت‌های شناخته‌شده

نتایج فقط به زبان انگلیسی: جستجوی اسناد فقط از زبان انگلیسی پشتیبانی می‌کند.
محتوای پشت ACL: اسناد پشت ACL فهرست‌بندی نمی‌شود
وابسته به شبکه: سرور به اتصال زنده به سرویس‌های «کیف پول» و Google Pay نیاز دارد.

شروط خدمات

استفاده از Google Pay API مشمول شرایط خدمات Google Pay API است. استفاده از «میانای برنامه‌سازی کاربردی کیف پول Google» تابع شرایط خدمات «میانای برنامه‌سازی کاربردی کیف پول Google» است.

به سرور MCP توسعه‌دهندگان «کیف پول» و Google Pay متصل شوید با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

پیام‌واره‌های نمونه

قبل‌از شروع

اصالت‌سنجی و مجوز

حوزه‌های OAuth سرور MCP توسعه‌دهنده «کیف پول Google» و Google Pay

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

مکان‌نمای میز کار

کد Claude

Claude.ai

ChatGPT

Antigravity

پیکربندی برنامه هوش مصنوعی

VS Code

مکان‌نمای میز کار

کد Claude

Claude.ai

ChatGPT

Antigravity CLI

Antigravity IDE

Antigravity

محدودیت‌های شناخته‌شده

شروط خدمات

به سرور MCP توسعه‌دهندگان «کیف پول» و Google Pay متصل شوید