Supero
概要
作者による説明(英語の原文)
Build and deploy multi-tenant apps from ChatGPT, Claude or your editor. Sign in with OAuth or a key.
できること
このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。
- 接続方法: クラウドで動く
- トランスポート: Streamable HTTP
- カテゴリ: 開発者ツール
インストール
使っているAIアプリを選んで、設定をコピーしてください。
チェック 5/5 合格 · 質問内容は提供元のサーバー(mcp.supero.dev)を通ります
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげます · 約 2 分
キー不要、インストール不要 · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで
Claude の Connectors ページを開く
CustomizeConnectors
「+ Add」→「Add custom connector」を押し、この 2 つを入力
ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します
Name · 名前SuperoRemote MCP server URL · アドレスhttps://mcp.supero.dev/mcpAuthentication は Claude が検出したままにして Add を押します
チャットで有効にする
+ConnectorsSupero
試してみる
Supero を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が Supero を使っていると言うか、回答に Supero のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT は法人向けプランのみ接続できます
Web 版 ChatGPT Business・Enterprise・Edu で、ワークスペースの管理者かオーナーが追加します · Free・Plus・Pro の場合:あなたの ChatGPT プランではまだ MCP を自分でつなげません
Web 版 ChatGPT で MCP の追加ページを開く
Plugins+Add custom MCP server
名前とアドレスを入力
名前を入れ、Connection にアドレスを貼り付け、注意事項にチェックして Create as a plugin を押します
Name · 名前SuperoConnection · アドレスhttps://mcp.supero.dev/mcpチャットで Supero を選ぶ
新しいチャットを開き、入力前にプラグインの一覧から Supero を選びます
試してみる
Supero を使って、私に何ができるか教えて、1 つやってみせて✓ ChatGPT が Supero を使っていると言うか、回答に Supero のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に OpenAI のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Claude Code につなげます · 約 2 分
キー不要、インストール不要
ターミナルを開く
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
このコマンドを貼り付けて Enter
claude mcp add --transport http supero https://mcp.supero.dev/mcpClaude Code で /mcp と入力
Supero が一覧にあり、接続済みと表示されれば OK です
試してみる
Supero を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が Supero を使っていると言うか、回答に Supero のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげます · 約 2 分
キー不要、インストール不要
Cursor の AI チャットを Agent モードで開く
試してみる
Supero を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が Supero を使っていると言うか、回答に Supero のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげます · 約 2 分
キー不要、インストール不要
VS Code の AI チャットを Agent モードで開く
試してみる
Supero を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が Supero を使っていると言うか、回答に Supero のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
Web 経由でつなぐアプリ用のアドレス
https://mcp.supero.dev/mcpJSON 設定は下の「開発者向け」にあります
開発者向け:ターミナルのコマンドと JSON 設定
Web 経由
Claude Code
claude mcp add --transport http 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に従ってください。
ひと目でわかる
- 接続方法
- クラウドで動く
- トランスポート
- streamable-http
- 最新バージョンi
- 2.0.2
- レジストリ公開日i
- 2026年11月8日
- コードの最終更新i
- 2026年11月10日
- 作者
- supero-platform
- ウェブサイト
- docs.supero.dev
- レジストリでの状態
- 有効
使えるアプリ
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。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月11日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント supero-platform で確認済みです
- ✓ 合格
今もメンテナンスされている
コードの最終更新:昨日
- … 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
- ✓ 合格
エンドポイントが応答する
1420ミリ秒で応答(HTTP 401)
- ✓ 合格
OAuthでサインイン
OAuthでのサインインに対応しているため、AIアプリがログイン画面へ案内してくれます
- ✓ 合格
ツールの説明に隠れた指示がない
60件のツールの説明を読み、AIへの隠れた指示は見つかりませんでした
話し合い
質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
ユーザーレビュー
まだレビューはありません
開発者ツールのほかのサーバーとの比較i
- このカテゴリのほかの5752件のうち0%よりスターが多い
- このカテゴリのほかの5752件のうち79%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの5752件のうち100%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
Superoは安全ですか?
当てはまる基本チェック5項目のうち5項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。
パソコンで動きますか、それともクラウドですか?
作者のクラウドで動きます。インストール不要でインターネット経由でつながりますが、送った内容は作者のサーバーを通ります。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は昨日、最新バージョン(2.0.2)がレジストリに届いたのは3 日前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP に対応したアプリでも使えます(例:ChatGPT Business 以上)。
代わりに使えるものは?
同じカテゴリには:REA, Netdata, Front-End Checklist
代わりの候補
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Netdata
Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.
Front-End Checklist
Review frontend code and live pages against 386 quality-gated web development rules.
作者の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