شروع اتصال با یک دستور
در گفتوگو با ایجنت برنامهنویسی خود بنویسید:
fetch https://paasta.cloud/agentsایجنت سیستمعامل و CLI را بررسی میکند، در صورت نیاز راهاندازی را انجام میدهد و برای ورود امن به حساب همراهتان میماند. اتصال، اجازهٔ انتشار یا ایجاد هزینه نیست. راهنمای متنی اتصال برای ایجنت نیز بدون ورود در دسترس است.
انتخاب ابزار
CLI نسخهٔ 0.24.1 به بعد از Codex، Claude Code، Cursor، Antigravity، Cline، Gemini CLI و Windsurf پشتیبانی میکند. نسخهٔ فعلی را با paasta --version بررسی کنید و در صورت قدیمیبودن paasta update را اجرا کنید.
paasta login
paasta setup agent --agent codex
paasta whoamiبهجای codex میتوانید claude-code، cursor، antigravity، cline، gemini یا windsurf را انتخاب کنید. تنظیمات قبلی و سرورهای دیگر حفظ میشوند؛ توکن در تنظیمات MCP ذخیره نمیشود.
اتصال Codex، Claude Code، Cursor و Gemini CLI در پروژه ذخیره میشود. Antigravity و Windsurf از تنظیمات کاربر استفاده میکنند. برای Cline، تنظیمات پروژه و فایل موجود افزونه شناسایی میشود؛ اگر افزونه پیدا نشود، فایل مشترک Cline ساخته میشود. در صورت دیدهنشدن ابزارها، از MCP Servers سپس Configure و Configure MCP Servers فایل واقعی افزونه را باز کنید و خروجی دستور زیر را با حفظ سرورهای قبلی در آن ادغام کنید:
paasta setup agent --agent printبرای ابزارهای دیگرِ سازگار با MCP هم از همین خروجی استفاده کنید. پس از تنظیم، فهرست سرورهای MCP را بازخوانی کنید یا ایجنت را دوباره باز کنید؛ ظاهرشدن ابزارهای پاستا و اجرای یک ابزار خواندنی را بررسی کنید. ساختهشدن فایل بهتنهایی به معنی اتصال موفق نیست.
اگر اتصال انجام نشد
اگر CLI پیدا نمیشود، راهنمای PATH نصبکننده و نصب CLI را بررسی کنید. خطای ورود را با paasta login پیگیری کنید. اگر فایل MCP نامعتبر باشد، CLI آن را بازنویسی نمیکند؛ ابتدا خطای JSON را برطرف کنید. سطح دسترسی را فقط به اندازهٔ عملیات موردنیاز تعیین کنید.
پرسشهای متداول اتصال
آیا اتصال باعث ایجاد هزینه میشود؟ خیر؛ انتشار پروژه و ساخت سرویس به درخواست و مجوز شما نیاز دارد. آیا باید توکن را برای ایجنت بفرستم؟ خیر؛ ورود در CLI انجام میشود. آیا تنظیمات قبلی پاک میشود؟ خیر؛ سرور پاستا به تنظیمات موجود افزوده میشود.
پیشنیازهای این آموزش
Paasta CLIو ابزار توسعه موردنظر نصب باشند.- دسترسی عامل را به کار موردنظر محدود کنید؛ برای بررسی وضعیت، دسترسی نوشتن لازم نیست.
آموزش مرحلهبهمرحله
- با
paasta loginوارد شوید و باpaasta whoamiفضای کاری فعال را بررسی کنید. - در پوشه پروژه، فرمان راهاندازی عامل مناسب را اجرا کنید؛ نمونه زیر برای
Codexاست. - ابزار توسعه را دوباره بارگذاری کنید و از عامل فقط فهرست پروژهها را بخواهید.
- برای روش مستقیم
HTTP،Tokenدارای دسترسی و انقضای مناسب بسازید؛ آن را داخل مخزن یا گفتگو قرار ندهید. - پیش از هر تغییر منابع، نام پروژه، هزینه و پیامد را بخوانید و سپس اقدام را تأیید کنید.

