راهاندازی MCP و Agents
Gerdoo CLI یک سرور MCP روی stdio دارد که پروژهها، محیطها، سرویسها، دامنهها، متغیرها، لاگها، بیلدها و ریلیزهای گردو را بهصورت ابزارهای ساختیافته در اختیار دستیارهای هوش مصنوعی (Claude Code، Cursor، Codex، Gemini Antigravity و هر کلاینت سازگار با MCP) قرار میدهد. با این قابلیت میتوانید از داخل ویرایشگر یا ترمینال خود از دستیار بخواهید سرویسی بسازد، دیپلوی کند، لاگ بگیرد یا متغیرهای محیطی را تنظیم کند — بدون آنکه دستیار مستقیماً به توکن حساب شما دسترسی مستقل داشته باشد؛ همان توکن CLI که با gerdoo login ذخیره کردهاید استفاده میشود.
راهاندازی یکدستوری
بعد از نصب CLI، کافی است gerdoo setup agent را در ریشهٔ پروژه اجرا کنید. این دستور هم فایل تنظیمات MCP را برای Claude Code، Cursor، Codex و Gemini Antigravity مینویسد و هم مهارت (Skill) use-gerdoo را نصب میکند تا دستیار بداند چطور از ابزارهای گردو استفاده کند.
مراحل راهاندازی
نصب و ورود به CLI
اگر هنوز gerdoo را نصب نکردهاید، دستور curl -fsSL https://get.gerdoo.cloud/install.sh | sh را اجرا کنید و سپس با gerdoo login وارد حساب خود شوید. سرور MCP از همین توکن ذخیرهشده استفاده میکند؛ نیازی به احراز هویت جداگانه نیست.
اتصال دستیار به گردو
در ریشهٔ پروژهای که دستیار روی آن کار میکند، دستور زیر را اجرا کنید:
gerdoo setup agentاین دستور بهصورت پیشفرض تنظیمات MCP را برای هر چهار ابزار (Claude Code، Cursor، Codex، Gemini Antigravity) مینویسد و مهارت use-gerdoo را نصب میکند. اگر فقط یکی از این ابزارها را استفاده میکنید، با فلگ --agent مشخص کنید.
تأیید اتصال
ویرایشگر یا ترمینال خود را دوباره باز کنید (یا سرورهای MCP را ریلود کنید) و از دستیار بخواهید فهرست سرویسها یا پروژههای شما را نشان دهد. اگر ابزارهای gerdoo_* در فهرست ابزارهای دستیار دیده شوند، اتصال برقرار است.
فلگهای gerdoo setup agent
gerdoo setup agent [--agent claude-code|cursor|codex|antigravity|print] [--skill-only] [--no-skill] [--global] [-y]| فلگ | توضیح |
|---|---|
--agent <name> | فقط یک ابزار مشخص را پیکربندی کنید؛ بدون این فلگ هر چهار ابزار تنظیم میشوند. مقدار print بهجای نوشتن فایل، تنظیمات را برای هر ابزار دیگری که با MCP سازگار است چاپ میکند. |
--skill-only | فقط مهارت use-gerdoo را نصب کنید، بدون تغییر تنظیمات MCP. |
--no-skill | فقط تنظیمات MCP را بنویسید، بدون نصب مهارت. |
--global | مهارت را در مسیر عمومی کاربر نصب کنید (~/.claude/skills/use-gerdoo) بهجای پوشهٔ پروژه (.claude/skills/use-gerdoo). |
اجرای دوباره این دستور بیخطر است: فایلهای موجود بازنویسی نمیشوند، فقط تنظیمات گردو در آنها بهروزرسانی میشود.
هر ابزار دقیقاً کجا پیکربندی میشود؟
| ابزار | فایل تنظیمات |
|---|---|
| Claude Code | .mcp.json در ریشهٔ پروژه؛ ورودیهای دیگر این فایل دستنخورده میمانند. |
| Cursor | .cursor/mcp.json در ریشهٔ پروژه، با همان ساختار. |
| Codex CLI | جدول [mcp_servers.gerdoo] در .codex/config.toml، بدون دستکاری بقیهٔ فایل. |
| Gemini Antigravity | .agents/mcp_config.json در ریشهٔ پروژه (فرمت مشترک IDE و CLI Antigravity). |
اگر ابزار دیگری با MCP سازگار دارید، gerdoo setup agent --agent print را اجرا کنید تا بلوک JSON لازم مستقیماً چاپ شود و خودتان آن را در تنظیمات ابزار خود قرار دهید.
دستور gerdoo mcp
اگر ترجیح میدهید تنظیمات را دستی بنویسید، سرور MCP با دستور زیر روی ورودی/خروجی استاندارد (stdio) اجرا میشود:
gerdoo mcpاین دستور معمولاً مستقیم اجرا نمیشود؛ ابزار دستیار (Claude Code، Cursor، Codex، Antigravity) آن را خودش بهعنوان زیرفرآیند اجرا میکند. تنها نکته این است که فرمان gerdoo باید در مسیر PATH همان محیطی باشد که ابزار دستیار در آن اجرا میشود.
ابزارهای در دسترس دستیار
سرور MCP گردو بیش از ۳۰ ابزار در اختیار دستیار میگذارد که تمام سطح API گردو را پوشش میدهند:
- پروژهها و محیطها: فهرست، جزئیات، ساخت پروژه و محیط جدید.
- سرویسها: فهرست، جزئیات، ساخت از ایمیج Docker، دیپلوی از پوشهٔ محلی (
gerdoo_deploy_service_source)، بهروزرسانی تنظیمات، شروع/توقف/ریاستارت. - متغیرها: هم نقشهٔ سادهٔ env و هم انبار متغیر تایپدار (build-time/secret).
- دامنهها: افزودن، تأیید و حذف دامنهٔ اختصاصی همراه با رکوردهای DNS.
- مشاهده و عیبیابی: لاگ کانتینر، فهرست بیلدها و لاگ هر بیلد، فهرست ریلیزها.
- عملیات حساس: حذف سرویس/پروژه، rollback، تعلیق سرویس — همگی نیازمند پارامتر
confirm: trueو در MCP با نشانهٔ «مخرب» (destructive) علامتگذاری شدهاند تا کلاینت پیش از اجرا از کاربر تأیید بگیرد.
دسترسی کامل حساب، نه محدود به یک پروژه
ابزارهای MCP از همان توکن کامل حساب CLI استفاده میکنند؛ یعنی دستیار به همهٔ پروژهها و سرویسهای حساب شما دسترسی دارد، نه فقط پروژهٔ فعلی. پیش از تأیید هر عملیات مخرب (حذف، rollback، تعلیق) حتماً مطمئن شوید سرویس/پروژه درست انتخاب شده است.
مهارت use-gerdoo
مهارت use-gerdoo یک راهنمای رویهای (Skill) است که همراه CLI نصب میشود و به دستیار میگوید در چه سناریویی کدام ابزار را صدا بزند: ساخت سرویس جدید، دیپلوی پوشهٔ فعلی، عیبیابی از طریق لاگ و بیلدها، مدیریت متغیرها و دامنه، و مهمتر از همه — تأکید بر اینکه دستیار پیش از هر عملیات مخرب باید صریحاً از کاربر تأیید بگیرد.
# فقط نصب مهارت، بدون تغییر تنظیمات MCP
gerdoo setup agent --skill-only
# نصب سراسری برای همهٔ پروژهها
gerdoo setup agent --skill-only --global