Supero

supero-mcp

MCP 経由で Supero を使い、AI アシスタントから実際に動作する Web アプリを構築・デプロイできます。

アプリの内容を説明すると、アシスタント（Claude Code、Cursor、VS Code Copilot、または任意の MCP クライアント）が Supero からビルド仕様を読み込み、アプリを作成して検証し、アクセス可能な URL にデプロイします。プラットフォームがサインイン、ロール、データベース、管理パネル、API を提供するため、アシスタントはアプリ固有の部分だけを作成します。

このリポジトリには、次の 3 つがあります。

• このガイド：接続から構築までの手順を最初から最後まで説明します。
• プロジェクトの概要：16 の分野にわたる、構築する価値のある 31 個のアプリを要件としてまとめています。1 つ選んで構築しましょう。
• コミュニティアプリ：ソースコード付きの、ユーザーが構築したアプリです。実行したり、自分のアプリを追加したり、ほかの人のアプリの修正を送ったりできます。

無料プランでは3 件のプロジェクトを利用でき、カード情報の登録は不要です。このプランでのデプロイは 30 分間のプレビューです。URL を継続して利用するには有料プランが必要です。

ここから始めましょう

目的	移動先
手順をすべて確認しながら、初めてのアプリを構築する	初めてのアプリを段階的に構築（30 分）
構築するアプリを選ぶ	プロジェクトの選び方、続いてプロジェクト一覧
完成したサンプルとそのソースを見る	Page Turners：読書会アプリ
既存アプリを修正する	コミュニティアプリ
プラットフォームの機能について読む	docs.supero.dev で詳細を見る

このページの残りは、以前に同じ作業をしたことがある方向けの簡易版です。

目次

1. キーを取得する
2. アシスタントを接続する
3. 接続を確認する
4. アプリを構築する
5. アシスタントの動作
6. 変更して公開する
7. 無料プランの制限
8. 問題が発生した場合
9. 貢献する

1. キーを取得する

1. 無料の Supero アカウントを作成します。カード情報の登録は不要です。
2. ダッシュボードで Build via MCP を開きます。各プロジェクトページとサイドバーからアクセスできます。
3. キーを作成します。キーには 2 種類あります。

キー	アシスタントができること	使用する場面
プロジェクトキー	1 つのプロジェクトにだけビルドできます	ダッシュボードでプロジェクトを作成済みで、そこにアプリを作成したい場合に使います。こちらがより安全なデフォルトです。
ドメインキー	新しいプロジェクトを作成し、そのプロジェクトにビルドできます	アシスタントにもプロジェクトを作成させたい場合に使います。ドメイン管理者の権限が必要です。

キーは ak_ で始まり、一度だけ表示されます。その場でコピーしてください。紛失した場合は、API Keys でキーをローテーションして新しいキーを取得します。

キーはパスワードと同様に扱ってください。コミットしたり、イシューやアプリのフォルダーに貼り付けたりしないでください。

2. アシスタントを接続する

サーバーの接続先は https://api.supero.dev/mcp/v1/messages（ストリーミング可能な HTTP）です。キーは X-API-Key ヘッダーにそのまま指定します。先頭に Bearer を付けないでください。

Claude Code

claude mcp add --transport http supero \
  https://api.supero.dev/mcp/v1/messages \
  --header "X-API-Key: ak_..."

次に、Claude Code 内で /mcp を実行し、supero が接続されていることを確認します。

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_..." }
    }
  }
}

MCP: List Servers を実行し、supero を起動して、Copilot を Agent モードで使用します。

その他のクライアント。 ストリーミング可能な HTTP 経由で MCP に対応し、リクエストヘッダーを設定できるクライアントならどれでも使えます。詳細と既知の制限（Claude Desktop のコネクタ画面では OAuth が必要ですが、サーバーはまだ OAuth を提供していません）については、docs/connect.md を参照してください。

3. 接続を確認する

アシスタントに次のように尋ねます。

Call build_whoami on Supero and tell me what it says.

自分のロールとドメイン、プロジェクトキーの場合はそのキーが紐付けられているプロジェクトが返されます。ターミナルから確認する場合は、次のようにします。

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. アプリを構築する

この文章を貼り付け、途中に独自の説明を入れてください。

プロジェクトキーを使う場合（プロジェクトはすでに存在します）：

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.

ドメインキーを使う場合は、2つ目の段落を次の内容に変更してください。

Create a new project with build_create_project (pick a short name and namespace), then build this app in it: [describe your app].

アイデアが浮かばない場合は、各プロジェクト概要の最後に、そのまま貼り付けられるプロンプトがあります。

アシスタントがディスク内の CLI を探し始めたら、次の内容を送ってください。

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.

アプリの変更、デプロイの失敗の修正、公開に使えるプロンプトは、docs/prompts.mdにあります。

5. アシスタントの動作

手順	ツール	動作
1. 状況を把握	build_whoami	構築先として利用できるプロジェクトと、キーで許可されている操作を確認します。
2. 情報を確認	build_get_skills、build_get_examples、build_get_service_contract	構築仕様、動作する参照アプリ、利用予定の各プラットフォームサービスのコントラクトを読み込みます。仕様は常に最新の状態で提供されるため、古くなることはありません。
3. 計画	build_plan	説明をレコード、ロール、画面に落とし込みます。内容を確認して、実行の許可を出します。
4. 作成	（使用するアシスタント）	データモデル、設定、セットアップ、フロントエンドを含む小さな一式を作成します。
5. チェック	build_validate、build_doctor	プラットフォームが一式をチェックし、デプロイ前に修正が必要な点を報告します。
6. 公開	build_publish、build_deploy または build_go_live、build_deploy_status、build_smoke_test	バージョンを公開してデプロイし、起動を待ってから、公開 URL をテストします。

