چگونه یک اپلیکیشن را از Claude Code منتشر کنیم

اپلیکیشن خود را در یک نشست از Claude Code منتشر کنید: اتصال Fine Structure از راه MCP یا پلاگین متن‌باز، سپس میزبانی، پایگاه داده، احراز هویت و دامنه اختصاصی.

این راهنما برای چه کسانی است

سازندگانی که در Claude Code کار می‌کنند و می‌خواهند پروژه‌ای که همین حالا ساخته‌اند بالا بیاید، با میزبانی، داده و احراز هویت آماده.

در پایان چه خواهید داشت

- یک مسیر انتشار کارآمد از Claude Code تا یک URL زنده در یک نشست

- تصویری روشن از آنچه پلتفرم برایتان میزبانی می‌کند: صفحه‌ها، پایگاه داده، احراز هویت و دامنه

- یک آزمون صادقانه برای اینکه کی هاست استاتیک انتخاب بهتری است

انتشار از Claude Code در عمل یعنی چه؟

برای انتشار اپلیکیشن از Claude Code باید Claude را به یک runtime وصل کنید که بتواند آن را میزبانی کند. در Fine Structure دو راه ورود دارید: نشانی https://finestructure.ai/api/mcp را در تنظیمات claude.ai به عنوان کانکتور سفارشی اضافه کنید و صفحه OAuth را تأیید کنید، یا پلاگین متن‌باز را با /plugin marketplace add finestructure-ai/claude-plugin و سپس /plugin install finestructure@finestructure نصب کنید. از آن پس Claude یا با create_app یک اپلیکیشن کامل می‌سازد، یا پروژه موجود شما را فایل به فایل به runtime پلتفرم منتقل می‌کند، و نتیجه به شکل صفحه‌های React میزبانی‌شده با پایگاه داده مدیریت‌شده، احراز هویت، دامنه اختصاصی و بازگشت به نسخه ذخیره‌شده اجرا می‌شود. طرح رایگان کارت بانکی نمی‌خواهد: ساخت اپلیکیشن اعتبار مصرف می‌کند، اما ویرایش، انتشار و دامنه رایگان است.

Claude Code در ساختن اپلیکیشن بسیار خوب است و در اجرای آن کاملاً ناتوان. نشست که تمام می‌شود، یک پوشه روی دیسک می‌ماند: کامپوننت‌های React، یک مدل داده که هنگام گفت‌وگو شکل گرفته، و یک مسیر احراز هویت که در سکوت فرض می‌کند سروری وجود دارد. انتشار همان لحظه‌ای است که این پوشه یک URL می‌گیرد، یک پایگاه داده پشت سرش می‌نشیند و ورودی پیدا می‌کند که برای آدم‌های دیگر هم کار کند.

پاسخ معمول به این مرحله لوله‌کشی است: کد را به یک repository بفرست، CI را وصل کن، جای دیگری پایگاه داده بالا بیاور، سرویس احراز هویت اضافه کن، DNS را تنظیم کن و منتظر گواهی‌ها بمان. هر تکه به تنهایی منطقی است و جمعشان یک بعدازظهر کامل. پاسخ دوم این است که به Claude Code دسترسی مستقیم به runtime بدهید که همه این تکه‌ها را از پیش دارد، تا انتشار به یک فراخوانی ابزار در همان گفت‌وگو تبدیل شود.

بیان صادقانه ماجرا: پلتفرم ما یک دکمه دیپلوی نیست که روی استک فعلی شما پیچ شده باشد. یک runtime است و اپلیکیشن به داخل آن نقل مکان می‌کند. این یک معامله واقعی است: میزبانی، پایگاه داده، احراز هویت و دامنه را بدون سرهم‌بندی می‌گیرید و در عوض کنترل لایه سرور را واگذار می‌کنید.

چطور Claude را به Fine Structure وصل کنیم؟

دو مسیر، یک مقصد: همان حساب و همان اپلیکیشن‌ها. اگر بیشتر کارتان در claude.ai می‌گذرد کانکتور را انتخاب کنید. اگر در ترمینال زندگی می‌کنید و می‌خواهید دستورهای انتشار کنار کدتان باشد، پلاگین را بردارید.

مسیر اول: کانکتور MCP: در claude.ai تنظیمات را باز کنید، گزینه Add custom connector را انتخاب کنید، نشانی https://finestructure.ai/api/mcp را جای‌گذاری کنید و صفحه OAuth را تأیید کنید. یک کلیک، بدون API key و بدون متغیر محیطی که تا ابد در یک فایل تنظیمات بماند. از آن پس Claude حدود ۷۰ ابزار می‌بیند: ساخت اپلیکیشن، نوشتن فایل، entities، انتشار، دامنه و آنالیتیکس.

