---
title: "Claude Code から Zenavo のプロジェクトをデプロイ・調査する"
description: "Claude Code に Zenavo MCP と Skills を接続し、プロジェクト単位で権限を絞って、ターミナルからサービス状態の確認、エラーログの調査、デプロイ、ロールバックを行う方法を説明します。"
date: 2026-11-10
language: ja-JP
url: https://zenavo.app/ja-JP/blog/claude-code-deploy-debug
---

# Claude Code から Zenavo のプロジェクトをデプロイ・調査する

コードを書き終えてデプロイするときや、本番のサービスが突然起動しなくなったとき、ターミナルとブラウザのコンソールを行き来してプロジェクトを探し、デプロイを押し、ビルドを待ってログを追うのは手間がかかります。

Zenavo の MCP と Skills を Claude Code に接続すれば、こうした操作を同じターミナルの会話の中で完結できます。たとえば「`web` サービスの最新のデプロイがなぜ失敗したかログを見て、原因と修正案を出して」とそのまま頼めます。

> ブラウザ上で直接 AI に聞きたい場合は、ローカルに何もインストールしなくても、コンソール右端の **[Zenavo Agent](https://docs.zenavo.app/ja-JP/zenavo-agent)** を開けます。現在開いているページを認識してログやデプロイ履歴を読み、画面上の確認カードからデプロイ、ロールバック、再起動、環境変数の設定を行えます。この記事では、同じ機能をローカルの Claude Code から使う方法を説明します。

## 1. `zenavo-mcp` をインストールしてログインする

[zenavo-mcp の Releases](https://github.com/Zenavo-App/zenavo-mcp/releases) からお使いの OS 向けのバイナリをダウンロードし、`PATH` の通った場所に置いてターミナルで次を実行します。

```sh
zenavo-mcp login
```

ブラウザでデバイス認証ページが開きます。ターミナルに表示されているコードと一致していることを確認し、付与する権限を選びます。

- **読み取り専用（Read-only）**：プロジェクト、サービスの状態、デプロイ履歴、ログ、環境変数の名前（値は含まれません）だけを参照できます。普段の調査に向いています。
- **デプロイ（Deploy）**：読み取りに加えて、デプロイの実行、サービスの再起動、ロールバック、環境変数の更新を許可します。

あわせて対象プロジェクトで **一部のプロジェクトのみ** を選び、いま作業するプロジェクトだけにチェックを入れます。承認するとトークンはローカルに保存されるため、API キーをチャットに貼り付ける必要はありません。

続いて、Claude Code に Zenavo プラグイン（MCP の設定と、デプロイ・調査・ロールバック・変数管理などの Skills を含む）をインストールします。

```sh
claude plugin marketplace add Zenavo-App/zenavo-skills
claude plugin install zenavo@zenavo
```

MCP 接続だけが必要な場合は、`claude mcp add zenavo -- zenavo-mcp` でも登録できます。Cursor や Windsurf など他のクライアントの設定方法は [AI エージェントのドキュメント](https://docs.zenavo.app/ja-JP/ai-agents)と [Skills ページ](https://zenavo.app/ja-JP/skills)をご覧ください。

## 2. プロジェクトの状態とデプロイ履歴を確認する

まずは読み取りの指示を送って、対象のプロジェクトが見えているか確認します。

```text
Zenavo 上のプロジェクトを確認して、各サービスの状態と直近のデプロイ結果を一覧にして。
```

Claude Code が MCP を呼び出し、サービス一覧、現在の状態（Running / Crashed など）、最近のビルド・デプロイジョブを表示します。

安全上の設計として、**MCP は環境変数の平文の値を一切返さず**（変数名のみ）、**データベースの行の読み取りやバックアップのダウンロードも行えません**。トラブル調査の途中でモデルのコンテキストに情報が渡っても、シークレットや顧客データが漏れないようになっています。

## 3. ログからビルドや起動の失敗原因を特定する

デプロイが失敗したりコンテナが再起動を繰り返したりするときは、自分でログを最初からめくる代わりに、どの段階で落ちたかを調べさせます。

```text
web サービスの直近の失敗したデプロイを調べて。
依存関係のインストール、ビルド、コンテナ起動、ヘルスチェックのどこで失敗したかログから判断し、該当するエラー行と修正案を出して。
```

原因が分かったら、そのまま対処に進めます。

- **依存関係やビルドのエラー**：ローカルで Claude Code にコードを直させ、ビルドが通ることを確認して GitHub にプッシュします。
- **環境変数の不足**：確認のうえで変数を追加させ、サービスを再起動します。
- **ポートやヘルスチェックの不一致**：アプリが `0.0.0.0` でリッスンしているか、サービスの HTTP ポート設定と一致しているかを確認します。

## 4. デプロイを実行して起動を確認する

手動でリリースしたいときは、次のように指示できます。

```text
テストプロジェクトの web サービスをデプロイして。ビルドとロールアウトが終わるまで追跡し、起動ログにエラーがないか確認して。
```

注意：**Zenavo がデプロイするのは、サービスに設定されているリモートの Git ブランチまたは Docker イメージです**。手元で変更したまだ `git push` していないコードは、先にリポジトリへプッシュしてからデプロイを指示してください。

状態を変更する操作（デプロイ、再起動、変数の変更、ロールバック）は、実行前に対象サービスとパラメーターの確認を求められます。

## 5. 問題が起きたらすぐにロールバックする

リリースしたばかりの新しいバージョンに不具合があった場合は、直前の正常なバージョンへ戻せます。

```text
web サービスのデプロイ履歴を見て、前回成功したバージョンにロールバックし、サービスが正常に戻ったか確認して。
```

ロールバックの前に1つだけ注意してください。**サービスのロールバックは当時のイメージと環境変数を戻すだけで、データベースのスキーマやボリュームは戻しません**（詳しくは[ロールバック](https://docs.zenavo.app/ja-JP/operations/rollbacks)をご覧ください）。今回のリリースで後方互換性のないデータベースマイグレーションを実行していた場合は、旧バージョンのコードが現在のデータベース構造で動くか先に確認してください。

## 6. 監査ログと権限の取り消し

MCP 経由で行われたデプロイ、再起動、ロールバック、変数の変更はすべてコンソールの[監査ログ](https://docs.zenavo.app/ja-JP/account/audit-log)に記録されます。

`zenavo-mcp login` で作成されたキーは、コンソールの **アカウント → API キー** に `MCP on <コンピュータ名>` という名前で表示され、有効期限は 90 日です。PC を買い替えたときや使わなくなったときは、この画面から削除すればすぐにアクセスを取り消せます。

## よくある質問

**サーバーの購入、プロジェクトの削除、データベースの中身の参照はできますか？**
できません。Zenavo MCP は、サーバーの購入・削除、プロジェクトの削除、請求設定の変更、コンテナターミナルの操作、データベースの行の読み取り、バックアップのダウンロードといったリスクの高い操作をあえて含めていません。これらはコンソールから人間が行います。

**プラグインを入れたのにプロジェクトが見えません**
ターミナルで `zenavo-mcp login` を実行したか、認証時のプロジェクト選択で対象のプロジェクトにチェックを入れたか確認してください。対象プロジェクトを増やしたいときは、もう一度 `zenavo-mcp login` を実行します。

**読み取り専用とデプロイ権限はどう使い分けるのがよいですか？**
本番プロジェクトは普段**読み取り専用**にしておき、ログの調査や修正コードの作成に使い、開発・ステージング用のプロジェクトで**デプロイ**権限を許可して「コード修正 → プッシュ → デプロイ → ログ確認」までを一気に任せる運用がおすすめです。

**コンソール内蔵の Zenavo Agent と Claude Code MCP の違いは？**
[Zenavo Agent](https://docs.zenavo.app/ja-JP/zenavo-agent) は Web コンソールに組み込まれており（Dev・Pro・Team プランにそれぞれ月 30・100・300 クレジット付属）、サービスの画面を開いてそのまま原因を聞いたり、確認カードで設定を変えたりできます。一方、Claude Code + `zenavo-mcp` は手元のターミナルでソースコードと一緒に動くため、本番ログを見ながらローカルのコードを修正し、GitHub へプッシュして再デプロイするまでを1つの流れで進められます。Claude Code で DeepSeek などのモデルを切り替えたりチームの API 利用枠をまとめたい場合は、Zenavo 上で [Magpie](https://zenavo.app/ja-JP/blog/self-host-magpie) や [New API](https://zenavo.app/ja-JP/blog/self-host-new-api) ゲートウェイをセルフホストし、ブラウザ用の [Open WebUI](https://zenavo.app/ja-JP/blog/self-host-open-webui) や [LobeHub](https://zenavo.app/ja-JP/blog/self-host-lobehub) と同じゲートウェイでつなぐこともできます。

まずはテスト用のプロジェクトで試してみましょう。`zenavo-mcp login` を実行して `zenavo@zenavo` プラグインを入れ、Claude Code にログ調査やデプロイを任せてみてください。