เริ่มต้นอย่างรวดเร็ว

เมื่อทำตามจนจบ คุณจะได้ Lamp Coffee แอปคาเฟ่ที่ขายหน้าร้านและรับจองโต๊ะ รันอยู่ที่ http://localhost:3383 โดยใช้ข้อมูลใน sandbox ของแอป แอปจะเปิดที่หน้าตั้งค่า ซึ่งแสดงข้อความ This app isn't set up yet และ coding agent ของคุณเชื่อมต่อกับ Stardeck ผ่าน MCP แล้ว

ก่อนเริ่มคัดลอกลิงก์หัวข้อ

• Node.js 20.9 ขึ้นไป พร้อม npm แอปของคุณรันบน Next.js 16 ซึ่งต้องใช้ Node.js 20.9
• git
• coding agent ขั้นตอนตั้งค่าเชื่อมต่อ Claude Code, Codex, Cursor, Gemini CLI, VS Code (GitHub Copilot) และ Windsurf ได้ หน้านี้ใช้ Claude Code เป็นตัวอย่าง
• บัญชี Stardeck หากคุณยังไม่อยู่ในองค์กรใด CLI จะสร้างองค์กรให้
• บทบาท Admin ในองค์กรที่จะเป็นเจ้าของแอป ขั้นตอนตั้งค่าจะดึง secret ของแอป ซึ่งต้องใช้บทบาทนี้ การสร้างแอปต้องมีสิทธิ์ agent:repos:write
• ไม่ต้องมีบัญชี GitHub CLI clone ด้วย token อายุสั้น หากภายหลังต้องการ push ด้วยบัญชี GitHub ของคุณเอง ดู GitHub Access

สร้างแอปคัดลอกลิงก์หัวข้อ

npx @stardeckai/cli@latest new

cd lamp-coffee
npm run dev

ตอนนี้ Lamp Coffee รันอยู่บนเครื่องของคุณแล้ว หน้าเว็บแสดง This app isn't set up yet เพราะแอป รันบนข้อมูล sandbox และจะยังปิดอยู่จนกว่าจะมีคนตั้งค่าธุรกิจ คลิก Sign in เพื่อไปที่ Let's set up your business หรือตั้งค่าจาก terminal

ให้ agent ทำให้คัดลอกลิงก์หัวข้อ

วางข้อความนี้ให้ coding agent ของคุณ ในโฟลเดอร์ที่จะเก็บแอป:

Create a Stardeck app for Lamp Coffee, a café that sells at the counter and takes table bookings.
Read https://docs.stardeck.ai/quickstart.md and follow its agent steps.
Show me what you'll create and wait for my yes. Never commit .env.local or print its values.

ขั้นตอนสำหรับ agentคัดลอกลิงก์หัวข้อ

สำหรับ agent: ทำตามขั้นตอนเหล่านี้ตามลำดับเพื่อสร้างแอปให้ผู้ใช้ clone แล้วรัน รันทุกคำสั่งด้วยตัวเอง หยุดและส่งต่อให้ผู้ใช้เฉพาะขั้นตอนที่ระบุว่า Person ซึ่งผู้ใช้ต้องเข้าสู่ระบบ อนุมัติสิ่งที่จะสร้าง และอนุญาตการเชื่อมต่อ MCP ห้าม commit .env.local และห้ามพิมพ์ค่าในไฟล์นั้น

1. ตรวจสอบเครื่องมือ Node.js ต้องเป็นเวอร์ชัน 20.9 ขึ้นไป หากเก่ากว่านั้นหรือไม่มี ให้ขอให้ผู้ใช้ ติดตั้งแล้วหยุด

   คัดลอกข้อความ

   node --version
   npm --version
   git --version

2. ตรวจสอบการเข้าสู่ระบบ

   คัดลอกข้อความ

   npx @stardeckai/cli@latest whoami

   หากแสดง Not logged in ให้รัน npx @stardeckai/cli@latest login คำสั่งนี้จะเปิดเบราว์เซอร์และ แสดงลิงก์ Person: ขอให้ผู้ใช้เข้าสู่ระบบให้เสร็จภายใน 5 นาที แล้วรัน whoami อีกครั้ง คำสั่งจะแสดงองค์กรของผู้ใช้ในรูป Name (slug)

