پیش از شروع
- این راهنما را با یک پروژه آزمایشی یا منبعی که مجاز به تغییر آن هستید دنبال کنید.
- هزینه و اثر حذف یا جایگزینی داده در مرحله تأیید نهایی دوباره نمایش داده می‌شود.
- پس از هر تغییر، نتیجه مورد انتظار همان مرحله را در وضعیت پروژه، رخدادها یا گزارش فعالیت بررسی کنید.
یک API Token محدود بسازید
در صفحه «API Token» یک Token جدید بسازید. برای مشاهده پروژه‌ها projects:read، برای لاگ‌ها logs:read و فقط در صورت نیاز به استقرار یا Restart، دسترسی deployments:write را فعال کنید. مقدار Token فقط یک بار نمایش داده می‌شود.
اتصال پیشنهادی با یک دستور
ابتدا Paasta CLI را نصب کنید و paasta login را اجرا کنید. سپس در ریشه همان پروژه بنویسید: paasta setup agent. این دستور تنظیمات Claude Code، Codex و Cursor را بدون حذف ورودی‌های قبلی به‌روزرسانی می‌کند و Skill راهنمای use-paasta را هم می‌سازد. Agent یا ویرایشگر را دوباره باز کنید تا اتصال بارگذاری شود.
اتصال فقط به یک Agent
برای Claude Code از paasta setup agent --agent claude-code، برای Codex از paasta setup agent --agent codex و برای Cursor از paasta setup agent --agent cursor استفاده کنید. اجرای دوباره دستور امن است و سایر MCP Serverهای فایل تنظیمات را نگه می‌دارد. برای چاپ تنظیم عمومی نیز paasta setup agent --agent print در دسترس است.
فایل‌هایی که ساخته یا به‌روزرسانی می‌شوند
Claude Code از .mcp.json، Cursor از .cursor/mcp.json و Codex از جدول [mcp_servers.paasta] در .codex/config.toml استفاده می‌کند. Skill پروژه در .agents/skills/use-paasta/SKILL.md و .claude/skills/use-paasta/SKILL.md نوشته می‌شود. هیچ Tokenی در این فایل‌ها ذخیره نمی‌شود؛ فرمان محلی paasta mcp از نشست CLI استفاده می‌کند.
اتصال دستی به Endpoint
اگر کلاینت شما Streamable HTTP را مستقیم پشتیبانی می‌کند، از URL: https://console.paasta.cloud/api/mcp استفاده کنید. این روش ابزارهای remote را ارائه می‌دهد، اما برای دیپلوی پوشه محلی باید پل CLI با فرمان
Transport: Streamable HTTP
Authorization: Bearer paasta_YOUR_TOKENpaasta mcp اجرا شود. Token را داخل مخزن، Prompt یا فایل عمومی قرار ندهید.
ابزارهای خواندنی
Agent می‌تواند پروژه‌ها و استقرارهای اخیر را فهرست کند، جزئیات یک پروژه را بخواند و لاگ آخرین Pod را برای کانتینر موردنظر دریافت کند. پاسخ‌ها هم متن قابل خواندن و هم structuredContent دارند تا ابزار بتواند نتیجه را مطمئن پردازش کند.
عملیات اجرایی
ابزار paasta.deploy_source پوشه محلی را با همان قواعد امن CLI بسته‌بندی می‌کند؛ فایل‌های Secret و وابستگی‌هایی مانند node_modules وارد Archive نمی‌شوند. Agent باید پیش از ارسال confirm: true هزینه احتمالی و نام پروژه را توضیح دهد و تأیید شما را بگیرد. برای پروژه متصل به Git، ابزار redeploy یک Build جدید از Repository و Branch ثبت‌شده می‌سازد. ابزار restart نیز بدون Build مجدد یک راه‌اندازی چرخشی انجام می‌دهد.
نمونه درخواست‌های آماده
پس از اتصال می‌توانید بنویسید: «این پروژه را بررسی کن و بعد از گفتن تنظیمات و هزینه روی پاستا دیپلوی کن»، «چرا آخرین Build شکست خورده؟»، «لاگ فعلی و قبلی پروژه shop-api را مقایسه کن»، «وضعیت همه پروژه‌ها را خلاصه کن» یا «پروژه متصل به Git را دوباره منتشر کن». برای حذف، Rollback، توقف یا هر تغییر حساس همیشه نام منبع و پیامد را بررسی و جداگانه تأیید کنید.
رفع اشکال اتصال
اگر ابزارهای paasta.* دیده نمی‌شوند، ابتدا paasta whoami را اجرا کنید، سپس مطمئن شوید فرمان paasta در PATH همان محیط Agent است. paasta setup agent را دوباره اجرا و Agent را Reload کنید. خطای Unauthorized یعنی نشست CLI منقضی یا Token لغو شده و با paasta login رفع می‌شود. خطای Scope نام دسترسی لازم را اعلام می‌کند؛ Token را فقط با همان Scope موردنیاز دوباره بسازید.
اصل حداقل دسترسی
برای Agentهای فقط خواندنی تنها projects:read و logs:read را فعال کنید. برای CI یک Token جدا با تاریخ انقضای کوتاه بسازید. در صورت گم‌شدن دستگاه یا پایان اتوماسیون، Token را از همان صفحه فوراً لغو کنید.