مسیر دوم: پلاگین متن‌باز Claude Code: دستور /plugin marketplace add finestructure-ai/claude-plugin و سپس /plugin install finestructure@finestructure را اجرا کنید. این کار /deploy و /fs-status و /fs-domain را به نشست شما اضافه می‌کند. کد عمومی است، پس پیش از نصب می‌توانید بخوانید چه چیزی ارسال می‌کند و به یک توضیح بسنده نکنید.

درباره فهرست‌های دایرکتوری: درخواست‌های ثبت ما در دایرکتوری‌ها در حال بررسی است. تا پایان این بررسی، کانکتور یا پلاگین را رسمی، تأییدشده یا فهرست‌شده نمی‌خوانیم. دلیل نصبشان این است که نشانی عمومی و کد خواندنی است، نه نشانی که کنار نامشان بنشیند.

Claude اپلیکیشن تازه بسازد یا پروژه موجود شما را منتقل کند؟

دو حالت انتشار وجود دارد. یکی از یک جمله شروع می‌شود: create_app یک توضیح متنی می‌گیرد و اپلیکیشن کاملی با صفحه‌ها، اسکیمای entities، اتصال احراز هویت و یک URL کارآمد تحویل می‌دهد. این مسیر سریع است وقتی ایده هنوز خام است و سریع‌ترین راه فهمیدنش نگاه کردن به آن است. تولید اعتبار مصرف می‌کند و تنها بخش اندازه‌گیری‌شده این جریان است.

حالت دوم پروژه‌ای را که دارید منتقل می‌کند. Claude فایل‌های شما را می‌خواند و یکی‌یکی داخل runtime پلتفرم بازنویسی می‌کند: صفحه‌ها به صفحه‌های پلتفرم تبدیل می‌شوند، مدل داده به entities و فراخوانی‌های احراز هویت به احراز هویت پلتفرم. این یک انتقال است، نه یک آپلود کورکورانه. هر فایلی که فرض کرده بود سروری در کنترل شماست، مقابل runtime بازنویسی می‌شود و دقیقاً همین‌جاست که Claude Code ارزش خود را نشان می‌دهد.

یک نشست اول واقعی چه شکلی است: از Claude بخواهید اپلیکیشن را بسازد، پیش‌نمایش را باز کنید، و در همان گفت‌وگو فایل‌ها را ویرایش کنید تا صفحه‌ها همان چیزی شوند که در ذهن داشتید. ویرایش فایل و انتشار اعتبار مصرف نمی‌کند، پس حلقه بهبود پس از تولید رایگان است. وقتی همه چیز درست به نظر رسید، منتشر کنید، دامنه وصل کنید و بگذارید TLS خودش حل شود.

این روش در مقایسه با هاست استاتیک چگونه است؟

هاست‌های استاتیک در کار خودشان بسیار خوب‌اند. اگر خروجی شما فقط یک باندل فرانت‌اند است، آنجا سریع‌تر، ارزان‌تر و با اکوسیستمی بزرگ‌تر از ما سرو می‌شود. مقایسه تازه وقتی جالب می‌شود که اپلیکیشن به state، به کاربر و به راهی برای بازگشت نیاز پیدا کند.

اپلیکیشن به چه نیاز دارد | Fine Structure | مقصد انتشار استاتیک

میزبانی | صفحه‌های React میزبانی‌شده از runtime پلتفرم | بهترین سرعت خام فرانت‌اند، گسترده‌ترین اکوسیستم

پایگاه داده | entities مدیریت‌شده، آماده پیش از نخستین انتشار | خودتان بیاورید و جداگانه راه بیندازید

احراز هویت | داخلی، با session و کاربر مخصوص هر اپلیکیشن | سرویس یا ارائه‌دهنده احراز هویت خودتان را بیاورید

دامنه | دامنه اختصاصی با TLS خودکار | دامنه اختصاصی با TLS خودکار، جریانی پخته

بازگشت به عقب | بازیابی یک نسخه ذخیره‌شده از اپلیکیشن | انتشار دوباره یک build قدیمی‌تر یا برگرداندن commit

ایجنت‌ها | ایجنت‌های AI که طبق زمان‌بندی به کار ادامه می‌دهند | شامل نمی‌شود، جای دیگری اجرایشان کنید

کجا ما انتخاب درستی نیستیم: سه حالت که ابزار دیگری بهتر است و ما رک می‌گوییم. runtime سرور اختصاصی که باید مال خودتان باشد، مثل یک باینری Go یا یک worker Python با کتابخانه‌های سیستمی مشخص. یک monorepo با بک‌اند خودش که قرار نیست بازنویسی شود. و هاست استاتیک خالص در مقیاس بزرگ، جایی که یک CDN بدون پایگاه داده برنده است.