3. ตกลงเรื่องแอป Person: ถามชื่อแอปและ slug ขององค์กรจาก whoami หากยังไม่มีองค์กร ให้ถามชื่อสำหรับองค์กรใหม่ ถามว่าแอปควรเริ่มต้นด้วยอะไร และ แสดงคำสั่งในขั้นที่ 4 ให้ผู้ใช้ดูก่อนรัน รันเมื่อผู้ใช้ตอบ yes เท่านั้น สำหรับคาเฟ่ อย่าง Lamp Coffee ที่ขายหน้าร้านและรับจอง ให้ใช้ starting pack Booking พร้อม Register ซึ่งก็คือรายการ --modules ด้านล่าง หากไม่ใส่ --modules CLI จะใช้ starting pack แรก คือ E-commerce

4. สร้าง clone และตั้งค่าแอป แทนที่ <org-slug> และเปลี่ยน claude-code เป็น id ของ agent คุณ หากไม่ใช่ Claude Code (codex, cursor, gemini-cli, vscode หรือ windsurf)

   คัดลอกข้อความ

   npx @stardeckai/cli@latest new lamp-coffee --name "Lamp Coffee" --org <org-slug> \
     --modules booking,website,pos,account,audit-log,branches,catalog,customers,finance,inventory,outbox,staff,tour \
     --agents claude-code --yes

   • หากผู้ใช้อยู่ในองค์กรเดียว จะไม่ใส่ --org ก็ได้ สำหรับองค์กรใหม่ ให้ใช้ --new-org "<name>" แทน
   • หากผู้ใช้ไม่มีบทบาท Admin คำสั่งจะหยุดก่อนสร้างอะไรและแจ้งว่าขั้นตอนตั้งค่าต้องใช้บทบาทนี้ ให้แจ้งผู้ใช้ ใส่ --no-setup เฉพาะเมื่อผู้ใช้ยอมให้ clone โดยไม่มี environment
   • เมื่อสำเร็จ จะแสดง Created Lamp Coffee (lamp-coffee) และ Cloned into … รัน npm install เพิ่ม MCP server stardeck-<org-slug> ลงในไฟล์ตั้งค่าของ agent และเขียน apps/web/.env.local บรรทัดสุดท้ายคือ Open it in Stardeck: <url> สำหรับองค์กรใหม่ จะมีข้อความให้เลือกแพ็กเกจด้วย ให้แจ้งผู้ใช้ตามนั้น

5. อนุญาตการเข้าถึงของ MCP server Person: สำหรับ Claude Code เซิร์ฟเวอร์อยู่ใน lamp-coffee/.mcp.json ซึ่ง Claude Code อ่านจากโฟลเดอร์ที่เริ่มทำงาน ขอให้ผู้ใช้เริ่ม Claude Code ใน lamp-coffee/ (หรือรีสตาร์ตที่นั่น) รัน /mcp เลือก stardeck-<org-slug> เลือก Authenticate แล้วเข้าสู่ระบบ สำหรับ agent อื่น ให้บอกขั้นตอนที่ขั้นตอนตั้งค่าแสดงไว้ใต้ Authorize the MCP connection จากนั้นเรียกเครื่องมือ whoAmI ของ Stardeck เพื่อตรวจสอบ การเชื่อมต่อ หากข้ามขั้นตอนตั้งค่าไป ให้เพิ่มเซิร์ฟเวอร์เอง:

   คัดลอกข้อความ

   claude mcp add --scope user --transport http stardeck https://www.stardeck.ai/api/mcp

6. เริ่มแอปในเบื้องหลัง

   คัดลอกข้อความ

   cd lamp-coffee
   npm run dev

   แอปให้บริการที่ http://localhost:3383

7. ตรวจสอบ จาก lamp-coffee/apps/web:

   คัดลอกข้อความ

   npm run setup:app -- status

   แอปใหม่จะแสดง setUp=false หมายความว่าแอปอ่านข้อมูล sandbox และยังไม่ได้ตั้งค่า Person: ขอให้ ผู้ใช้เปิด http://localhost:3383 ซึ่งควรเห็น This app isn't set up yet นั่นคือการรันครั้งแรกที่เสร็จสมบูรณ์

