mcpField
C
catalyst-slate

catalyst-slate

github.com/catalystbyzohoクラウド・DevOps701.0k 回インストール今日更新
リポジトリ

catalyst-slate について

Zoho Catalyst Slate でフロントエンドアプリを作成、設定、デプロイするためのスキルです。デプロイ前のコンソールでの初回有効化確認を重視し、フレームワーク設定、クロスドメインの関数呼び出し、デプロイ時の確認事項を扱います。

主な機能

  1. 01デプロイ前に Slate の有効化を確認
  2. 02Slate アプリの生成と設定を案内
  3. 03クロスドメイン関数呼び出しの要件を説明
  4. 04デプロイとプレビュー URL を案内
  5. 05basic client hosting からの移行時の問題を指摘

活用シーン

  1. 01Catalyst 初期化後の Slate アプリ作成
  2. 02slate-config.toml のフレームワーク設定
  3. 03Slate フロントエンドと Catalyst 関数の接続
  4. 04未有効化によるデプロイ失敗の調査

MCP 対応

プロジェクトで Slate が有効かどうかを確認するため、`CatalystbyZoho_List_All_Slate_Apps` MCP ツールを使用します。MCP ツールへの機能公開については説明されていません。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/catalystbyzoho/agent-skills --skill catalyst-slate

インストール後、Claude Code で/catalyst-slateを入力して読み込まれたか確認します。

同梱ファイルreferences/slate-basics.md

詳細

⚠️ 事前確認 — Slate の有効化（プロジェクトごとに一度だけ）： Slate コマンドを実行する前に、コンソールで Slate が有効になっていることを確認してください。 Catalyst コンソールを開き、対象のプロジェクト → Slate（左サイドバー）→ Start Exploring をクリックします。 この手順は一度だけ必要です。省略すると、slate:create はローカルで成功しても、catalyst deploy slate は HTTP 400 で失敗します。

仕組み

  1. Slate が有効になっているか確認する — MCP を使用し、プロジェクト ID を指定して CatalystbyZoho_List_All_Slate_Apps を呼び出します。
    • アプリが返されるか、空のリストが返される場合 → Slate は有効です。続行してください。
    • INVALID_URL_PATTERN が返される場合 → Slate はまだ有効になっていません。これは MCP のバグではなく、サービスをコンソールで一度有効にする必要があることを意味します。ユーザーに次のように伝えてください。

      "Catalyst コンソールを開き、対象のプロジェクト → Slate（左サイドバー）に移動して、Start Exploring をクリックしてください。この操作は一度だけで、5 秒ほどで完了します。完了したらお知らせください。続行します。" 確認を待ってから続行してください。

    • Slate が有効になっていないからといって、Web Client（レガシー）に切り替えないでください。 Web Client は非推奨です。フロントエンドのホスティングには常に Slate が適しています。一度だけの有効化は、アプローチを変える理由にはなりません。

    catalyst init 中に Slate が選択されなかった場合は、初期化の直後に catalyst slate:create --name <name> --framework <framework> --default を実行してください。このコマンドは catalyst.json を更新し、ソースディレクトリを自動的に指定するよう求めます。手動で設定するより速いため、標準の推奨手順にしてください。

  2. Slate アプリが存在するか確認する — まだアプリがない場合は、catalyst slate:create --name <name> --framework <framework> -ni を実行してひな形を作成します。catalyst init 中に Slate が選択されなかった場合は、初期化の直後に実行してください。
  3. references/slate-basics.md を読み込む — フレームワークのセットアップ、slate-config.toml の形式、baseUrl の設定について確認します。
  4. クロスドメイン呼び出し — Slate アプリから関数を呼び出すクエリの場合は、完全な URL ＋ generateAuthToken() ＋ CORS 許可リストのパターンを適用します。

    ⚠️ 基本的なクライアントホスティングから移行する場合： 基本的なクライアントでは動作していた /server/fn/execute のような相対パスは、Slate では気づかないうちに動作しなくなります。Slate は *.onslate.com から配信される一方、関数は *.catalystserverless.com 上にあるためです。すべての関数呼び出しを絶対 URL に変更する必要があります。相対パスの /server/... をすべて完全な https://<project>.catalystserverless.com/server/... URL に置き換え、generateAuthToken() ヘッダーを追加してください。

  5. デプロイする — デプロイ前に、コンソールで Slate が有効になっていることを確認してください（コンソール → Slate）。slate:create はローカルで実行され、有効化されていなくても成功します。最初のバックエンド呼び出しはデプロイ時に行われるため、有効化されていないと HTTP 400: Please access the Slate service in your project's console before deploying で失敗します。確認できたら、catalyst deploy slate <name> -ni を実行して現在の環境にデプロイします。ビルド完了後にプレビュー URL を利用できます。

トリガー

「Slate」、「フロントエンドのホスティング」、「catalyst slate」、「slate-config.toml」、「React アプリのデプロイ」、「Slate フレームワーク」、「slate:create」、「slate deploy」、「Catalyst 上のフロントエンド」、「Slate と Vercel の比較」、「Slate から関数へのクロスドメイン呼び出し」、「Slate の baseUrl」、「Catalyst 上の Next.js」、「Catalyst 上の静的フロントエンド」に関する場合は、このスキルを使用してください。

参考資料

参考資料クエリの内容に応じて読み込むもの
references/slate-basics.mdフレームワークのセットアップ、slate-config.toml に関する注意点、baseUrl の設定、Slate から関数を呼び出す場合の CORS、Git デプロイ、CLI コマンド

コメント

Markdown 対応