Scopeهای لازم را انتخاب کنید؛ در این تصویر Token ساخته نشده است. برای دیدن جزئیات، تصویر را در اندازه کامل باز کنید.paasta login
paasta whoami
paasta setup agent --agent codexتوضیحات تکمیلی
این اتصال چه کاری انجام میدهد؟
MCP پاستا به Agent اجازه میدهد پروژههای فضای کاری شما را ببیند، وضعیت استقرار و لاگ را بررسی کند، پروژه متصل به Git را دوباره منتشر کند، سرویس را Restart کند و سورس پوشه فعلی را مستقیماً روی پاستا دیپلوی کند. Agent به زیرساخت داخلی، اطلاعات سایر کاربران یا Token خام دسترسی ندارد.
پیشنیازها
- Paasta CLI را نصب کنید و با
paasta versionمطمئن شوید نسخه حداقل 0.20.1 است. - با
paasta loginوارد همان فضای کاری شوید که پروژهها در آن قرار دارند. - ترمینال را در ریشه پروژه باز کنید؛ همان پوشهای که فایلهایی مانند
package.json،Dockerfileیاcompose.yamlدارد.
paasta update
paasta version
paasta login
paasta whoamiراهاندازی یکمرحلهای
cd YOUR_PROJECT
paasta setup agentاین دستور Claude Code، Codex و Cursor را همزمان تنظیم میکند، تنظیمات MCP قبلی را نگه میدارد و Skill راهنمای پاستا را به پروژه اضافه میکند. Token در مخزن یا فایل تنظیمات Agent نوشته نمیشود. پس از اجرا، Agent یا ویرایشگر را کاملاً Reload کنید.
تنظیم فقط یک Agent
paasta setup agent --agent claude-code
paasta setup agent --agent codex
paasta setup agent --agent cursorبرای دیدن تنظیم عمومی بدون نوشتن فایل از paasta setup agent --agent print و برای نساختن Skill از --no-skill استفاده کنید. اجرای دوباره setup امن و idempotent است.
فایلهای ساختهشده
- Claude Code:
.mcp.json - Cursor:
.cursor/mcp.json - Codex: بلوک
[mcp_servers.paasta]در.codex/config.toml - Skill مشترک:
.agents/skills/use-paasta/SKILL.md - Skill Claude:
.claude/skills/use-paasta/SKILL.md
هر کلاینت فرمان محلی paasta mcp را با transport استاندارد stdio اجرا میکند. این پل از نشست امن CLI استفاده میکند و درخواستهای remote را به MCP پاستا میفرستد.
بررسی اتصال
بعد از Reload از Agent بخواهید: «ابزارهای پاستا را فهرست کن» یا «پروژههای فضای کاری من را بدون تغییر چیزی نمایش بده». باید ابزارهایی با پیشوند paasta. دیده شوند. برای عیبیابی مستقیم، paasta whoami باید حساب فعال را نشان دهد و اجرای paasta mcp نباید قبل از دریافت ورودی JSON-RPC بسته شود.
ابزارها و Scope موردنیاز
| ابزار | کاربرد | Scope | ورودی اصلی |
|---|---|---|---|
paasta.list_projects | فهرست پروژهها و وضعیت آخرین استقرار | projects:read | limit اختیاری، ۱ تا ۱۰۰ |
paasta.get_project | تنظیمات اجرا و آخرین استقرار یک پروژه | projects:read | project |
paasta.list_deployments | نسخهها و استقرارهای اخیر | projects:read | project و limit اختیاری |
paasta.get_logs | لاگ جاری یا نمونه قبلی کانتینر | logs:read | project، container، tail و previous |
paasta.redeploy_git | ساخت نسخه جدید از repository و ref ثبتشده | deployments:write | project |
paasta.restart_project | Restart چرخشی بدون Build مجدد | deployments:write | project |
paasta.deploy_source | بستهبندی و دیپلوی سورس محلی با CLI | نشست CLI | directory، name، billing و confirm |
دیپلوی مستقیم کد توسط Agent
به Agent بگویید: «این پروژه را بررسی کن؛ stack، نام پیشنهادی، روش پرداخت و هزینه احتمالی را بگو و فقط بعد از تأیید من روی پاستا دیپلوی کن.» Agent ابتدا فایلهای پروژه را بررسی میکند. فایلهای حساس، .git و پوشههای وابستگی مانند node_modules وارد archive نمیشوند. اجرای نهایی فقط با confirm: true ممکن است. billing میتواند payg یا monthly باشد.
{
"directory": ".",
"name": "shop-api",
"billing": "payg",
"confirm": true
}پس از ارسال، Agent باید نتیجه Inspect، Build و Deploy را دنبال کند و در صورت شکست، خطای قابل اقدام و لاگ مرتبط را گزارش دهد. ایجاد پروژه ممکن است هزینه داشته باشد؛ تأیید را فقط پس از دیدن نام و روش پرداخت بدهید.
نمونه Promptهای کاربردی
- «همه پروژههای من و وضعیت آخرین استقرارشان را خلاصه کن؛ چیزی را تغییر نده.»
- «علت شکست آخرین Build پروژه shop-api را از استقرارها و لاگها پیدا کن.»
- «لاگ فعلی و previous پروژه shop-api را مقایسه کن و علت Crash را بگو.»
- «پروژه متصل به Git را دوباره deploy کن؛ قبل از اجرا تأیید بگیر.»
- «این repository را بررسی کن و بعد از اعلام نام، تنظیمات و هزینه احتمالی مستقیماً deploy کن.»
اتصال دستی Streamable HTTP
اگر ابزار شما remote MCP را مستقیماً پشتیبانی میکند، Endpoint زیر را ثبت کنید. این روش ابزارهای remote را ارائه میدهد؛ ابزار paasta.deploy_source فقط از پل محلی CLI در دسترس است، چون remote server به فایلهای رایانه شما دسترسی ندارد.
URL: https://console.paasta.cloud/api/mcp
Transport: Streamable HTTP
Authorization: Bearer paasta_YOUR_TOKEN
MCP-Protocol-Version: 2025-11-25Token را در صفحه API Token بسازید، تاریخ انقضا تعیین کنید و فقط Scopeهای لازم را بدهید. Token را داخل Prompt، Git، screenshot یا فایل عمومی قرار ندهید.
امنیت و حداقل دسترسی
- برای مشاهده وضعیت فقط
projects:readرا فعال کنید. - برای تحلیل خطا
logs:readرا اضافه کنید. deployments:writeرا فقط برای Agentی بدهید که باید Restart یا redeploy انجام دهد.- برای CI و رایانه شخصی Tokenهای جدا و کوتاهعمر بسازید.
- در صورت گمشدن دستگاه یا پایان همکاری، Token را فوراً لغو کنید.
- حذف، Rollback، توقف سرویس و عملیات داده باید همیشه تأیید جداگانه داشته باشند.
رفع اشکال
ابزارهای پاستا دیده نمیشوند
paasta setup agent را در ریشه همان پروژه دوباره اجرا کنید، Agent را Reload کنید و مطمئن شوید paasta در PATH محیطی است که Agent از آن اجرا شده است.
Unauthorized یا Scope error
paasta whoami را بررسی و در صورت نیاز paasta login را تکرار کنید. برای اتصال دستی، Token منقضی یا لغوشده را جایگزین کنید. پیام Scope دقیقاً دسترسی کمبود را مشخص میکند.
Agent پروژه محلی را پیدا نمیکند
Agent را از ریشه repository باز کنید یا مقدار کامل directory را بدهید. مسیر باید پوشه موجود باشد.
آپدیت CLI در Windows اعمال نمیشود
نسخه 0.20.0 با وجود نمایش پیام موفقیت ممکن است فایل اجرایی را جایگزین نکند. برای عبور یکباره از این نسخه، PowerShell را باز کنید و irm https://console.paasta.cloud/install.ps1 | iex را اجرا کنید؛ سپس یک ترمینال تازه باز کنید و با paasta version نسخه را بررسی کنید. از نسخه 0.20.1 به بعد، paasta update جایگزینی فایل قفلشده را تا ۶۰ بار تکرار میکند و در شکست نهایی فایل paasta.exe.update-error.txt را کنار executable مینویسد.
دیپلوی انجام نمیشود
Agent باید بعد از توضیح هزینه و دریافت تأیید، confirm: true بفرستد. موجودی کیف پول، نام معتبر پروژه و دسترسی فضای کاری را نیز بررسی کنید.
نتیجه را چگونه بررسی کنید؟
ابزارهای پاستا در عامل دیده میشوند و درخواست خواندنی وضعیت، فضای کاری درست را نشان میدهد.
اگر به مشکل خوردید
- اگر ابزار دیده نمیشود،
PATHهمان محیط عامل و نصبCLIرا بررسی کنید. - در خطای دسترسی، نشست یا
Scopeلازم را بررسی کنید؛ دسترسی کامل را برای رفع خطا فعال نکنید.