8. ตั้งค่าแอปเมื่อผู้ใช้ขอเท่านั้น โดยใช้คำสั่งใน ตั้งค่าแอป สำหรับแอปใหม่ คำสั่งเหล่านี้เปลี่ยนข้อมูลที่จะใช้งานจริง จึงต้องยืนยัน รายละเอียดธุรกิจกับผู้ใช้ก่อน

ตั้งค่าแอปคัดลอกลิงก์หัวข้อ

แอปใหม่จะเปิดที่หน้าตั้งค่าจนกว่าจะมีคนตั้งค่า ทำได้ในเบราว์เซอร์ (Sign in แล้ว Set up my business แล้ว Restaurant or café สำหรับ Lamp Coffee) หรือจากโฟลเดอร์ apps/web ของแอป:

npm run setup:app -- status
npm run setup:app -- sample restaurant
npm run setup:app -- business --type restaurant --name-en "Lamp Coffee" \
  --address "45 Soi Ari 1, Bangkok 10400" --currency THB --timezone Asia/Bangkok

• status แสดงประเภทธุรกิจ ธุรกิจตัวอย่าง และรายละเอียดธุรกิจที่แอปรองรับ
• sample โหลดธุรกิจตัวอย่างให้ลองดู คำสั่งนี้จะถูกปฏิเสธเมื่อแอปมีข้อมูลของตัวเองแล้ว
• business เลือกประเภทธุรกิจของคุณและบันทึกรายละเอียด

ไม่ว่าจะทำวิธีไหน แอปจะเปิดใช้งานตามปกติหลังจากนั้น สคริปต์เขียนข้อมูล sandbox ที่แอปบนเครื่องของคุณ ใช้ sandbox และ production ของแอปใหม่ใช้ฐานข้อมูลเดียวกันจนกว่าจะแยกกัน ดังนั้นสำหรับแอปใหม่ นี่คือข้อมูลที่จะใช้งานจริงด้วย หากไม่มีสำเนาบนเครื่อง เครื่องมือ MCP set_up_blueprint_app ของ agent ทำสิ่งเดียวกันนี้ใน cloud sandbox ของแอปได้ สำหรับข้อมูลที่ใช้ร่วมกับ production เครื่องมือนี้จะตั้งค่าเฉพาะแอปที่ยังไม่มีใครตั้งค่า และปล่อยให้การแก้รายละเอียดของธุรกิจที่ตั้งค่าแล้วเป็นหน้าที่ของ Settings

ทำงานกับแอปที่มีอยู่แล้วคัดลอกลิงก์หัวข้อ

ให้ admin เพิ่มบัญชี GitHub ของคุณที่ Settings → Repository → Repository access (ดู GitHub Access) จากนั้น clone repository แล้วรัน:

npm install
npm run setup

จากนั้นอนุญาตการเข้าถึงของ MCP server ใน agent ของคุณ (/mcp ใน Claude Code) แล้วรัน npm run dev หาก repository ไม่มี stardeck.project.json ให้รัน npx @stardeckai/cli link --project <slug> หนึ่งครั้ง แล้ว commit ไฟล์นั้น ดู Link an app to its project

ตัวเลือกของ newคัดลอกลิงก์หัวข้อ

new จะถามทุกอย่างที่คุณไม่ได้ส่งมา หากไม่มี terminal ต้องใส่ --yes และ --org หรือ --new-org ยกเว้นคุณอยู่ในองค์กรเดียว

ขั้นตอนตั้งค่าคือ npm run setup ตัวเดียวกับที่คุณรันในแอปที่มีอยู่แล้ว agent ของคุณยังสร้างแอปได้ด้วยเครื่องมือ MCP create_app และ get_repo_access

ส่งการเปลี่ยนแปลงขึ้นใช้งานคัดลอกลิงก์หัวข้อ

push branch, deploy เป็น preview แล้ว merge pull request เข้า main และ deploy production ดู การทำงานร่วมกับ Stardeck agent