استفاده از سرور MCP API مدیریت اندروید

این سند به شما نشان می‌دهد که چگونه از سرور پروتکل زمینه مدل (MCP) از راه دور Android Management API برای اتصال به برنامه‌های هوش مصنوعی از جمله Gemini CLI، ChatGPT، Claude و برنامه‌های سفارشی که در حال توسعه آنها هستید، استفاده کنید. سرور MCP از راه دور Android Management API به عوامل هوش مصنوعی این امکان را می‌دهد که به صورت برنامه‌نویسی به داده‌های تحرک سازمانی دسترسی پیدا کنند. این سرور امکان پرس‌وجوهای زبان طبیعی در مورد ناوگان دستگاه‌ها، حسابرسی خودکار انطباق با سیاست‌ها و ادغام داده‌های مدیریت دستگاه در گردش‌های کاری خودکار گسترده‌تر را فراهم می‌کند. سرور MCP از راه دور Android Management API زمانی فعال می‌شود که شما API API مدیریت اندروید را فعال کنید.

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

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

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

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

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

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

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

برای اطلاعات بیشتر در مورد معماری MCP، به مشخصات و تغییرات کلیدی نسخه MCP 2026-07-28 مراجعه کنید.

قبل از اینکه شروع کنی

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

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

    به انتخابگر پروژه بروید

  2. API مدیریت اندروید را فعال کنید.

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

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

    فعال کردن API

نقش‌های مورد نیاز

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

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

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

مجوزهای مورد نیاز

برای استفاده از سرور MCP از راه دور Android Management API، مجوزهای زیر مورد نیاز است:

  • serviceusage.mcppolicy.get
  • serviceusage.mcppolicy.update
  • فراخوانی‌های ابزار MCP را انجام دهید: mcp.tools.call
  • دسترسی به منابع مدیریت اندروید:
    • androidmanagement.enterprises.get
    • androidmanagement.devices.list

همچنین ممکن است بتوانید این مجوزها را با نقش‌های سفارشی یا سایر نقش‌های از پیش تعریف شده دریافت کنید.

احراز هویت و مجوز

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

سرور MCP از راه دور Android Management API کلیدهای API را نمی‌پذیرد.

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

دامنه‌های MCP OAuth در API مدیریت اندروید

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

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

آدرس دامنه برای gcloud توضیحات
https://www.googleapis.com/auth/androidmanagement مدیریت دستگاه‌ها و برنامه‌های اندروید

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

پیکربندی کلاینت MCP برای استفاده از API مدیریت اندروید (Android Management API) و سرور MCP

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

در برنامه هوش مصنوعی خود، به دنبال راهی برای اضافه کردن یا اتصال به یک سرور MCP از راه دور باشید. برای سرور MCP API مدیریت اندروید، اطلاعات زیر را در صورت نیاز وارد کنید:

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

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

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

ابزارهای موجود

برای مشاهده جزئیات ابزارهای MCP موجود و توضیحات آنها برای سرور MCP API مدیریت اندروید، به مرجع MCP API مدیریت اندروید مراجعه کنید.

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

از بازرس MCP برای فهرست کردن ابزارها استفاده کنید، یا یک درخواست HTTP برای tools/list را مستقیماً به سرور 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 پس از نام سرویس. برای مثال، برای API مدیریت اندروید، این می‌تواند mcp/toolset-name باشد.
  • MCP_PROTOCOL_VERSION : نسخه پروتکل MCP. برای مثال، 2026-07-28 .

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

موارد زیر نمونه‌هایی از موارد استفاده برای سرور MCP API مدیریت اندروید هستند:

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

نمونه سوالات

شما می‌توانید از نمونه‌های زیر برای دریافت اطلاعات در مورد منابع 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، به امنیت و ایمنی هوش مصنوعی مراجعه کنید.

کنترل استفاده از MCP با سیاست‌های IAM

مدیریت هویت و دسترسی: سیاست‌های رد و اجازه به شما کمک می‌کند تا سرورهای Google Cloud و Google MCP را ایمن کنید.

شما می‌توانید چندین معیار را برای ایجاد سیاست‌های امنیتی و مدیریتی سفارشی با اجازه دادن یا ندادن دسترسی بر اساس موارد زیر ترکیب کنید:

  • مدیر اصلی.
  • ویژگی‌های ابزار مانند ویژگی فقط خواندنی.
  • نام سرویس یا نام ابزار.
  • شناسه کلاینت OAuth برنامه.

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

قدم بعدی چیست؟