MCP Server

MCP (Model Context Protocol) Server を使うと、Claude Desktop や Claude Code などの AI エージェントから Manako の監視を直接操作できます。

セットアップ

Claude Code

プロジェクトの .mcp.json に以下を追加します:

{
  "mcpServers": {
    "manako": {
      "type": "http",
      "url": "https://mcp.manako.dev/mcp"
    }
  }
}

Claude Code を再起動すると、Manako のツールが利用可能になります。

Claude Desktop

設定ファイル(claude_desktop_config.json)に同様の設定を追加します。

認証

MCP Server には 2 つの認証方法があります。

ブラウザ認証(推奨)
API キー認証

API キーの事前設定は不要です。Claude に「Manako にログインして」と依頼すると、auth ツールがブラウザ認証用の URL とコードを返します。ブラウザでコードを承認すると、auth_status ツールでセッションが確立されます。

セッションは 24 時間 有効です。期限が切れた場合は再度ログインしてください。

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

{
  "mcpServers": {
    "manako": {
      "type": "http",
      "url": "https://mcp.manako.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${MANAKO_API_KEY}"
      }
    }
  }
}

export MANAKO_API_KEY=mk_your_api_key_here

利用可能なツール

auth

ブラウザ認証を開始します。認証 URL とコードが返されるので、ブラウザで承認してください。

auth()

auth_status

ブラウザ認証の承認状態を確認します。承認済みの場合、セッションが自動的に確立されます。

auth_status(deviceCode)

monitors

モニターの管理を行います。

アクション	説明	必須パラメータ
`list`	全モニター一覧	-
`get`	モニター詳細	`id`
`create`	モニター作成	`name`, `url` or `config`
`update`	モニター更新	`id`
`delete`	モニター削除	`id`

作成時のパラメータ

パラメータ	説明
`name`	モニター名
`type`	タイプ(http, tcp, ping, heartbeat, webchange, ssl, domain)
`url`	URL(HTTP タイプのショートカット)
`config`	タイプ別の設定オブジェクト
`intervalSeconds`	チェック間隔(300-86400秒)

更新時のパラメータ

パラメータ	説明
`id`	モニター ID
`name`	新しい名前
`isActive`	有効/無効の切り替え
`intervalSeconds`	新しいチェック間隔

incidents

インシデントの管理を行います。

アクション	説明	必須パラメータ
`list`	インシデント一覧	-
`acknowledge`	確認済みにする	`id`
`create`	手動インシデント作成	`title`
`update`	インシデント更新	`id` + `title` or `cause`
`resolve`	インシデント解決	`id`
`delete`	手動インシデント削除	`id`

list では status パラメータで絞り込みが可能です(ongoing, resolved, acknowledged)。 create は cause(説明)をオプションで指定できます。resolve 時にも cause で解決メモを追加できます。

status-pages

ステータスページの管理を行います。

アクション	説明	必須パラメータ
`list`	全ステータスページ一覧	-
`stats-reset`	モニター統計リセット	`id`

notification-channels

通知チャンネルのテストを行います。

アクション	説明	必須パラメータ
`test`	テスト通知送信	`id`

webhook-subscriptions

イベント Webhook サブスクリプションの管理を行います。

アクション	説明	必須パラメータ
`list`	サブスクリプション一覧	-
`create`	サブスクリプション作成	`targetUrl`, `secret`, `events`
`delete`	サブスクリプション削除	`id`

対応イベント: incident.created, incident.resolved, webchange.detected

audit-logs

監査ログの閲覧を行います(有料プランのみ)。

アクション	説明	必須パラメータ
`list`	監査ログ一覧	-

actionFilter, resourceType, userId, from, to, limit でフィルタリング可能です。

共通オプション

全ツールで verbose: true を指定すると、API レスポンスの完全な JSON データを取得できます。

使用例

AI エージェントに以下のように依頼できます:

「Manako にログインして」
「モニターの一覧を見せて」
「example.com の HTTP モニターを作成して」
「進行中のインシデントはある?」
「モニター XXX を一時停止して」