Staticbot

Staticbot MCP サーバー

Codex、Claude、Cursor、その他の MCP 対応エージェントに、Staticbotへの安全なアクセスを提供します。このサーバーは、ウェブサイトのデプロイ、アプリケーションのバックエンドの移行、継続的な同期の運用に使える型付きツールを公開します。Staticbot は、認証情報と長時間実行されるワークフローの状態をモデルコンテキストの外部で管理します。

接続方法は 2 つあります

ホスト型サーバーに接続する — インストールも API キーも不要です。OAuth に対応したリモートサーバーを利用できる MCP クライアントで、次の URL を指定してください。

https://mcp.staticbot.dev/mcp

Staticbot にサインインして、許可する内容を選ぶと、クライアントが接続を保存します。まだ Staticbot アカウントをお持ちでない場合は、初回接続時に作成されます。

ローカルで実行する — MCP サーバーをローカルプロセスとして起動するクライアント向けです。Node.js 20 以降と、 app.staticbot.dev/developerから取得した Staticbot API キーが必要です。

どちらも同じツールを公開します。ホスト型サーバーは認可したユーザーとして動作し、API キーを参照することはありません。ローカルサーバーは、指定した API キーを使用します。

Codex プラグインとしてインストールする

このリポジトリは Codex プラグインでもあります。マニフェストには Staticbot MCP サーバーと、目的に特化した 4 つのスキルが含まれています。

• deploy-web-app-with-staticbot は、エージェントにクラウドプロバイダーを選ばせることなく、リポジトリをデプロイします。Staticbot がリポジトリを分析してワークロードを分類し、対応する AWS または Cloudflare のターゲットと、顧客所有または Staticbot 管理の所有モデルを選択します。
• migrate-vibe-coded-app は、検出と承認の段階を設けながら、Base44、Lovable、Bolt、または Firebase のバックエンドを顧客所有の Supabase インフラストラクチャに移行します。
• sync-vibe-coded-app は、破壊的な変更のレビューを維持しながら、移行済みプロジェクトの同期を継続します。
• live-migrate-ai-built-app は、計画されたメンテナンス時間中に、稼働中の Lovable または Base44 アプリを移行後のスタックに切り替えます。移行のテスト、切り替え計画、メンテナンスページ、ソースへの書き込み停止、新しい最終コピー、検証、ドメインの切り替えを行います。ビルダーごとの書き込み停止手順は live-migrate-lovable-app と live-migrate-base44-app に記載されています。

汎用の staticbot スキルは、直接 REST API を呼び出す代替手段として引き続き利用できます。

公開 GitHub マーケットプレイスを追加し、Staticbot をインストールしてください。

codex plugin marketplace add bitfiction/staticbot-mcp
codex plugin add staticbot@staticbot

マーケットプレイスを追加しても Staticbot がすぐに表示されない場合は、ChatGPT デスクトップアプリまたは Codex を再起動してください。このプレビュープラグインはローカル MCP トランスポートを使用するため、アプリの起動環境で STATICBOT_API_KEY を設定してください。スキルを同梱せず MCP ツールだけを使う場合は、ホスト型 OAuth 接続 https://mcp.staticbot.dev/mcp が最も手軽です。

Claude Code プラグインとしてインストールする

Claude Code では、Staticbot が中央プラグインレジストリに登録される必要はありません。この GitHub リポジトリからセルフホスト型マーケットプレイスを直接追加し、プラグインをインストールしてください。

/plugin marketplace add bitfiction/staticbot-mcp
/plugin install staticbot@staticbot

Claude Code の起動環境で STATICBOT_API_KEY を設定してください。プラグインは npx を使って公開済みの @staticbot/mcp パッケージを起動し、その環境を引き継ぎます。セルフホスト型またはローカルの Staticbot API を使う場合は、STATICBOT_API_URL も設定できますが、必須ではありません。

インストールされたスキルは、プラグイン名を付けた名前空間で利用できます。たとえば、/staticbot:deploy-web-app-with-staticbot、/staticbot:migrate-vibe-coded-app、/staticbot:sync-vibe-coded-app、/staticbot:live-migrate-ai-built-app を使用します。インストール後にプラグインがすぐに利用できない場合は、Claude Code を再起動するか、/reload-plugins を実行してください。

MCP クライアントを直接設定する

ホスト型（OAuth）

