اتصال Claude Code، Codex و Cursor با MCP پاستا

پیش از شروع

این راهنما را با یک پروژه آزمایشی یا منبعی که مجاز به تغییر آن هستید دنبال کنید.
هزینه و اثر حذف یا جایگزینی داده در مرحله تأیید نهایی دوباره نمایش داده می‌شود.
پس از هر تغییر، نتیجه مورد انتظار همان مرحله را در وضعیت پروژه، رخدادها یا گزارش فعالیت بررسی کنید.

این اتصال چه کاری انجام می‌دهد؟

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-25

Token را در صفحه 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 بفرستد. موجودی کیف پول، نام معتبر پروژه و دسترسی فضای کاری را نیز بررسی کنید.

شروع و استقرار

داده و ذخیره‌سازی

دامنه و شبکه

عملیات و مدیریت