API و MCP
صفحه «API و MCP» دو راه استفاده از داده‌های ادپیکس بیرون از کنسول را کنار هم توضیح میدهد: اتصال دستیار هوش مصنوعی با MCP، و REST API برای یکپارچه‌سازی. هر دو در سطح حساب کاربری داده می‌شوند و یک اتصال همه وبسایتهای حساب شما را پوشش میدهد.
نمای کلی#
API و MCP را از منوی حساب (آواتار بالای صفحه) باز کنید. بالای صفحه دو کارت، دو راه استفاده را مقایسه می‌کنند:
- اتصال دستیار هوش مصنوعی (MCP) — به زبان ساده از Claude، ChatGPT یا Cursor درباره داده‌هایتان بپرسید. با حساب ادپیکس خود وارد می‌شوید و توکنی نمی‌سازید.
- ساخت یکپارچه‌سازی (REST API) — گزارش‌ها را با HTTPS و JSON به داشبورد، انبار داده یا کد خودتان بیاورید؛ با OAuth (برنامه‌ای که به‌جای یک شخص عمل میکند) یا توکن سرویس (سرور یا اسکریپت).
در هر دو حالت دسترسی هرگز از آنچه خودتان در کنسول می‌بینید فراتر نمی‌رود. کنار هر بخش یک برچسب نشان میدهد آیا پلن شما آن قابلیت را دارد یا نه — و پلن تنها چیزی است که برای هر وبسایت جداگانه بررسی میشود.
سطح دسترسی: حساب کاربری، نه یک وبسایت#
دسترسی MCP و API در سطح حساب کاربری داده میشود. هیچ بخشی از این صفحه تنظیم یک وبسایت خاص نیست: هر اتصال به حساب کاربری ادپیکس شما تعلق دارد و می‌تواند همه وب‌سایت‌هایی را که به آن‌ها دسترسی دارید بخواند.
- هنگام اتصال، در مرحله انتخاب دامنه گزینه «همه وبسایتهای من» را انتخاب کنید تا تمامی سایت‌های شما — و وب‌سایت‌هایی که بعدا به شما داده میشود — پوشش داده شوند. می‌توانید چند وبسایت را هم دستی انتخاب کنید.
- توکن سرویس همیشه همه وبسایتهای حساب خود را پوشش میدهد.
- تنها چیزی که برای هر وبسایت جداگانه بررسی میشود پلن است: وبسایتی که پلن آن API یا MCP را ندارد، حتی در اتصالی که کل حساب کاربری را پوشش میدهد، از پاسخ‌ها بیرون می‌ماند.
به همین دلیل برچسب پلن بالای هر زبانه نام هیچ وبسایتی را نمیآورد: فقط پلن را گزارش میکند و محدوده اتصال را نشان نمیدهد. اگر قابلیتی در پلن نباشد، «تغییر پلن» شما را به صورتحساب همان وبسایت می‌برد.
دستیارهای هوش مصنوعی (MCP)#
REST API#
زبانه REST API نشانی پایه API، سند کشف OAuth برای برنامه‌نویسان و یک نمونه آماده با curl را نشان میدهد. برای برنامه‌ای که هر عضو تیم خودش وصل میکند از OAuth استفاده کنید؛ برای کار شبانه یا اتصال BI که شخصی پشتش نیست، توکن سرویس.
برنامه‌های متصل شما#
برنامه‌هایی که شما با MCP یا OAuth وصل کرده‌اید، با مجوزها و وب‌سایت‌هایشان. با لغو دسترسی فوراً قطع میشود. بیشتر درباره برنامه‌های متصل.
توکن‌های سرویس#
توکن سرویس متعلق به حساب است، نه یک شخص، و فقط‌خواندنی است؛ همه وبسایتهای همان حساب را پوشش میدهد. فقط مدیر حساب آن را می‌سازد؛ دیگران در این زبانه پیامی می‌بینند که به MCP راهنمایی‌شان میکند.
جدول، توکن‌های حساب را با وضعیت، آخرین استفاده و انقضا نشان میدهد. مصرف گزارش ۳۰ روزه درخواست‌ها را باز میکند و لغو با ثبت دلیل، توکن را فوراً از کار می‌اندازد. زیر جدول، مدیر حساب برنامه‌های متصل به وبسایتهای حساب را می‌بیند و می‌تواند هر برنامه را مسدود کند.
پرسش‌های پرتکرار#
چرا این صفحه نام وبسایتی را نشان میدهد که الان روی آن کار نمیکنم؟
دیگر نشان نمیدهد. دسترسی MCP و API در سطح حساب کاربری است و یک اتصال همه وبسایتهای حساب شما را پوشش میدهد؛ این صفحه تنظیم یک وبسایت نیست. برچسب پلن هم نام هیچ وبسایتی را نمیآورد و فقط پلن را گزارش میکند.
برای وصل کردن Claude یا ChatGPT باید توکن بسازم؟
نه. نشانی سرور MCP را در برنامه وارد کنید؛ برنامه شما را به صفحه ورود ادپیکس می‌برد و خودتان وب‌سایت‌ها و مجوزها را انتخاب می‌کنید. توکن سرویس فقط برای سرورها و اسکریپت‌هاست.
چرا زبانه «توکن‌های سرویس» برای من فقط یک پیام نشان میدهد؟
ساخت و مدیریت توکن سرویس کار مدیر حساب است. برای اتصال دستیار هوش مصنوعی یا برنامه خودتان به آن نیازی ندارید — از زبانه «دستیارهای هوش مصنوعی (MCP)» استفاده کنید.
چرا کنار REST API نوشته «در پلن نیست»؟
REST API و MCP دو قابلیت جدا در پلن وبسایتاند. پلن رایگان بهطور پیشفرض فقط MCP دارد. برچسب فقط پلن را گزارش میکند و نام وبسایتی را نمیآورد؛ محدوده خود اتصال همیشه کل حساب کاربری است. برای دیدن اینکه کدام وبسایت روی کدام پلن است، «تغییر پلن» را باز کنید.
راز توکن سرویس را گم کردم؛ دوباره ببینم؟
نه. راز فقط یک بار، درست پس از ساخت، نشان داده میشود. یک توکن تازه بسازید و قدیمی را لغو کنید — لغو بیدرنگ است.
ممنون — بازخورد شما به بهتر شدن مستندات کمک میکند.