日本語
English简体中文繁體中文日本語EspañolBahasa Indonesia
始める

Claude Code プラグイン · オープンソース

デプロイも修正もロールバックも、エージェントに頼むだけ

Zenavo スキルは、プロジェクトのデプロイ、デプロイが失敗した原因の特定、動いていたバージョンへの復帰、環境変数の管理を Claude Code に教えます。範囲をあなたが決めたキーで動き、何かを変える前には必ず確認します。

インストールGitHub で見る

このページは English、简体中文、繁體中文、Español、Bahasa Indonesia でもご覧いただけます。

Claude Code例

api の前回のデプロイはなぜ失敗した？

zenavo-debug

  • get_project shop
  • list_deployments api
  • get_job
  • list_env api

イメージのビルドは成功しましたが、api は起動直後に終了しています。DATABASE_URL を読み込もうとしていますが、このサービスにはその変数がありません。値がこの会話に出ないよう、サービスの Variable タブで追加してください。その後もう一度デプロイします。

3 ステップでインストール

コンピューターごとに一度だけ。キーはあなたのマシンに保存され、Claude Code の設定には入りません。

  1. zenavo-mcp をインストール

    スキルはオープンソースの MCP サーバー zenavo-mcp を通じて Zenavo とやり取りします。お使いのシステム用のバイナリをダウンロードして検証するか（方法は README にあります）、Go 1.26 以降でビルドします。

    go install github.com/Zenavo-App/zenavo-mcp/cmd/zenavo-mcp@latest

    Releases からダウンロード →

  2. サインインしてキーの範囲を決める

    zenavo-mcp login

    コンソールが開き、承認を求められます。コードがターミナルの表示と一致することを確認し、Deploy か Read only を選んで、キーをエージェントが作業するプロジェクトに限定します。閲覧だけにするなら --scope read でサインインします。

  3. Claude Code にプラグインを追加

    claude plugin marketplace add Zenavo-App/zenavo-skillsclaude plugin install zenavo@zenavo

    プラグインには下の 5 つのスキルが入っていて、zenavo-mcp も自動で起動します。

5 つのスキル

どれも zenavo-skills リポジトリにある、短くて読める手順書です。Claude は頼まれた内容から適切なものを選びます。

  • zenavo-deploy先に確認します

    プロジェクト全体または 1 つのサービスをデプロイし、ジョブを追って、正常に起動したか確認します。

    shop の api サービスをデプロイして

  • zenavo-debug

    状態、ジョブの出力、ログから、デプロイの失敗やサービスのクラッシュの原因を突き止め、修正を提案します。

    worker が再起動を繰り返すのはなぜ？

  • zenavo-rollback先に確認します

    サービスまたはプロジェクト全体を、以前の正常なデプロイに戻します。

    web を前のバージョンに戻して

  • zenavo-env先に確認します

    環境変数を追加、変更、削除します。できる限り値を会話に出しません。

    worker の LOG_LEVEL を debug にして

  • zenavo-setup

    ツールが見つからない、またはサインインしていないときに、zenavo-mcp のインストールとサインインを手伝います。

    Zenavo のツールが動かない

ほかのエージェント

どの MCP クライアントでも同じサーバーを、同じキーと同じ制限で使えます。スキルは Claude Code 向けで、ほかのクライアントではエージェントがツールを使います。

Claude Code でサーバーだけを使う

プラグインなしでツールだけを使う場合：

claude mcp add zenavo -- zenavo-mcp

Claude Desktop、Cursor など

クライアントの MCP 設定（claude_desktop_config.json、.cursor/mcp.json など）にサーバーを追加します。

{
  "mcpServers": {
    "zenavo": { "command": "zenavo-mcp" }
  }
}

エージェントが呼び出せるもの

zenavo-mcp がエージェントに渡すツールです。キーにできることはエージェントではなく Zenavo API が決めます。Read only のキーではデプロイできません。

閲覧

  • whoamiキーが使うアカウント、チーム、ロールと、その権限
  • list_projectsプロジェクトとそのサービス
  • get_projectサービス、ポート、ドメイン、稼働状況、実行中のジョブ、デプロイを妨げている要因
  • get_logsサービスの最新のログ行（絞り込み可）
  • list_deploymentsサービスの最近のデプロイ（現在のものに印付き）
  • get_jobジョブの状態、進捗、ログ。完了まで待つこともできます

Deploy 権限が必要

  • list_envサービスの環境変数の名前。値は決して含みません
  • deployプロジェクト全体または 1 つのサービスをデプロイ
  • rollback以前に成功したデプロイをもう一度実行
  • restart_service再ビルドせずにサービスを再起動
  • set_env / unset_env環境変数を 1 つ設定または削除。値は返されません

キーを渡すことを前提に設計

Deploy 権限を持つエージェントは、サービスにできることなら何でもするコードをデプロイできてしまいます。だからキーは狭く、判断はあなたが下します。

  • まず確認

    デプロイ、ロールバック、再起動、変数の変更は、あなたの承認を待ちます。変更を伴うツールには印が付いているので、エージェントは実行前に確認します。

  • 値は見せない

    エージェントに見えるのは変数の名前だけで、値は見えません。ログは変数の値を置き換えたうえで、信頼できないデータとして渡されます。

  • 範囲はあなたが決める

    Deploy か Read only、一部のプロジェクトに限定、90 日で失効。キーはエージェントの設定ではなく、あなたのコンピューターに保存されます。

  • すべて記録

    変更はすべてキーの名前で監査ログに残ります。Account settings → API Keys でキーを削除すれば、すぐに止められます。

プロジェクトの削除、シェルを開く、ファイルやデータベースの行を読む、バックアップのダウンロード、サーバーの変更、請求やチームメンバーの操作を行うツールはありません。それらはコンソールで行います。