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

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

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

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

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

  • مدیریت مجوزها: فهرست صادرکنندگان مجوز و کلاس‌ها برای «کیف پول Google».

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

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

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

قبل‌از شروع

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

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

    رفتن به انتخابگر پروژه

  2. Pay & Wallet Developer API را فعال کنید (اگر ازقبل فعال نشده است).

    نقش‌های لازم برای فعال کردن میاناهای برنامه‌سازی کاربردی

    برای فعال کردن «میاناهای برنامه‌سازی کاربردی»، به اجازه 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 APIs را بخوانید.

سرور 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، این مراحل را دنبال کنید:

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

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

  2. در فهرست نوع برنامه، نوع مناسب را برای برنامه هوش مصنوعی خود انتخاب کنید:

    • برای Cursor Desktop،‏ Claude Code،‏ Claude.ai،‏ ChatGPT، و Antigravity،‏ کاربرد وب را انتخاب کنید.
    • برای Antigravity CLI،‏ Antigravity IDE، و VS Code، برنامه رایانه‌ای را انتخاب کنید.

  3. در فیلد نام، نامی برای برنامه‌تان وارد کنید.

  4. اگر برنامه وب را انتخاب کردید، در بخش نشانی‌های وب هدایت مجاز، روی + افزودن نشانی وب کلیک کنید، و سپس نشانی وب هدایتگر موردنیاز را برای برنامه هوش مصنوعی خود اضافه کنید:

    Cursor Desktop

    http://localhost:8787/callback

    Claude Code

    http://localhost:CLAUDE_REDIRECT_PORT/callback

    Claude.ai

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

    ChatGPT

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

    Antigravity

    https://antigravity.google/oauth-callback

  5. روی ایجاد کردن کلیک کنید. پس‌از ایجاد، رمز کارخواه یک‌بار نمایش داده می‌شود. آن را کپی کنید و در جایی امن ذخیره کنید.

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

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

VS Code

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

Cursor Desktop

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

  1. روی سفارشی‌سازی در پانل کناری سمت راست کلیک کنید.
  2. روی سرور MCP جدید کلیک کنید. با این کار، فایل پیکربندی mcp.json باز می‌شود.
  3. جزئیات پیکربندی را برای افزودن سرور MCP «توسعه‌دهنده 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"
      }
    }
  }
}
  4. پس‌از ذخیره کردن فایل، فهرست سرورهای MCP به‌روز می‌شود.
  5. برای شروع فرایند اصالت‌سنجی، روی اصالت‌سنجی کلیک کنید.

Claude Code

برای پیکربندی 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:

  1. به سفارشی‌سازی > رابط‌ها بروید.
  2. روی افزودن کلیک کنید و افزودن اتصال‌دهنده سفارشی را انتخاب کنید.
  3. جزئیات زیر را وارد کنید:
      نام سرور: Google Pay & Wallet MCP.
      نشانی وب سرور MCP راه دور https://paydeveloper.googleapis.com/mcp.
  4. در تنظیمات پیشرفته، شناسه کارخواه OAuth و رمز کارخواه OAuth را وارد کنید.
  5. رابط جدید را انتخاب کنید و روی اتصال کلیک کنید.

ChatGPT

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

  1. حالت توسعه‌دهنده را از تنظیمات > امنیت و ورود به سیستم فعال کنید.
  2. افزونه‌ها را در پانل کناری اصلی انتخاب کنید و روی دکمه کلیک کنید.
  3. جزئیات زیر را وارد کنید:
      نام: Google Pay & Wallet MCP.
      نشانی وب سرور: https://paydeveloper.googleapis.com/mcp
  4. به تنظیمات پیشرفته بروید و شناسه کارخواه OAuth و رمز را وارد کنید.
  5. نشانی وب تماس برگشتی پویا را کپی کنید و آن را به کارخواه OAuth که در مرحله قبلی ایجاد شده است اضافه کنید.

Antigravity CLI

  1. برای پیکربندی 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"
      }
    }
  }
}

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

Antigravity IDE

  1. روی در بالای پانل کناری عامل ویرایشگر کلیک کنید و سرورهای MCP را انتخاب کنید.
  2. روی مدیریت کردن سرورهای MCP کلیک کنید.
  3. روی مشاهده پیکربندی خام کلیک کنید و جزئیات سرور MCP خود را اضافه کنید: 
    {
  "mcpServers": {
    "google-pay-wallet-dev": {
      "serverUrl": "https://paydeveloper.googleapis.com/mcp",
      "oauth": {
        "clientId": "ANTIGRAVITY_IDE_CLIENT_ID",
        "clientSecret": "ANTIGRAVITY_IDE_CLIENT_SECRET"
      }
    }
  }
}
  4. به Antigravity IDE برگردید و روی بازآوری کلیک کنید.
  5. سرور MCP جدیدتان را انتخاب کنید و روی اصالت‌سنجی کلیک کنید و جریان اصالت‌سنجی را تکمیل کنید.
  6. کد مجوز را کپی کنید و آن را در پنجره تنظیمات Antigravity ارسال کنید.

Antigravity

  1. در «ضدجاذبه»، به تنظیمات > سفارشی‌سازی‌ها بروید.
  2. در بخش سرورهای 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"
      }
    }
  }
}
  3. به Antigravity برگردید و روی بازآوری کلیک کنید.
  4. روی اصالت‌سنجی کلیک کنید و جریان اصالت‌سنجی را تکمیل کنید.
  5. کد مجوز را کپی کنید و آن را در پنجره تنظیمات Antigravity ارسال کنید.

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

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

شروط خدمات

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