リモート MCP サーバーに対応したクライアントでは、https://mcp.staticbot.dev/mcp を追加し、プロンプトが表示されたら認可してください。クライアントはサーバー自体からサインイン先を検出するため、コピーや貼り付けは不要で、認証情報もお使いのマシンには保存されません。

ローカル（API キー）

公開済みパッケージをプロジェクトまたはグローバル MCP 設定に追加します。

{
  "mcpServers": {
    "staticbot": {
      "command": "npx",
      "args": ["-y", "@staticbot/mcp"],
      "env": {
        "STATICBOT_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

ホスト型の Staticbot は https://app.staticbot.dev で、これがデフォルトです。ホスト型サービスでは STATICBOT_API_URL を設定しないでください。セルフホスト版またはローカルの Staticbot API を使用する場合に限り、上書きしてください。

API キーは、MCP クライアントのシークレットまたは環境設定に保存してください。チャットに貼り付けたり、リポジトリにコミットしたりしないでください。

エージェントにできること

サーバーのツールは、ユーザーが達成したいことに基づいて分類されています。

• 公開ウェブサイトの URL を分析して、そのプラットフォーム、バックエンド、利用可能な移行先／ホスティング先を特定します。連携機能への接続は不要です
• テンプレート、スタック、デプロイ、連携の接続状況を確認します
• 接続済みの GitHub または GitLab アカウントから、作業対象のリポジトリを特定します。プライベートリポジトリも対象です
• 静的サイトおよび SSR のデプロイを作成、監視します
• デプロイの DNS を確認し、デプロイが所有するレコードをリンク済みの Cloudflare ゾーンに安全に反映し、カスタムホスト名の検証を再確認します
• Cloudflare Workers アプリのホスティング先として、Staticbot のアカウントまたはユーザー自身の接続済み Cloudflare アカウントを選択し、作成前にホスト名をデプロイできるか確認します
• AWS でホストする静的サイトのデプロイ先として、Staticbot の管理アカウントまたはユーザー自身の接続済み AWS アカウントを選択します
• 顧客所有の Supabase プロジェクトを作成し、正常な状態になるまで待機して、移行先として使用します
• Lovable、Bolt、Firebase、Base44 のプロジェクトを Supabase の移行先に移行します
• 移行の検出結果を確認し、承認や選択が必要な段階でユーザーを案内します
• 移行の稼働中アプリ URL を設定し、そのスキャン結果を取得して、保持されている稼働中コミットとの比較を確認します
• プレビューを作成し、移植可能な移行パッケージをダウンロードします
• 接続済みプロジェクトのプレビューを作成し、稼働中デプロイをビルダーブランチに切り替えるか、移行プレビューを稼働環境に同期します
• 共有リポジトリウェブフックの適用範囲を確認し、GitHub プッシュ自動化を明示的に設定、リセット、無効化します
• 継続的同期を実行、確認、再試行、またはスキップします
• Staticbot が返した有効な固定バージョンを使用して、ウェブサイトをロールバックまたは再デプロイします

ツールのスキーマと説明は、MCP クライアントが参照する実行時の契約です。エージェントがツールを選択する際に必要な運用手順が記載されています。

ウェブサイト URL のチェック

scan_website は POST /api/v1/site-scans を使って、認証済みのワークスペースチェックを開始するか、既存のチェックを再利用します。 Staticbot アカウントは必要ですが、リポジトリ、データベース、クラウド連携は不要です。返された scan.id を使って get_website_scan（GET /api/v1/site-scans/{id}）をポーリングします。スキャンがキュー内または実行中の場合は、 リクエスト間隔として pollAfterMs を待機してください。完了時には、検出結果、サポート状況、ホスティング／移行の見積もり、または明示的な失敗結果が返されます。このチェックによってデプロイや移行が開始されることはありません。

この機能では、既存のワークスペーススキャナーを使用します。クォータ、キャッシュ、対象へのスロットリング、上限付きキュー、公開アドレスの保護が適用されます。匿名のマーケティングページ API では、別個の Turnstile フローが引き続き使用されます。API／MCP の結果には、抽出されたスクリプトや連絡履歴の生データではなく、顧客向けの概要が含まれます。

接続済みプロジェクトの操作

プレビュー、稼働環境、ウェブフックを変更する前に、get_connected_project_operations を読み込んでください。現在のビルダーブランチと稼働ブランチ、有効なロール権限、リポジトリウェブフックの利用先が返されます。変更ツールには明示的な確認が必要です。稼働環境の操作では、ブランチ名を正確に指定する必要があります。ウェブフック操作では、返されたリポジトリ設定 ID が必要です。対象が変更されていた場合は 409 が返されるため、最新情報を再確認して承認を得る必要があります。機能フラグ、ワークスペースのロール、保存済みリンクの検証、エージェンシー顧客に対する制限は、引き続きバックエンドで適用されます。ウェブフックのリセット／削除では、既存のベストエフォートによる上流側の削除を使用するため、ローカル設定が変更されたからといって、GitHub の古いフックが削除されたことにはなりません。

ホスト型 MCP サーバーでこれらのツールを有効にする前に、バックエンドのルートをデプロイする必要があります。残りのダッシュボードと API の相違点については、機能監査を参照してください。

プラットフォームの更新と保留中のアクション

list_pending_actions と list_platform_updates は、プロジェクトの Sync タブと同じ移行後の修正内容を表示します。check_platform_updates はエビデンスを更新し、承認済みの自動修正をキューに追加する場合があります。これは状態を変更する操作です。apply_platform_updates は、返された影響をユーザーが承認した後にのみ、選択した修正を適用します。顧客が所有するブランチにはプルリクエストを作成し、直接プッシュは行いません。dismiss_platform_update は任意の修正を却下します。必須の修正は却下できません。返された同期実行と PR のリンクを確認してください。ロールアウト中は、サーバーの機能フラグによってこれらの操作が無効のままになる場合があります。

バックエンドの制御とソースの更新

get_backend_workflows は、接続済みのプロジェクトまたは移行がちょうど 1 つであることを前提として、共有バックエンドを調査します。operate_backend_workflows を使用する前に、影響を受けるすべてのステージと観測されたフラグを提示してください。 これらの制御は、Supabase Cloud 上の Staticbot の移行済み Base44 スケジューラーを管理します。不明な結果は不明のまま扱い、自動的に再試行することはありません。

追跡対象の機能ブランチについては、list_connected_project_previews と get_feature_branch_preview_settings を確認してください。ビルドには、プランの上限により削除されたプレビューがある場合も含め、正確なコミットとビルドヒントが必要です。自動設定では、既存のホスティングプランの上限が維持されます。 trigger_sync は、明示的な確認後にのみ、すべての関数を任意で再デプロイします。通常の同期リクエストとの互換性は保たれます。

preview_migration_source_update は、選択したテンプレートバージョンを正確なコミットに解決しますが、適用は行いません。update_migration_source では、その正確なペアの承認が必要です。また、別途レビューするための新しいプランを準備します。ターゲットへの書き込みは承認しません。

別の場所でホストされているフロントエンドの場合は、正確なバックエンドと新しいパブリックオリジンを承認する前に、get_external_auth_domain を確認してください。set_external_auth_domain によって、認証設定が変更されますが、フロントエンドのホスティングや DNS は変更されません。結果が UPDATED であっても、サインイン、リセット、マジックリンクを実際にテストする必要があります。

リクエスト例

• 「このリポジトリを Staticbot でデプロイして、必要な DNS レコードを教えてください。」
• 「このデプロイで必要なレコードを、リンク済みの Cloudflare ゾーンにプッシュしてから、検証を再確認してください。」
• 「Base44 アプリを自分の Supabase プロジェクトに移行してください。変更を加える前に承認を求めてください。」
• 「最新の同期実行で変更された内容を表示し、破壊的な SQL があれば説明してください。」
• 「このデプロイで有効なロールバックバージョンを一覧表示してください。まだロールバックはしないでください。」

安全性に関する契約

Staticbot のツールは、人間が明示的に制御できるように設計されています。

• 移行を確定する前に、検出結果を提示します。
• 選択が必要な箇所は、暗黙に既定値を適用せず、ユーザーに選択肢を提示します。
• 破壊的な同期変更は、レビューのために一時停止します。
• エージェントが再試行またはスキップする前に、失敗した処理について説明します。
• ロールバックでは、list_rollback_versions が返した正確なバージョンを使用し、確認を必須とします。
• プラットフォームの更新は、各更新の whatApplyingDoes をユーザーが確認し、承認した後にのみ適用されます。更新が必須であっても、承認とはみなされません。顧客のブランチにはプルリクエストを作成し、プッシュは行いません。
• 長時間実行される操作は、エージェントのセッションをまたいで再開できる永続的な状態を返します。
• ホスト型サーバーは、認可した本人として、付与された権限の範囲内でのみ動作し、その組織の外部にはアクセスできません。

軽量なステータス確認には get_migration_overview を使用してください。フェーズ／ジョブ数、保存済みレポートのメタデータ、対応が必要なジョブ、プレビューのステータスに加えて、version と pollAfterMs を返します。生のペイロードを読み込んだり、移行を変更したりすることはありません。アクションを振り分ける前に、既存の技術情報をすべて確認するには、get_migration、get_migration_jobs、検出レポート、ジョブ履歴を使用してください。

移行ツールは、ローカル API キーサーバーとホスト型 OAuth サーバーで共用されます。アクションを振り分ける前に、必ず executionCompatibility.locked を確認してください。ロックされた実行は、以前のステータスが IN_PROGRESS であっても、再開も再試行もできません。レポート／履歴は引き続き参照できます。新しい移行を開始するには、最新の検出を行い、以前に書き込みが行われている場合は、クリーンなターゲットを優先してください。ホスティングと継続的な同期は、それぞれ独立したライフサイクルを持ちます。

顧客所有のネイティブ Supabase ソースでは、ターゲットの supabaseIntegrationInstanceId とは別に、sourceIntegrationInstanceId を明示的に選択してください。1 つの接続で両方のプロジェクトを所有することも、それぞれのプロジェクトで別の接続を使用することもできます。ソースプロジェクトとターゲットプロジェクトは異なる必要があります。Lovable Cloud にはソースの Management API 接続がなく、ターゲットの接続を借用することもありません。

移行レスポンスに pendingAction が含まれる場合、クライアントは次のステップの判断にこれを唯一の正確な情報源として扱ってください。クライアントは Staticbot の内部パイプラインのフェーズをハードコードしないでください。

移行の検出では、レビュー対象となる追加のアクションが 2 つ提示されることがあります。preFlightGate には、エージェントがユーザーに提示すべきエクスポートとリプレイの正確な選択肢が含まれます。選択した gateChoice を指定して confirm_migration を呼び出してください。targetConflictReport には、ターゲットにすでに存在するオブジェクトが一覧表示され、データベース、Storage、またはプロジェクト全体のクリーンアップを選択できます。clean_migration_target は取り消しできないため、対象範囲と返されたターゲットプロジェクトの ref の両方について、個別に確認する必要があります。

承認前に、検出レポートで詳細な調査が提示されている場合は、inspect_migration_source で追加調査をキューに登録できます。ソースアカウントでヘルパーをコミットしてデプロイするには、authorizeHelperDeployment: true による明示的な認可が必要です。ターゲットへの書き込みを承認する前に、更新されたレポートを確認してください。list_migration_discovery_revisions と get_migration_discovery_revision では、保持されたレポートを参照できます。実行リビジョンとジョブ履歴には、過去の試行の証拠が保持されます。

get_migration_handoff_report は、ギャップ、手動で必要なアクション、修正用プロンプト、名前のみのシークレットチェックリスト、プレビュー、現在の実行に関する証拠を含む Markdown を返します。検出リビジョンを任意で指定しても、過去の実行は選択されません。移行されたスケジュールは無効なステージング状態のままになります。カットオーバー時に、利用可能であれば、顧客がレポート内の保護された有効化用 SQL を確認して実行します。ソースで無効化されているジョブは、その状態が保持されます。有効化する前にステージングエラーを解決してください。レポートを読むだけではジョブは有効化されません。

Staticbot スキル

このリポジトリには、デプロイ、移行、継続的な同期に特化したスキルに加え、MCP サーバーを使わずに REST API を直接操作できる Codex または Claude 環境向けの汎用 Staticbot スキルが含まれています。直接 API を操作するワークフローでは、稼働中の OpenAPI コントラクトを取得し、同じ承認ルールと認証情報の取り扱いルールを適用します。

クライアントが MCP に対応している場合は、MCP パッケージを使用してください。コマンドラインエージェントからの直接 API アクセスがより適切な場合は、スキルを使用してください。

環境変数

これらはローカルサーバーに適用されます。ホスト型サーバーでは、いずれも必要ありません。

変数	必須	デフォルト	目的
STATICBOT_API_KEY	はい	—	Staticbot へのリクエストを認証します
STATICBOT_API_URL	いいえ	https://app.staticbot.dev	セルフホストまたはローカルの API の場合にのみ上書きします

ドキュメント

• Staticbot のウェブサイト
• インタラクティブ API リファレンスと API キー
• npm パッケージ
• コントリビューションとローカルでの検証

ライセンス

MIT