Claude Code Plugin

Claude Code Plugin を使うと、Claude Code のスキルとして Manako の監視操作を自然言語で実行できます。

ヒント

MCP Server を直接使う方法もあります。詳しくは MCP Server ガイド を参照してください。Plugin は MCP Server の機能に加えて、CLI 連携やスキルによるガイド付き操作を提供します。

インストール

/plugin コマンド(推奨)

Claude Code で以下のコマンドを実行します:

1. マーケットプレイスを追加

   /plugin marketplace add elchika-inc/manako-dev

2. Plugin をインストール

   /plugin install manako@manako-dev

   インストールスコープを選択できます:

   • User (デフォルト) — 全プロジェクトで利用
   • Project — チームで共有 (.claude/settings.json に記録)
   • Local — このリポジトリのみ

3. Plugin を読み込み

   /reload-plugins

手動インストール

1. リポジトリをクローン

   git clone https://github.com/elchika-inc/manako-dev.git

2. Claude Code の設定に Plugin を追加

   .claude/settings.json の enabledPlugins にパスを追加します:

   {
     "enabledPlugins": [
       "/path/to/manako-dev/claude-code-plugin"
     ]
   }

3. Claude Code を再起動

   Plugin が読み込まれ、スキルと MCP Server が利用可能になります。

セットアップ

Plugin インストール後、Claude Code で「manako をセットアップして」と依頼すると、setup スキルがガイドします。

認証方法

CLI 認証(推奨)

Manako CLI がインストール済みの場合、最も簡単な方法です:

manako login --api-key mk_your_api_key_here

API Key は ダッシュボード の Settings > API Keys で発行できます。

MCP セッション認証

CLI がなくても、Plugin に同梱の MCP Server 設定で自動接続されます。

Claude Code に「Manako にログインして」と依頼すると、メールアドレスとパスワードでセッション認証が行われます。セッションは 24 時間 有効です。

MCP API Key 認証

環境変数で API Key を設定する方法です:

export MANAKO_API_KEY=mk_your_api_key_here

ツール優先順位

Plugin のスキルは、利用可能なツールを以下の優先順位で自動選択します:

1. CLI (manako コマンド) - ローカルにインストール済みの場合
2. MCP (Manako MCP Server) - Plugin 同梱の .mcp.json で自動設定
3. API (curl 直接呼び出し) - フォールバック

利用可能なスキル

monitor-status

モニターの状態確認・即座チェック

「モニターの状態を確認して」「稼働状況を見せて」

create-monitor

モニターの新規作成 (7 タイプ対応)

「example.com を監視して」「SSL 証明書の監視を追加して」

list-incidents

インシデント一覧・フィルタ

「進行中のインシデントはある?」「障害一覧を見せて」

acknowledge-incident

インシデントの確認済みマーク

「インシデントを確認済みにして」

monitor-status

モニターの状態を確認します。

「モニターの状態を確認して」
「モニター一覧を見せて」
「XXX モニターの詳細を教えて」
「XXX モニターを即座にチェックして」

create-monitor

新しいモニターを作成します。7 種類のモニタータイプに対応しています。

「https://example.com の HTTP 監視を作成して」
「example.com の SSL 証明書を監視して」
「example.com のドメイン期限を監視して」
「バッチジョブ用の Heartbeat モニターを作成して」

対応タイプ: HTTP, TCP, Ping, Heartbeat, WebChange, SSL, Domain

list-incidents

インシデント一覧を確認します。ステータスでフィルタリング可能です。

「インシデント一覧を見せて」
「進行中のインシデントはある?」
「解決済みインシデントを見せて」

acknowledge-incident

インシデントを確認済みにマークします。

「インシデント XXX を確認済みにして」
「進行中のインシデントを ack して」

ノート

acknowledge はインシデントを解決するものではありません。モニターが復旧を検出すると、自動的に resolved に移行します。

MCP Server との違い

機能	MCP Server	Claude Code Plugin
MCP ツール	✅	✅ (同梱)
CLI 連携	-	✅ (優先使用)
スキルガイド	-	✅ (自然言語操作)
セットアップ支援	-	✅ (setup スキル)

MCP Server は Claude Desktop など他の AI エージェントでも使えますが、Claude Code Plugin は Claude Code 専用で、CLI 連携やスキルによるガイド付き操作を追加で提供します。