پس از نخستین انتشار چه چیزی به دست می‌آورید؟

انتشار پایان کار نیست. نقطه‌ای است که اپلیکیشن به جای نظر، واقعیت تولید می‌کند. چهار چیز آنجا باز می‌شود و هیچ‌کدام نیاز ندارد از گفت‌وگو بیرون بیایید.

ایجنت‌ها همان بخشی هستند که مردم را غافلگیر می‌کنند. ایجنت اینجا یک ویجت چت چسبانده روی صفحه نیست. کارگری است متصل به اپلیکیشن که پس از بستن لپ‌تاپ هم طبق زمان‌بندی می‌چرخد، داده‌های خود اپلیکیشن را می‌خواند و می‌تواند به مالک تأییدشده‌اش در WhatsApp یا با ایمیل پیام بدهد. اپلیکیشن به شما می‌گوید چیزی رخ داده، به جای اینکه منتظر بماند سر بزنید.

هر چه پس از تولید می‌آید در همان نشست Claude می‌ماند: فایلی را تغییر بدهید، منتشر کنید، دامنه را بررسی کنید، آنالیتیکس را بخوانید، ایجنتی را تنظیم کنید. طرح رایگان کارت بانکی نمی‌خواهد، پس راه صادقانه ارزیابی این است که Claude را به یک اپلیکیشن واقعی و کوچک بسپارید و ببینید تا کجا پیش می‌رود.

پرسش‌های متداول

آیا Claude Code به تنهایی می‌تواند اپلیکیشن را منتشر کند؟

به تنهایی نه. Claude Code فایل می‌نویسد و ویرایش می‌کند و به مقصدی نیاز دارد که بتواند میزبانشان باشد. کانکتور MCP ما را اضافه کنید یا پلاگین را نصب کنید تا انتشار به یک فراخوانی ابزار تبدیل شود: ساخت اپلیکیشن، نوشتن فایل‌ها، انتشار و اتصال دامنه.

نشانی سرور MCP در Fine Structure چیست؟

https://finestructure.ai/api/mcp. در claude.ai تنظیمات را باز کنید، Add custom connector را انتخاب کنید، این نشانی را جای‌گذاری کنید و صفحه OAuth را تأیید کنید. API key برای کپی کردن وجود ندارد و از آن پس Claude حدود ۷۰ ابزار می‌بیند.

پلاگین انتشار Claude Code را چگونه نصب کنم؟

دستور /plugin marketplace add finestructure-ai/claude-plugin و سپس /plugin install finestructure@finestructure را اجرا کنید. /deploy و /fs-status و /fs-domain را می‌گیرید. پلاگین متن‌باز است و درخواست‌های ثبت ما در دایرکتوری‌ها در حال بررسی است، پس ادعای وضعیت رسمی نداریم.

طرح رایگان دارید و آیا کارت بانکی لازم است؟

طرح رایگان هست و کارت بانکی نمی‌خواهد. ساخت اپلیکیشن اعتبار مصرف می‌کند. ویرایش فایل، انتشار و دامنه اختصاصی مصرف نمی‌کنند.

می‌توانم به جای ساخت اپلیکیشن تازه، پروژه React موجودم را منتشر کنم؟

بله. Claude آن را فایل به فایل به runtime پلتفرم منتقل می‌کند: صفحه‌ها به صفحه‌های پلتفرم تبدیل می‌شوند، مدل داده به entities و فراخوانی‌های احراز هویت بازنویسی می‌شوند. این انتقال است نه آپلود، پس انتظار داشته باشید شکل فایل‌ها عوض شود.

آیا پلتفرم HTTPS و دامنه اختصاصی را مدیریت می‌کند؟

بله. دامنه اختصاصی را اضافه کنید و TLS به صورت خودکار صادر می‌شود. از ترمینال /fs-domain را اجرا کنید، یا از Claude از راه کانکتور MCP بخواهید.

اگر یک انتشار اپلیکیشن را خراب کند چه کنم؟

یک نسخه ذخیره‌شده را بازیابی کنید. بازگشت، اپلیکیشن را به وضعیت ذخیره‌شده قبلی برمی‌گرداند که معمولاً سریع‌تر از تشخیص یک تغییر در محیط پروداکشن است و یک مبنای کارآمد به شما می‌دهد.

کی این ابزار درستی برای کار نیست؟

وقتی به runtime سرور اختصاصی نیاز دارید که باید مال خودتان باشد، مثل یک باینری Go یا یک worker Python با کتابخانه‌های سیستمی مشخص. وقتی یک monorepo بک‌اند خودش را نگه می‌دارد. یا وقتی هاست استاتیک خالص در مقیاس بزرگ می‌خواهید، جایی که یک CDN بدون پایگاه داده برنده است.