اتصال هوش مصنوعی به AdminJump
۱. یک اتصال برای سایت انتخابی بسازید
در سایت انتخاب‌شده → همکاران و هوش مصنوعی → اتصال‌های هوش مصنوعی → افزودن هوش مصنوعی، نام و دسترسی‌ها را انتخاب کنید. آدرس MCP را از جزئیات اتصال کپی کنید. ایجاد اتصال هنوز توکن صادر نمی‌کند.
کلاینت باید Streamable HTTP و OAuth با PKCE S256 داشته باشد. آدرس دقیق به شکل https://YOUR_ADMINJUMP/mcp/connections/UUID است؛ همان آدرس resource است. کلاینت از پاسخ401، protected resource metadata و authorization server metadata را کشف می‌کند، به صفحهٔ ورود/تأیید فارسی هدایت می‌شود و پس از تأیید کد را با PKCE به توکن تبدیل می‌کند.
۲. کلاینت را به آدرس MCP وصل کنید
در ChatGPT، از تنظیمات اتصال‌های MCP/حالت توسعهٔ حساب خود آدرس را اضافه و OAuth را انتخاب کنید؛ محل دقیق گزینه و دسترسی آن به حساب و سیاست workspace بستگی دارد. از صفحهٔ مدیریت همان اتصال، client metadata document و redirect URI دقیق را بردارید. نشانی callback را در MCP_REDIRECT_URIS مجاز کنید؛ حدس‌زدن یا wildcard مجاز نیست. این نصب iss را در پاسخ و metadata اعلام می‌کند و CIMD را پشتیبانی می‌کند. client document جاری OpenAI آدرس https://chatgpt.com/oauth/client.json دارد. callback پیش‌فرض نصب https://chatgpt.com/connector_platform_oauth_redirect است؛ اگر صفحهٔ مدیریت کلاینت نشانی متفاوتی داد، همان نشانی دقیق را ثبت کنید. راهنمای رسمی OAuth در ChatGPT. این تنظیمات به معنی آزمون اتصال با حساب واقعی ChatGPT نیست.
ChatGPT ابری به localhost این کامپیوتر دسترسی مستقیم ندارد. برای آزمون این نصب از کلاینت/Inspector محلی استفاده کنید. اتصال ابری به دامنهٔ HTTPS قابل دسترس یا مسیر tunnel سازگار نیاز دارد؛ هیچ tunnel یا انتشار Production خودکار انجام نشده است. راهنمای رسمی tunnel امن.
۳. سایت و دسترسی‌ها را تأیید کنید
صفحهٔ فارسی، نام و شناسهٔ client، سایت، اتصال و مجوزهای درخواستی را نشان می‌دهد. اگر نشست وب دارید ورود دوباره لازم نیست. فقط درخواست متعلق به خودتان را تأیید کنید. «رد درخواست» هیچ توکنی صادر نمی‌کند. هر اتصال فقط یک سایت دارد؛ برای سایت دیگر اتصال جدا بسازید.
۴. نشست و نتیجهٔ ارسال را ببینید
نشست‌ها و مجوزها در جزئیات اتصال دیده می‌شوند. لغو یک نشست، توکن دسترسی و تمدید همان خانواده را لغو می‌کند. «قطع تمام نشست‌ها» تأییدهای قبلی را هم لغو می‌کند. حذف اتصال تاریخچه را پاک نمی‌کند. کاهش دسترسی فوری است و صف دوباره مجوز را بررسی می‌کند.
نوشتن مقاله pending/processing است تا CMS آن را تأیید کند. شناسهٔ عملیات را با get_article_operation_status پیگیری کنید. انتشار، حذف و تغییر مقالهٔ منتشرشده نیاز به تأیید جداگانهٔ وب در AdminJump دارند؛ تأیید مکالمه‌ای AI جایگزین آن نیست.
نسخه‌های پروتکل: 2026-07-28 و سازگاری initialize برای 2025-11-25/2025-06-18. transport بدون نشست پروتکلی است؛ نشست‌های پنل خانواده‌های OAuth مستقل‌اند. هیچ API Key یا Bearer Token را در آدرس MCP وارد نکنید.
تنظیم برای مدیر سرور
در نصب موجود APP_KEY، دیتابیس و .env را بازنویسی نکنید. PHP به openssl و sodium نیاز دارد. پس از composer install و migrate:
php artisan adminjump:mcp-keys
php artisan queue:work --queue=article-writes,article-sync,article-media,default --timeout=55 --tries=6
php artisan schedule:work
MCP با همان وب‌سرور AdminJump اجرا می‌شود؛ daemon مستقل لازم نیست. worker موجود باید پس از تغییر کد restart شود. queue names را با ARTICLE_SYNC_OPERATIONS و تنظیم Jobs نصب هماهنگ کنید.
نمونه تنظیم دامنه عمومی:
APP_URL=https://adminjump.example
APP_ENV=production
APP_DEBUG=false
SESSION_SECURE_COOKIE=true
ADMINJUMP_MCP_ENABLED=true
MCP_REDIRECT_URIS=https://chatgpt.com/connector_platform_oauth_redirect
MCP_DYNAMIC_REGISTRATION=true
MCP_LOCAL_REDIRECTS=false
MCP_ALLOWED_ORIGINS=
برای client محلی public، تنها local/testing و MCP_LOCAL_REDIRECTS=true اجازهٔ callback literal loopback دارد. پورت callback Inspector را از خود کلاینت بردارید؛ برای fetch مرورگری، Origin دقیق Inspector را در MCP_ALLOWED_ORIGINS نیز مجاز کنید. localhost سرور را به جای URL عمومی ChatGPT وارد نکنید. قرارداد متنی همهٔ endpointها و tools برای توسعه‌دهنده و هوش مصنوعی در دسترس است. ابزار محصولات در این نسخه فعال نیست؛ حتی اگر CMS محصولات داشته باشد، این نسخهٔ MCP روی مقالات تمرکز دارد.