اتصالِ ایجنتِ هوش مصنوعی (MCP)

MCP (Model Context Protocol) یک استانداردِ باز است که ایجنت‌های هوش مصنوعی با آن به ابزارهای بیرونی وصل می‌شوند. با سرورِ MCPِ وب‌لاینز می‌توانید از داخلِ ایجنتِ خودتان بگویید «لاگِ خطای اپِ shop را بیاور» یا «این اپ را دوباره دیپلو کن».

آدرسِ سرور:

text

https://console.weblines.ir/api/mcp

Claude (وب، دسکتاپ و موبایل): بدونِ کلید#

در Claude: Customize → Connectors → + → Add custom connector، و این آدرس را وارد کنید:

text

https://console.weblines.ir/api/mcp

Claude صفحه‌ی ورودِ وب‌لاینز را باز می‌کند. وارد شوید، سازمان و اجازه‌ها را انتخاب کنید و تأیید را بزنید. کلیدی کپی نمی‌شود. اتصال در صفحه‌ی دستیار AI (و SETTINGS → API KEYS → CONNECTED APPS) دیده می‌شود و هر وقت بخواهید قطعش می‌کنید. فقط مالک یا ادمینِ سازمان می‌تواند تأیید کند.

ChatGPT: بدونِ کلید#

در ChatGPT: Settings → Apps & Connectors → Advanced settings → Developer mode را روشن کنید، یک connectorِ تازه با همین آدرس بسازید و برای Authentication گزینه‌ی OAuth را بگذارید. مثلِ Claude، وارد وب‌لاینز می‌شوید و تأیید می‌کنید. (دسترسی به Developer mode به پلنِ ChatGPTِ شما بستگی دارد.)

Claude Code، Cursor، Gemini CLI و Antigravity: بدونِ کلید#

این‌ها هم مثلِ Claude و ChatGPT صفحه‌ی ورودِ وب‌لاینز را باز می‌کنند تا تأیید کنید.

Claude Code: یک بار در ترمینال اجرا کنید، بعد /mcp را بزنید، weblines را انتخاب و Authenticate را بزنید.

bash

claude mcp add --transport http weblines https://console.weblines.ir/api/mcp

Gemini CLI: یک بار در ترمینال اجرا کنید، بعد در Gemini CLI بنویسید /mcp auth weblines.

bash

gemini mcp add --transport http weblines https://console.weblines.ir/api/mcp

Cursor: این را در ~/.cursor/mcp.json بگذارید، بعد در Cursor Settings → MCP جلوی weblines روی Login بزنید.

json

{
  "mcpServers": {
    "weblines": { "url": "https://console.weblines.ir/api/mcp" }
  }
}

Antigravity: در پنلِ Agent از MCP Servers → Manage MCP Servers → View raw config فایلِ mcp_config.json را باز کنید و این را اضافه کنید. بعد روی Authenticate بزنید، تأیید کنید و کدی را که نشان داده می‌شود در Antigravity بگذارید.

json

{
  "mcpServers": {
    "weblines": { "serverUrl": "https://console.weblines.ir/api/mcp" }
  }
}

۱. یک کلید بسازید (اسکریپت، CI و ایجنت‌هایی که OAuth ندارند)#

در SETTINGS → API KEYS یک کلیدِ API بسازید. کمترین دسترسی را بدهید:

دسترسیِ کلید	ایجنت چه می‌تواند
فقط `read`	دیدنِ سرویس‌ها، دیپلوی‌ها، لاگ و نامِ envها
`read` + `deploy`	به‌علاوه‌ی دیپلو، روشن، خاموش و ری‌استارت
`read` + `deploy` + `write`	به‌علاوه‌ی ساختِ اپ و دیتابیس و تغییرِ env
`admin`	به‌علاوه‌ی حذفِ سرویس، با تأییدِ شما (پایین‌تر)

