استفاده از سرور Android Management API MCP

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

تفاوت بین سرورهای MCP محلی و از دور چیست؟

سرورهای MCP محلی

معمولاً در ماشین محلی شما اجرا می‌شود و از جاری‌سازی‌های ورودی و خروجی استاندارد (stdio) برای ارتباط بین سرویس‌ها در یک دستگاه استفاده می‌کند.

سرورهای MCP از دور

در زیرساخت سرویس اجرا شود و یک نقطه پایانی HTTP به برنامه‌های هوش مصنوعی برای ارتباط بین کارخواه AI MCP و سرور MCP ارائه دهد. برای اطلاعات بیشتر درباره معماری MCP، به معماری MCP مراجعه کنید.

هسته بدون وضعیت

با نسخه MCP 2026-07-28، ‫MCP از پروتکل دوطرفه و حالت‌دار به پروتکل بدون حالت تغییر می‌کند. هر درخواست MCP خودتوضیحی است و می‌تواند بااستفاده از سرایندها مسیریابی شود. به دست‌دادن initialize/initialized یا Mcp-Session-Id نیازی نیست زیرا هر درخواست شامل تمام اطلاعات موردنیاز در سرصفحه‌های HTTP یا پارامتر _meta است. سرورهای MCP می‌توانند اطلاعات تکمیلی موردنیاز ابزار را ازطریق درخواست‌های چند رفت‌وبرگشتی (MRTR) درخواست کنند.

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

• سرایندهایی که مشخصات MCP به آن‌ها نیاز دارد، مثل سرایند نسخه پروتکل و سرایندهای درخواست استاندارد.
• سرایندهای سفارشی که توسط سرور MCP تعریف شده است. این سرایندها بااستفاده از دارایی x-mcp-header در طرح‌واره ورودی ابزار در سرایندهای HTTP قرینه می‌شوند. برای مثال، سرور MCP ممکن است سرایند سفارشی را برای مشخص کردن منطقه Google Cloud یا شناسه پروژه تعریف کند.

برای اطلاعات بیشتر درباره معماری MCP، به مشخصات MCP نسخه ۲۰۲۶-۰۷-۲۸ و تغییرات کلیدی مراجعه کنید.

قبل‌از شروع

برای استفاده از سرور MCP از دور Android Management API، باید پروژه Google Cloud ایجاد کنید و Android Management API را فعال کنید.

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

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

2. اگر Android Management API ازقبل فعال نیست، آن را فعال کنید.

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

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

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

نقش‌های الزامی

برای دریافت اجازه‌هایی که برای استفاده از سرور MCP راه دور «میانای برنامه‌سازی کاربردی مدیریت Android» نیاز دارید، از سرپرستتان بخواهید نقش‌های «مدیریت هویت و دسترسی‌ها» زیر را در پروژه Google Cloud که می‌خواهید سرور MCP «میانای برنامه‌سازی کاربردی مدیریت Android» را در آن فعال کنید به شما اعطا کند:

• دسترسی به منابع «مدیریت Android»: کاربر «مدیریت Android» (roles/androidmanagement.user)

برای اطلاعات بیشتر درباره اعطای نقش‌ها، به مدیریت دسترسی به پروژه‌ها، پوشه‌ها، و سازمان‌ها مراجعه کنید.

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

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

سرورهای MCP «میانای برنامه‌سازی کاربردی مدیریت Android» از پروتکل OAuth 2.0 با مدیریت هویت و دسترسی‌ها برای اصالت‌سنجی و صدور مجوز استفاده می‌کنند. همه هویت‌های Google Cloud برای اصالت‌سنجی در سرورهای MCP پشتیبانی می‌شوند.

سرور MCP از دور «میانای برنامه‌سازی کاربردی مدیریت Android» کلیدهای میانای برنامه‌سازی کاربردی را نمی‌پذیرد.

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

Android Management API MCP OAuth scopes

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

‫Android Management API دارای دامنه‌های OAuth ابزار MCP زیر است:

ممکن است در منابعی که درطول تماس ابزار به آن‌ها دسترسی پیدا می‌شود، حوزه‌های اضافی موردنیاز باشد. برای مشاهده فهرست محدوده‌های موردنیاز برای Android Management API، به Android Management API مراجعه کنید.

پیکربندی کارخواه MCP برای استفاده از سرور Android Management API MCP

برنامه‌ها و کارگزاران هوش مصنوعی، مثل Claude یا Antigravity، می‌توانند کارخواه MCP را نمونه‌سازی کنند که به یک سرور MCP متصل می‌شود. برنامه هوش مصنوعی می‌تواند چندین کارخواه داشته باشد که به سرورهای MCP مختلف متصل می‌شوند. اگر برنامه شما در راهنمایی‌های مختص مشتری فهرست نشده است، می‌توانید از اطلاعات زیر برای اتصال از اکثر برنامه‌ها استفاده کنید.

در برنامه هوش مصنوعی خود، به‌دنبال راهی برای افزودن یا اتصال به سرور MCP ازراه‌دور بگردید. برای سرور MCP «میانای برنامه‌سازی کاربردی مدیریت Android»، اطلاعات زیر را درصورت نیاز وارد کنید:

