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 キーの事前設定は不要です。Claude に「Manako にログインして」と依頼すると、auth ツールが呼ばれてセッションが確立されます。

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

API キー認証

環境変数で 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

メールアドレスとパスワードでログインし、セッションを確立します。

auth(email, password)

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	全ステータスページ一覧

共通オプション

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

使用例

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

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

ヒント

verbose: true を使うと、AI エージェントがより詳細な情報をもとに回答できます。