デプロイには通常数分かかり、launching の状態が5分以上続くこともあります。これは正常です。問題が起きたと判断する前に、アシスタントは最大10分間、build_deploy_status を繰り返し確認してください。

全手順はdocs/build-flow.mdに記載されています。すべてのツールはdocs/tools.mdに一覧があります（64個のツール。キーなしで一覧を確認できます）。

構築する必要のないもの。 サインイン、ロールと権限、レコード単位およびフィールド単位のアクセスルール、データベース、REST API、管理パネル、マルチテナントアプリで組織間のデータを分離する仕組みは不要です。また、独自に作成せずに有効化できる既成のサービスもあります。予約、アポイントメント、レンタル、カート、注文、支払い、承認、タスク、チケット、レビュー、会員登録、定期プラン、在庫、文書署名、添付ファイル、通知、メールなどが利用できます。すべて確認するには、アシスタントに build_list_capabilities を呼び出すよう依頼してください。

6. 変更して公開する

• アプリを変更する。 変更内容をアシスタントに伝えてください。アシスタントは build_get_bundle で現在のバージョンを取得して編集し、再度検証、公開、デプロイします。バージョン番号は毎回上がります。
• プレビューまたは公開。 build_deploy では、約30分間有効なプレビュー URL が発行されます。動作を確認して共有するには十分な時間です。build_go_live では supero.live 上に恒久的なアドレスが発行され、有料プランが必要です。
• シークレット。 メール、SMS、支払い用のキーは、アプリの管理パネルにある Services に設定してください。一式の中に記載しないでください。
• 開発モードとライブモード。 プロジェクトは開発モードで開始します。実際のユーザーが利用を始める前に、ライブモードに切り替えてください。

無料プランの制限

	無料
価格	$0、カード不要
プロジェクト数	3
プレビューのデプロイ数	1プロジェクトあたり10回、各回約30分
スキーマ数	20
API リクエスト数	月10,000回
恒久的な公開 URL	Basic プランから利用可能

これらは2026年10月5日時点の料金ページに記載された数値です。異なる場合は、料金ページの情報を優先してください。プラン作成と検証は無料なので、プレビューを使う前に build_validate のエラーを解消してください。詳しくはdocs/limits.mdをご覧ください。

問題が発生した場合

表示される内容	意味	対処方法
Authentication required	サーバーにキーが届いていません	ヘッダーが X-API-Key になっていることと、キーを追加したあとにクライアントを再起動したことを確認してください。
401 または Invalid API key	キーが間違っている、一部が欠けている、無効化されている、または先頭に Bearer が付いています	ak_... の値をそのまま貼り付けてください。紛失した場合は、API Keys でキーをローテーションしてください。
アシスタントがプロジェクトを作成できない	プロジェクトキーを渡しています	ダッシュボードでプロジェクトを作成するか、ドメインキーを使用してください。
アシスタントが CLI または SKILLS.md ファイルを探す	古い習慣に基づいて推測しています	ステップ 4 の復旧プロンプトを送信してください。
build_validate が失敗する	バンドルがルールに違反しています	アシスタントに指摘された内容を修正させ、もう一度実行してください。このステップは無料です。
build_doctor が workflows は「通常、昇格された権限が必要です」と警告する	その警告は古い情報です	無視してください。ワークフローはプロジェクトキーで登録・実行できます（2026 年 10 月 6 日に確認済み）。
アプリをデプロイしたものの、画面が半分ほど空になっている	初期データが作成されていない可能性があります。これはプラットフォームの不具合でしたが、2026 年 10 月 5 日に修正されました	まだ発生する場合は、アシスタントに build_logs を呼び出して SEED FAILURES を探させ、もう一度デプロイしてください。また、ぜひ issue を作成してください。
デプロイが launching のままになる	アプリの起動中です	お待ちください。最長 10 分間、状態を確認してください。
一般ユーザーのステータスフィールドを保存できない	status または state という名前のフィールドは保護されています	ライフサイクルを表すフィールドには <something>_state という名前を付けてください。例：booking_state。
プレビューを使い切った	無料プランでは 10 回までです	デプロイ前にさらに検証するか、プランをアップグレードしてください。

まだ解決しませんか？Discussions で質問してください。サーバーの不具合を引き起こす方法を見つけましたか？SECURITY.md を確認し、非公開で報告してください。

貢献する

参加方法は 4 つあり、どれも事前の許可は必要ありません。open issues に最初の貢献に適した課題が掲載されており、1 日以内に返信します。

• アプリを公開する。 ブリーフまたは独自のアイデアをもとにアプリを作成し、ソースと一緒にコミュニティアプリに追加してください。
• ほかの人のアプリを改善する。 自分のプロジェクトにデプロイし、既知の不足点を 1 つ修正して、変更を送ってください。
• あったらよいと思うアプリのブリーフを書く。 projects/TEMPLATE.md をコピーしてください。
• このガイドを改善する。 まだ取り上げていないクライアント、より効果的なプロンプト、説明されていないエラーなどを追加してください。

詳細は CONTRIBUTING.md をご覧ください。

関連情報

• supero-apps：ソースとライブデモを含む、完成済みのリファレンスアプリ 19 個。
• docs.supero.dev の MCP ドキュメントと、開発時に特に役立つ機能ページのガイド。

ライセンス

このリポジトリのすべての内容は MIT ライセンスです。作成したアプリはあなたのものです。Supero プラットフォーム自体はホスト型サービスであり、オープンソースではありません。