• نام سرور: سرور Android Management API MCP
• نشانی وب سرور یا نقطه پایانی: https://androidmanagement.googleapis.com/mcp
• حمل‌ونقل: HTTP جاری‌شدنی
• جزئیات اصالت‌سنجی: بسته به اینکه چگونه می‌خواهید اصالت‌سنجی کنید، می‌توانید اطلاعات اعتباری Google Cloud، شناسه مشتری OAuth و رمز، یا هویت و اطلاعات اعتباری عامل را وارد کنید. برای اطلاعات بیشتر درباره اصالت‌سنجی، به اصالت‌سنجی در سرورهای MCP مراجعه کنید.
• محدوده OAuth: [محدوده OAuth 2.0][oauth-scopes-overview] که می‌خواهید هنگام اتصال به سرور Android Management API MCP استفاده کنید.

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

برای راهنمایی‌های کلی بیشتر، منابع زیر را ببینید:

• به سرورهای MCP راه‌دور متصل شوید.
• پیکربندی MCP در برنامه هوش مصنوعی.

ابزارهای دردسترس

برای مشاهده جزئیات ابزارهای MCP دردسترس و شرح آن‌ها برای سرور MCP «میانای برنامه‌سازی کاربردی مدیریت Android»، به مرجع MCP «میانای برنامه‌سازی کاربردی مدیریت Android» مراجعه کنید.

ابزارهای فهرست

از بازرس MCP برای فهرست کردن ابزارها استفاده کنید، یا درخواست tools/list HTTP را مستقیماً به سرور MCP راه دور Android Management API ارسال کنید. روش tools/list به اصالت‌سنجی نیاز ندارد.

curl -X POST https://androidmanagement.googleapis.com/TOOLSET_ENDPOINT \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'MCP-Protocol-Version: MCP_PROTOCOL_VERSION' \
    -H 'Mcp-Method: tools/list' \
    -d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "tools/list",
      "params": {
        "_meta": {
          "io.modelcontextprotocol/protocolVersion": "MCP_PROTOCOL_VERSION",
          "io.modelcontextprotocol/clientCapabilities": {
            "extensions": {
              "io.modelcontextprotocol/ui": {
                "mimeTypes": ["text/html;profile=mcp-app"]
              }
            }
          }
        }
      }
    }'

جایگزین کردن موارد زیر:

• ‫TOOLSET_ENDPOINT: باقیمانده نقطه پایان MCP پس‌از نام سرویس. برای مثال، برای Android Management API، این مقدار ممکن است mcp/toolset-name باشد.
• ‫MCP_PROTOCOL_VERSION: نسخه پروتکل MCP. برای مثال، 2026-07-28.

موارد استفاده نمونه

در زیر نمونه‌هایی از موارد استفاده برای سرور MCP «میانای برنامه‌سازی کاربردی مدیریت Android» آورده شده است:

• پُرسمان‌های زبان طبیعی: بدون نوشتن کد، سؤالات پیچیده‌ای درباره ناوگان دستگاهتان بپرسید—برای مثال، «کدام‌یک از دستگاه‌های من با آخرین وصله امنیتی سازگار نیست؟»
• ممیزی‌های خودکار: به‌طور دوره‌ای داده‌ها را واکشی می‌کند و گزارش‌هایی درباره وضعیت دستگاه و رعایت خط‌مشی‌ها تهیه می‌کند.
• هشدار هوشمند: داده‌های ناوگان را برای نشان‌گذاری ناهنجاری‌ها یا مشکلات احتمالی براساس اطلاعات آماری هم‌زمان پایش کنید.

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

می‌توانید از پیام‌واره‌های نمونه زیر برای دریافت اطلاعات درباره منابع Android Management API استفاده کنید:

• دستگاه‌های موجود در شرکت ENTERPRISE_ID را فهرست کن.
• جزئیات دستگاه DEVICE_ID را در ENTERPRISE_ID سازمان دریافت کنید.
• جزئیات خط‌مشی POLICY_NAME را نشان بده.
• کدام برنامه‌ها در ENTERPRISE_ID سازمانی دردسترس هستند؟

در پیام‌واره‌ها، موارد زیر را جایگزین کنید:

• ENTERPRISE_ID: نام منبع سازمان—برای نمونه، enterprises/LC012345.
• ‫DEVICE_ID: نام منبع دستگاه.
• ‫POLICY_NAME: نام منبع خط‌مشی.

پیکربندی‌های اختیاری ایمنی و امنیت

‫MCP به‌دلیل تنوع گسترده کنش‌هایی که می‌توان با ابزارهای MCP انجام داد، خطرات و ملاحظات امنیتی جدیدی را معرفی می‌کند. برای به‌حداقل رساندن و مدیریت این خطرات، ‫Google Cloud پیش‌فرض‌ها و خط‌مشی‌های سفارشی‌سازی‌پذیری را برای کنترل استفاده از ابزارهای MCP در سازمان یا پروژه Google Cloud شما ارائه می‌دهد.

برای اطلاعات بیشتر درباره امنیت و حکمرانی MCP، به امنیت و ایمنی هوش مصنوعی مراجعه کنید.

قدم بعدی چیست

• مستندات مرجع Android Management API MCP را بخوانید.
• درباره سرورهای Google Cloud MCP بیشتر بدانید.