Supero
What it does
Build and deploy multi-tenant apps from ChatGPT, Claude or your editor. Sign in with OAuth or a key.
- Connects 클라우드에서 실행
- Account or key Sign in to the service when you connect (OAuth)
- Category 개발자 도구
설치
쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.
검사 6/6 통과 · 내가 묻는 내용은 제작자 서버(mcp.supero.dev)를 거쳐요
먼저: 어떤 AI를 쓰시나요?
쓰는 앱을 고르면 아래에 단계가 나옵니다.
Claude에 연결할 수 있어요 · 약 2분
키 필요 없음, 설치 필요 없음 · claude.ai나 데스크톱 앱에서 한 번 설정하면 채팅에서 쓸 수 있어요 · 무료 계정은 1개까지 · Team/Enterprise는 소유자(Owner)가 추가
Claude의 Connectors 페이지 열기
CustomizeConnectors
“+ Add” → “Add custom connector”를 누르고 이 2칸 채우기
여기서 복사해 Claude의 같은 이름 칸에 붙여 넣고 Continue를 누르세요
Name · 이름SuperoRemote MCP server URL · 주소https://mcp.supero.dev/mcpAuthentication은 Claude가 찾은 그대로 두고 Add를 누르세요
채팅에서 켜기
+ConnectorsSupero
해 보기
Supero을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Claude가 Supero을 쓰고 있다고 하거나 답에 Supero 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
ChatGPT는 기업용 요금제에서만 연결돼요
웹의 ChatGPT Business, Enterprise, Edu에서 워크스페이스 관리자나 소유자가 추가해요 · Free, Plus, Pro를 쓰면: 내 ChatGPT 요금제로는 아직 MCP를 직접 연결할 수 없어요
웹 ChatGPT에서 MCP 추가 페이지 열기
Plugins+Add custom MCP server
이름과 주소 입력
이름을 넣고 Connection에 주소를 붙여 넣은 뒤 경고에 체크하고 Create as a plugin을 누르세요
Name · 이름SuperoConnection · 주소https://mcp.supero.dev/mcp채팅에서 Supero 고르기
새 채팅을 열고 입력 전에 플러그인 목록에서 Supero을 고르세요
해 보기
Supero을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ ChatGPT가 Supero을 쓰고 있다고 하거나 답에 Supero 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 OpenAI 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
Claude Code에 연결할 수 있어요 · 약 2분
키 필요 없음, 설치 필요 없음
터미널 열기
Mac: Command+스페이스를 누르고 Terminal 입력 · Windows: PowerShell 열기
이 명령을 붙여 넣고 Enter
claude mcp add --transport http --scope user supero https://mcp.supero.dev/mcpClaude Code에서 /mcp 입력
Supero이 목록에 있고 연결됨으로 보이면 돼요
해 보기
Supero을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Claude Code가 Supero을 쓰고 있다고 하거나 답에 Supero 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
Cursor에 연결할 수 있어요 · 약 2분
키 필요 없음, 설치 필요 없음
Cursor에서 AI 채팅을 Agent 모드로 열기
해 보기
Supero을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Cursor가 Supero을 쓰고 있다고 하거나 답에 Supero 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 Cursor 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
VS Code에 연결할 수 있어요 · 약 2분
키 필요 없음, 설치 필요 없음
VS Code에서 AI 채팅을 Agent 모드로 열기
해 보기
Supero을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ VS Code가 Supero을 쓰고 있다고 하거나 답에 Supero 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 VS Code 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
Windsurf, Zed, Gemini CLI 같은 다른 MCP 앱은 추가 방법이 저마다 달라요. 앱 목록에서 확인하세요
웹으로 연결하는 앱용 주소
https://mcp.supero.dev/mcpJSON 설정은 아래 “개발자용”에 있어요
개발자용: 터미널 명령과 JSON 설정
웹으로 연결
Claude Code
claude mcp add --transport http --scope user supero https://mcp.supero.dev/mcpCursor (~/.cursor/mcp.json)
{
"mcpServers": {
"supero": {
"url": "https://mcp.supero.dev/mcp"
}
}
}VS Code (mcp.json)
{
"servers": {
"supero": {
"type": "http",
"url": "https://mcp.supero.dev/mcp"
}
}
}이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.
한눈에 보기
어떤 앱에서 쓸 수 있나요
이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.
인터넷으로 연결하는 앱
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
할 수 있는 일
도구 이름과 설명은 서버가 2026년 11월 8일에 알려 준 그대로예요. 우리가 아니라 제작자가 쓴 글이고, 일반 텍스트로만 보여 드려요.
build_get_skillsFetch a Supero build reference. doc='skills' (default, the spec you MUST follow) | 'components' (the real pre-built SDK component/global catalog — read so you don't reinvent UI) | 'rubric' (the rich-app quality checklist — what 'stunning' means) | 'landing' (compact landing-page
build_get_examplesFetch a COMPLETE, production-quality reference app (schemas.py + config.py + setup.py + ui/app.js) to copy patterns from — the single biggest lever for app quality. archetype='index' (default) lists the available archetypes with per-file byte sizes; pick the one closest to your a
build_planPLAN FIRST — turn a one-line app idea into an explicit BUILD CHECKLIST before you author anything, so a thin prompt doesn't silently skip what expert builders add (this is exactly why first-draft apps miss detail pages, tenant pickers, seed data). Deterministic, no LLM: it detect
build_get_service_contractFetch the AUTHORITATIVE contract for a transactional/stateful platform service (cart, order, payment, booking, appointment, membership, approval, document_signature, recurring_plan, inventory, task, ticket, loyalty_points, rental, comment, attachment, feedback, notification, prod
build_whoamiResolve your API key's scope: role (domain_admin/project_admin), domain, whether you can create projects, and your plan. Call this to decide the flow.
build_list_projectsList projects you can build into (uuid, name, schema_namespace, live_url).
build_get_projectGet one project's details: schema_namespace (use this EXACT value as the `namespace` literal on every schema dict), last published version, AND the captured `project_intent` — the brief (project_description/summary), the discovered data model (entities/central_entity/relationship
build_create_projectCreate a NEW project (domain-admin keys only; plan-gated). Mints the project's schema_namespace + an API key (returned ONCE). Use for a fresh app.
build_update_projectUpdate a project's metadata (display_name, description, show_public, live_url).
build_set_project_modeSet a project's build mode. 'dev' (default) allows COMPLETE REPLACE (wipe data, keep credentials); 'live' protects it. Switch to dev before replacing, to live when it's in production.
build_replace_projectDESTRUCTIVE (DOMAIN-admin keys only): completely replace a DEV-mode project's app — wipes its data (retains credentials, API keys, namespace, tenant). Refused if mode='live'. Requires confirm_project_name to match. If you pass files, they are VALIDATED before any wipe (a bad bund
build_validateValidate a locally-authored bundle against the live platform BEFORE publishing. AST-only (your code is never executed). Checks manifest, syntax, import-safety, config exports, schema validity, and namespace==project schema_namespace.
build_publishPackage + upload your authored bundle and record a version under the project. Returns version_uuid + file_id + download_url. Runs build_validate first; force=true overrides soft errors only. Provide files as {relative_path: content}.
build_stage_bundlePUB-1a: get the out-of-band UPLOAD endpoint for a LARGE app bundle that won't fit inline (the model's max OUTPUT tokens cap `files`/`files_b64gz`, so big apps otherwise have to be truncated/minified). Upload a gzip(json {path:content}) blob to the returned URL with your OWN key,
build_get_bundleFetch the CURRENT (or a given) PUBLISHED bundle: the file list + a signed download_url, or ONE file's content inline via file=. For ANY change request on an existing app, START from this bundle and modify it — re-authoring from scratch silently drops the hand-authored ui/app.js a
build_deployDeploy a published version. target='cloud_ephemeral' (managed Cloud Run, ~30m throwaway preview; requires platform enablement; the default when cloud deploy is enabled) or 'local' (hand the user the bundle to run with the project's own key). For a PERMANENT public URL, use build_
build_deploy_statusPoll a cloud deploy started by build_deploy or build_go_live. Pass the poll_url it returned. Reports elapsed_s since launch. 'launching' for 5-6.5 minutes is normal (Cloud Run IAM propagation): keep polling every ~30s and probe the url once it appears. Only a persistent unreachab
build_logsFetch recent Cloud Run logs for a project's deployed app — THE tool for diagnosing a failed/stalled cloud deploy or a crashing app (startup-probe timeouts, tracebacks, 'container failed to start on PORT'). Read-only; rate-limited per domain.
build_go_livePERMANENT deploy: promote a published version to a PERMANENT public URL at .supero.live (managed Cloud Run) — unlike build_deploy(target='cloud_ephemeral'), which is a ~30-min throwaway. If version_uuid/file_id are omitted, the latest published version for the project is used. Re
build_teardownTear down a project's live deployment — BOTH the permanent (build_go_live) app and the ephemeral preview — DELETEing the managed Cloud Run services and freeing their URLs. Idempotent: a project with nothing deployed returns stopped=true. ONLY manages Supero-hosted apps — a projec
build_list_capabilitiesList the platform's available services/integrations from the LIVE catalog (email, sms, slack, ai, stripe_checkout, google_oauth, push_notification, …) — so the intake's 'which connections/integrations?' question is accurate and you never guess a service id. Returns each service's
build_recommend_integrationsRECOMMEND which concrete provider integrations this app needs, and WHY — the deterministic Step-2 intelligence the web wizard uses, now over MCP. Pass the app `description` + the platform `service_ids` it will use (e.g. ['cart','order']); returns GROUPED, TIERED suggestions (requ
build_configure_servicesConfigure a service's keys for the project so an integration works at deploy (e.g. wire SendGrid for email, a Stripe TEST key for checkout). TEST/SANDBOX keys ONLY. Keys with a clear live marker (Stripe sk_live_… / Razorpay rzp_live_…) are auto-refused, but most providers give NO
build_import_servicesIMPORT platform services into a project (e.g. 'workflows', 'email', 'stripe_checkout', 'cart', 'order', 'payment') so the app can call them and its event-bound workflows can run. Uses the platform's service import with YOUR connection's credential. Reports each service's exact ou
build_doctorPREFLIGHT a bundle BEFORE publish/deploy — catches the silent deploy-killers build_validate does NOT: missing #supero-preloader removal (app stuck on a spinner forever), heavy startup seed (Cloud Run port-bind timeout → 'container failed to start'), reserved field names like stat
build_auditSECURITY + CORRECTNESS AUDIT of a bundle BEFORE go-live (static; your code is never executed). Finds what build_validate/build_doctor do not: MONEY-01 client-chosen checkout amounts, AUTHZ-01 end-users able to write server-owned fields (paid/issued/status/amount/payment refs) or
build_verifyACCEPTANCE TEST of your app's running PREVIEW (after build_deploy, before build_go_live). Where build_audit reads the code, build_verify USES the deployed preview like a buyer would, with throwaway test accounts (verify- @example.com, deleted afterwards): health (serves, app.js =
build_smoke_testVERIFY a DEPLOYED app actually works (not just 'running'). HTTP-checks the live URL: root loads with a title, app.js is your bundle (not a stub) and dismisses the boot splash, config.js namespace matches the project; optionally logs in and reads an entity to confirm data + no nam
build_e2e_testRun the FULL behavioural test suite against a PUBLISHED bundle in the project's OWN already-deployed app (no throwaway project is created) — auth/RBAC/multi-tenant, CRUD round-trips, workflows + event emission, services, aggregates, real-browser UI. WRITE-SAFE: on a DEV project t
build_e2e_test_statusPoll an e2e run started by build_e2e_test. While running, returns status only. When complete, returns a compact report: verdict (honest — never 'healthy' if a core suite couldn't run), per-suite pass/fail/warn/skip, findings with layer + fix hint, what was/wasn't covered, and nex
build_list_data_sourcesList the external DATA SOURCE types an app can connect to — its own Postgres/MySQL/MSSQL/Oracle/MongoDB, any REST API, or a Snowflake/BigQuery/Redshift/Databricks/ClickHouse/Fabric warehouse — plus the curated public-API catalog. Read this to offer a 'connect your own data' optio
build_connect_data_sourceCreate a data connector to an EXTERNAL source the app owner controls (their own database, a REST API, or a warehouse). Returns a connector_id. Does NOT bind schemas yet. Flow: build_connect_data_source → build_discover_source (lists the tables/streams; needs this connector_id) →
build_discover_sourceDiscover a connector's schema: trigger discovery, wait, and return the source streams (names, columns, primary keys), AI-inferred Supero schemas, field mappings, and a suggested namespace. Run AFTER build_connect_data_source and BEFORE build_bind_data_source (a live bind's `sourc
build_bind_data_sourceBind source streams to the app's schemas. mode='live_read' (default: read-only BYODB / warehouse), 'live_readwrite' (BYODB read+write, DOMAIN-ADMIN only), or 'sync' (copy into SuperoDB). Modes by source: postgresql, supabase, mysql take all three; mssql takes sync and live_read;
build_run_data_sourceTrigger a SYNC RUN on a data connector and return the run id. MCP-created connectors are trigger:manual, so a mode='sync' binding copies NO rows until a run executes — call this after build_bind_data_source (and again whenever the source data changes). Live-read/warehouse binding
build_list_bound_schemasClassify this project's schemas: which are connector-backed vs app-authored, and each one's access mode (sync | live-ro | live-rw | warehouse). Use it so you DON'T render create/edit UI for read-only live sources (live-ro/warehouse) or regenerate/overwrite connector-discovered sc
crud_searchSearch/list objects of any type in the current domain. Use schema_list first to discover available object types. System types: project, tenant, user_account, api_key, connector, audit_log, schema_registry, client_sdk, connector_execution, connector_plugin. Domain types vary per d
crud_getGet a specific object by UUID from the current domain.
crud_createCreate a new object in the current domain. Use schema_list to see available types and their fields.
crud_updateUpdate an existing object in the current domain.
crud_deleteDelete an object from the current domain.
schema_listList all existing schemas in the current domain.
schema_getGet full details of a specific schema by UUID. Returns the complete schema definition including all attributes and metadata.
schema_validateValidate schemas before saving. Checks for conflicts with existing schemas, circular dependencies, reserved names, and parent_type correctness. Always validate before saving!
schema_saveSave/upload schemas into a project. Schemas are validated before saving and linked to the project. Returns the saved schemas with their UUIDs; skipped schemas carry the platform's reason. IMPORTANT: Pass FLAT schema objects directly — do NOT wrap in schema_content. The tool handl
schema_deleteDelete a schema from the domain. Use with caution.
schema_list_projectList schemas linked to the current project.
schema_updateUpdate an existing schema definition.
project_link_schemasLink schemas to a project. Accepts schema UUIDs or names.
sdk_generateGenerate client SDKs for the domain's schemas.
sdk_statusCheck SDK generation request status.
sdk_listList available SDKs for the current domain.
sdk_downloadGet download URL for an SDK.
rbac_get_my_accessGet current user's role, permissions, and scope.
rbac_check_permissionCheck if the current user has a specific permission.
apikey_get_scopeGet the scope and permissions of the current API key.
connector_runTrigger a manual connector sync execution.
connector_cancelCancel a running connector execution.
connector_statusGet connector status and recent executions.
connector_enableEnable a connector for scheduling.
기본 점검i
누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 12일 점검
- ✓ 통과
제작자와 저장소 일치
레지스트리 이름이 GitHub 계정 supero-platform 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
- ✓ 통과
계속 관리되고 있음
코드 마지막 변경: 오늘
- ✓ 통과
라이선스 있음
MIT 사용
- ✓ 통과
엔드포인트 응답
1420ms 만에 응답(HTTP 401)
- ✓ 통과
OAuth로 로그인
OAuth 로그인을 지원한다고 밝혀서, AI 앱이 로그인 화면으로 안내해 줘요
- ✓ 통과
도구 설명에 숨겨진 지시 없음
도구 설명 60개를 읽었고, AI에게 보내는 숨겨진 지시는 없었어요
토론
질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.
사용자 리뷰
아직 리뷰가 없어요
개발자 도구 카테고리의 다른 서버와 비교i
- 이 카테고리의 다른 서버 5811개 중 0%보다 스타가 많아요
- 이 카테고리의 다른 서버 5811개 중 76%보다 최근에 레지스트리에 공개됐어요
- 기본 점검 결과가 이 카테고리의 다른 서버 5811개 중 100%와 같거나 더 좋아요
레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.
자주 묻는 질문
Supero, 안전한가요?
해당하는 기본 점검 6개 중 6개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.
어떤 키나 코드가 필요한가요?
레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.
내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?
제작자의 클라우드에서 실행돼요. 설치 없이 인터넷으로 연결하지만, 보내는 내용은 제작자의 서버를 거쳐요.
아직 관리되고 있나요?
GitHub 저장소는 마지막으로 오늘 변경됐고, 최신 버전(2.0.2)은 4일 전 레지스트리에 올라왔어요.
어떤 앱에서 쓸 수 있나요?
Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. URL로 연결되므로 원격 MCP를 지원하는 앱에서도 쓸 수 있어요. 예: ChatGPT Business 이상.
같은 카테고리의 다른 것
같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.
카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i
GitHub
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Serena MCP: the IDE for your agent
A powerful toolkit for coding, providing semantic retrieval and editing capabilities.
제작자의 README
README 열기
제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.
supero-mcp
Build and deploy a real web app from your AI assistant, using Supero over MCP.
You describe the app. Your assistant (Claude Code, Cursor, VS Code Copilot, or any MCP client) reads the build spec from Supero, writes the app, validates it, and deploys it to a URL you can open. The app gets sign-in, roles, a database, an admin panel and an API from the platform, so the assistant writes the part that is yours and nothing else.
This repo has three things:
- This guide: how to connect and build, start to finish.
- [Project briefs](projects/README.md): 31 apps worth building, in 16 verticals, written as requirements. Pick one and build it.
- [Community apps](apps/README.md): apps people have built, with source. Run one, add your own, or send a fix to someone else's.
The free plan gives you 3 projects and needs no card. Deployments on it are 30-minute previews; a URL that stays up is a paid plan.
Start here
| If you want to | Go to |
|---|---|
| Build your first app, with every step spelled out | [Your first app, step by step](docs/first-app.md) (30 minutes) |
| Choose something to build | Picking a project, then the project list |
| See a finished example with its source | Page Turners, a book club app |
| Fix something in an app that exists | Community apps |
| Read about a platform feature | Learn more on docs.supero.dev |
The rest of this page is the short version for people who have done this before.
Contents
- Get a key
- Connect your assistant
- Check the connection
- Build an app
- What the assistant does
- Change it and ship it
- Free plan limits
- When something goes wrong
- Contribute
1. Get a key
- Create a free Supero account. No card.
- In the dashboard, open Build via MCP. It is on every project page and in the sidebar.
- Create a key. There are two kinds:
| Key | What the assistant can do with it | Use it when |
|---|---|---|
| Project key | Build into one project, and only that one | You have made a project in the dashboard and want the app there. This is the safer default. |
| Domain key | Create new projects and build into them | You want the assistant to create the project too. Needs a domain admin. |
The key starts with ak_ and is shown once. Copy it then. If you lose it, rotate it under API Keys to get a new one.
Treat the key like a password. Do not commit it, and do not paste it into an issue or an app folder.
2. Connect your assistant
The server is at https://api.supero.dev/mcp/v1/messages (streamable HTTP). Send the key in an X-API-Key header, raw, with no Bearer in front.
Claude Code
claude mcp add --transport http supero \
https://api.supero.dev/mcp/v1/messages \ --header "X-API-Key: ak_..."
Then run /mcp inside Claude Code and check that supero is connected.
Cursor: ~/.cursor/mcp.json
{
"mcpServers": { "supero": { "url": "https://api.supero.dev/mcp/v1/messages", "headers": { "X-API-Key": "ak_..." } } } }
VS Code (GitHub Copilot): .vscode/mcp.json
{
"servers": { "supero": { "type": "http", "url": "https://api.supero.dev/mcp/v1/messages", "headers": { "X-API-Key": "ak_..." } } } }
Run MCP: List Servers, start supero, and use Copilot in Agent mode.
Anything else. Any client that speaks MCP over streamable HTTP and lets you set a request header will work. More detail, and the one known gap (Claude Desktop's connector screen wants OAuth, which the server does not offer yet), is in docs/connect.md.
3. Check the connection
Ask your assistant:
Call build_whoami on Supero and tell me what it says.
You should get back your role, your domain and, for a project key, the project it is bound to. If you would rather check from a terminal:
curl -s https://api.supero.dev/mcp/v1/messages \
-H "Content-Type: application/json" \ -H "X-API-Key: ak_..." \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"build_whoami","arguments":{}}}'
4. Build an app
Paste this, with your own description in the middle.
With a project key (the project already exists):
Connect to Supero over MCP and use your build_ tools. Everything runs through MCP: don't look for a local supero CLI or a SKILLS.md file on disk, there isn't one.
Build this app in my project: [describe your app: the main thing users do, the key screens, and an admin view].
Work in this order: build_whoami, then build_get_skills to load the spec, then build_plan. Echo the plan back to me and wait for my go-ahead. Then build_get_examples with the closest archetype as your reference, author the bundle, run build_validate and fix everything it reports, run build_doctor and fix its warnings, then build_publish and deploy (build_deploy for a ~30-minute preview, build_go_live for the permanent URL). Finally build_smoke_test the deployed URL and finish with a short summary: what you built, the URL, and how I log in.
With a domain key, change the second paragraph to:
Create a new project with build_create_project (pick a short name and namespace), then build this app in it: [describe your app].
Stuck for an idea? Every project brief ends with a prompt that is ready to paste.
If the assistant starts searching your disk for a CLI, send it this:
Stop reading the local filesystem. There is no CLI and no SKILLS.md. Call build_get_skills over MCP now, author the bundle, then build_validate.
More prompts, for changing an app, fixing a failed deploy and going live, are in docs/prompts.md.
5. What the assistant does
| Step | Tools | What happens |
|---|---|---|
| 1. Orient | build_whoami | Finds out which project it may build into and what the key allows. |
| 2. Learn | build_get_skills, build_get_examples, build_get_service_contract | Reads the build spec, a working reference app, and the contract of each platform service it plans to use. The spec is served live, so it is never out of date. |
| 3. Plan | build_plan | Turns your description into records, roles and screens. You read it and say go. |
| 4. Write | (your assistant) | Writes a small bundle: the data model, the configuration, the setup and the front end. |
| 5. Check | build_validate, build_doctor | The platform checks the bundle and reports what to fix before anything is deployed. |
| 6. Ship | build_publish, build_deploy or build_go_live, build_deploy_status, build_smoke_test | Publishes a version, deploys it, waits for it to come up, and tests the live URL. |
A deploy usually takes a few minutes and can sit in launching for five or more. That is normal: the assistant should keep polling build_deploy_status for up to ten minutes before deciding something is wrong.
The full walk-through is in docs/build-flow.md, and every tool is listed in docs/tools.md (64 tools; you can list them without a key).
What you do not have to build. Sign-in, roles and permissions, per-record and per-field access rules, the database, the REST API, the admin panel, and data kept apart between organisations in a multi-tenant app. There are also ready-made services to switch on instead of writing: bookings, appointments, rentals, cart, orders, payments, approvals, tasks, tickets, reviews, memberships, recurring plans, inventory, document signature, attachments, notifications, email and more. Ask the assistant to call build_list_capabilities to see them all.
6. Change it and ship it
- Change the app. Tell the assistant what to change. It fetches the current version with
build_get_bundle, edits it, then validates, publishes and deploys again. The version number goes up each time. - Preview or live.
build_deploygives a preview URL that lasts about 30 minutes, which is enough to click through and share.build_go_livegives a permanent address onsupero.liveand needs a paid plan. - Secrets. Keys for email, SMS or payments go in the app's admin panel under Services. Never put one in the bundle.
- Dev and live mode. A project starts in dev mode. Switch it to live mode before real users arrive.
Free plan limits
| Free | |
|---|---|
| Price | $0, no card |
| Projects | 3 |
| Preview deployments | 10 per project, about 30 minutes each |
| Schemas | 20 |
| API requests | 10,000 a month |
| Permanent live URL | From the Basic plan |
These are the figures on the pricing page on 5 October 2026. That page is the authority if they differ. A plan and a validation pass cost nothing, so get build_validate clean before spending a preview. More in docs/limits.md.
When something goes wrong
| You see | It means | Do this |
|---|---|---|
Authentication required | No key reached the server | Check the header is X-API-Key and the client was restarted after you added it. |
401 or Invalid API key | The key is wrong, cut short, revoked, or has Bearer in front | Paste the raw ak_... value. If it is lost, rotate it under API Keys. |
| The assistant cannot create a project | You gave it a project key | Create the project in the dashboard, or use a domain key. |
The assistant looks for a CLI or a SKILLS.md file | It is guessing from old habits | Send the recovery prompt from step 4. |
build_validate fails | The bundle breaks a rule | Let the assistant fix what it lists and run it again. This step is free. |
build_doctor warns that workflows "usually need elevated permission" | That warning is out of date | Ignore it. Workflows register and run with a project key (checked 6 October 2026). |
| The app deployed but screens are half empty | Some starter data may not have been created. This was a platform fault, fixed on 5 October 2026 | If you still see it, ask the assistant to call build_logs and look for SEED FAILURES, deploy again, and please open an issue. |
Deploy stays in launching | The app is still starting | Wait. Poll for up to ten minutes. |
| A status field will not save for ordinary users | Fields named status or state are protected | Name lifecycle fields _state, for example booking_state. |
| Out of previews | The free plan has ten | Validate more before deploying, or upgrade. |
Still stuck? Ask in Discussions. Found a way to make the server misbehave? See SECURITY.md and report it privately.
Contribute
There are four ways in, and none of them needs permission first. The open issues list good first ones, and we reply within a day.
- Publish an app. Build a brief, or your own idea, and add it with its source to community apps.
- Improve someone else's app. Deploy it into your own project, fix one of its known gaps, and send the change back.
- Write a brief for an app you wish existed. Copy projects/TEMPLATE.md.
- Improve this guide: a client we have not covered, a prompt that works better, an error we did not explain.
CONTRIBUTING.md has the details.
Related
- supero-apps: 19 complete reference apps