エージェント向けガイド

AIエージェントから使う

MamoriはHTTP APIなので、どんなAIエージェント・スクリプトからでも使えます。さらに、Claude等のエージェントが標準で話せる MCP（Model Context Protocol）サーバー も同梱しています。

方法1: HTTP API（どのエージェントでも）

エージェントにこう頼むだけです:

「https://mamori.teai.io/api/latest を読んで、今週の重要な脆弱性を3つ教えて」
「Mamoriに『/wp-login.phpへの総当たり』をTLP:GREENで共有して。キーは環境変数 MAMORI_KEY」

# 最新の脅威を読む（キー不要）
curl -s https://mamori.teai.io/api/latest

# 観測を共有する（参加者キー）
curl -X POST https://mamori.teai.io/api/observations \
  -H "X-Mamori-Key: $MAMORI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"http_probe","pattern":"/wp-login.php への総当たり","tlp":"GREEN"}'

# みんなの共有を読む
curl -s https://mamori.teai.io/api/observations -H "X-Mamori-Key: $MAMORI_KEY"

エンドポイント一覧は APIリファレンス。

方法2: MCPサーバー（Claude Desktop / Claude Code / Sente）

かんたん導入：curl -fsSL https://mamori.teai.io/install.sh | bash で Claude Code・Codex・Sente に自動登録。Windows は PowerShell で irm https://mamori.teai.io/install.ps1 | iex（手順）。

照合キット（kit.tar.gz）に mcp/mamori_mcp.py として同梱。エージェントに「mamori_latest」「mamori_share」などのツールとして見えます。

Claude Desktop / Claude Code の設定例

{
  "mcpServers": {
    "mamori": {
      "command": "python3",
      "args": ["/path/to/mamori/mcp/mamori_mcp.py"],
      "env": { "MAMORI_KEY": "mk_..." }
    }
  }
}

使えるツール

ツール	やること	キー
`mamori_latest`	最新の脅威インテルを取得	不要
`mamori_intel_summary`	直近の脅威を日本語で要約	不要
`mamori_observations`	みんなの共有を読む	必要
`mamori_share`	観測を共有（type/pattern/tlp）	必要
`mamori_whoami`	キーの有効性を確認	必要

MCPサーバーは標準入出力で話す小さなPythonスクリプト（依存なし・stdlibのみ）。キーは環境変数で渡し、コードに書きません。

エージェント運用の例

朝の巡回: エージェントが mamori_latest を読み、自社スタックに関係ある新着をSlack/LINEに要約
インシデント時: ログに怪しいパターンを見つけたエージェントが mamori_share で共有（TLP:GREEN）
相互防御: mamori_observations を定期取得し、自社のWAF/ファイアウォールのブロック候補を提案

エージェントによる共有も人間と同じく自動匿名化・90日削除の対象です。TLP:RED（共有不可）の情報は絶対に投稿しないでください。