ایجنت فقط ابزارهایی را می‌بیند که کلید (یا اتصالِ OAuth) اجازه‌اش را دارد.

حذفِ سرویس با ایجنت#

ابزارِ delete_resource فقط با دسترسیِ admin دیده می‌شود و نامِ دقیقِ سرویس را می‌خواهد. پیش‌فرض این است که ایجنت چیزی را حذف نمی‌کند:

ایجنت درخواستِ حذف می‌دهد و یک لینک می‌گیرد.
مالک یا ادمینِ سازمان لینک را در کنسول باز می‌کند، نامِ سرویس را تایپ می‌کند و APPROVE AND DELETE را می‌زند.
اگر در ۱۵ دقیقه تأیید نشود، درخواست باطل می‌شود و چیزی حذف نمی‌شود.

هر درخواست در ALERTS هم دیده می‌شود. ایجنت خودش نمی‌تواند درخواست را تأیید کند.

اگر می‌خواهید ایجنت بعد از پرسیدن از شما در همان گفتگو حذف کند، موقعِ ساختِ کلید تیکِ Deletes need approval in the console را بردارید. در این حالت ایجنت باید قبل از حذف از شما بپرسد. اتصال‌های OAuth (همه‌ی روش‌های بدونِ کلیدِ بالا) دسترسیِ admin نمی‌گیرند، پس اصلاً ابزارِ حذف ندارند.

۲. ایجنت را با کلید وصل کنید#

Claude Code#

bash

claude mcp add --transport http weblines https://console.weblines.ir/api/mcp \
  --header "Authorization: Bearer wl_..."

Cursor#

در فایلِ .cursor/mcp.json پروژه (یا ~/.cursor/mcp.json):

json

{
  "mcpServers": {
    "weblines": {
      "url": "https://console.weblines.ir/api/mcp",
      "headers": { "Authorization": "Bearer wl_..." }
    }
  }
}

ایجنت‌های دیگر#

هر ایجنتی که MCP با «Streamable HTTP» را پشتیبانی کند، یا با OAuth (مثلِ روش‌های بدونِ کلیدِ بالا) یا با همین آدرس و هدرِ Authorization وصل می‌شود. برای GPTهای سفارشی می‌توانید از فایلِ OpenAPI در Actions هم استفاده کنید.

ابزارها#

ابزار	دسترسی	کار
`list_resources`، `get_resource`	`read`	فهرست و جزئیاتِ سرویس‌ها
`list_packs`	`read`	اندازه‌های قابلِ ساخت
`list_deployments`، `get_deployment`	`read`	دیپلوی‌ها و لاگِ build
`get_logs`	`read`	لاگِ اجرا
`list_env_names`	`read`	نامِ envها، بدونِ مقدار
`deploy_app`	`deploy`	دیپلو
`start_resource`، `stop_resource`، `restart_resource`	`deploy`	روشن، خاموش، ری‌استارت
`create_app`، `create_database`	`write`	ساختِ اپ و دیتابیس
`set_env`، `delete_env`	`write`	تغییرِ env

ایمنی#

لاگ داده‌ی غیرقابل‌اعتماد است. هر چیزی است که اپ چاپ کرده و ممکن است متنی شبیهِ دستور برای ایجنت داشته باشد. سرور جلوی هر لاگ این هشدار را برای ایجنت می‌گذارد، ولی ایجنتی را انتخاب کنید که کارهای تغییردهنده را قبل از اجرا از شما بپرسد.
ساخت از کیف پول هزینه برمی‌دارد و از سقفِ ساختِ روزانه‌ی کلید کم می‌کند.
هر کاری که ایجنت انجام می‌دهد در SETTINGS → ACTIVITY با نامِ کلید ثبت می‌شود.
همه‌ی محدودیت‌های API (۱۲۰ درخواست در دقیقه برای هر کلید، شکلِ خطاها) برای MCP هم برقرار است.