AI連携 (MCP)

Claude等のAIから、直接Macのセキュリティ状況を確認

RoamSwitchには読み取り専用のMCP(Model Context Protocol)サーバーが同梱されています。Claude Desktop / Claude Codeに接続すれば、「今のMacは安全?」「外部に公開されているポートは?」と自然文で聞くだけで、RoamSwitch自身が計算した正確な診断結果に基づく回答が返ります。ロックダウン切替やポート隔離などの操作は一切できず、通信はすべて端末内のstdioのみで完結します(Zero Telemetryの延長)。

🔒 なぜ安全なのか

  • 読み取り専用: セキュリティ診断・ポート監視・ガード設定の確認のみ。ロックダウン切替、ポート隔離、デバイス取り出しなどの操作系ツールは一切実装していません。
  • 完全ローカル: 通信は標準入出力(stdio)のみ。AIクライアント(Claude Desktop/Code)とMac上のRoamSwitchプロセス間で完結し、外部サーバーへの送信は一切ありません。
  • 誤操作の防止: 操作系ツールを持たないため、プロンプトインジェクション等でファイアウォールやネットワーク設定を誤って変更されるリスクがありません。
接続方法

2ステップで設定完了

1バイナリの場所

RoamSwitch.appに同梱されています。個別のダウンロードやインストールは不要です。

/Applications/RoamSwitch.app/Contents/MacOS/RoamSwitchMCPServer

2aClaude Desktopの場合

~/Library/Application Support/Claude/claude_desktop_config.json"mcpServers" に以下を追加し、Claude Desktopを再起動してください。

{
  "mcpServers": {
    "roamswitch": {
      "command": "/Applications/RoamSwitch.app/Contents/MacOS/RoamSwitchMCPServer"
    }
  }
}

2bClaude Codeの場合

ターミナルで以下のコマンドを1回実行するだけです。

claude mcp add roamswitch /Applications/RoamSwitch.app/Contents/MacOS/RoamSwitchMCPServer

2cOpenAI Codex CLIの場合

~/.codex/config.toml に以下を追加するか、ターミナルで以下のコマンドを実行してください。

[mcp_servers.roamswitch]
command = "/Applications/RoamSwitch.app/Contents/MacOS/RoamSwitchMCPServer"
codex mcp add roamswitch -- /Applications/RoamSwitch.app/Contents/MacOS/RoamSwitchMCPServer

2dOpenCodeの場合

プロジェクト直下の opencode.json に以下を追加してください。

{
  "mcp": {
    "roamswitch": {
      "type": "local",
      "command": ["/Applications/RoamSwitch.app/Contents/MacOS/RoamSwitchMCPServer"]
    }
  }
}

2eAntigravityの場合

~/.gemini/config/mcp_config.json(またはワークスペース直下の .agents/mcp_config.json)に以下を追加してください。

{
  "mcpServers": {
    "roamswitch": {
      "command": "/Applications/RoamSwitch.app/Contents/MacOS/RoamSwitchMCPServer"
    }
  }
}
提供ツール

読み取り専用のツール

get_security_report

FileVault・SIP・Gatekeeper・ファイアウォール・Wi-Fi暗号強度・ARPスプーフィング・外部公開ポートなど10項目を総合診断し、スコアと改善アドバイスを返します。

get_exposed_ports

現在リッスン中の全ポートを一覧化し、外部公開されているものは既知の危険サービス(Redis/MongoDB等)判定を含む詳細な監査結果を返します。

get_guard_status

未知ポート自動遮断・ARPスプーフィング自動対応・USBストレージガード・Bluetoothガード・Web/Mailダウンロード保護・DNS脅威保護の有効状態と、現在の保護レベルを返します。

audit_url_safety

メール本文やWeb上のURLを引数に取り、フィッシング詐欺・Unicodeホモグラフ偽装・有名ブランド偽装サブドメイン・短縮URL展開・高リスクTLDの安全性を完全端末内(Zero Telemetry)で即座に診断します。

試せる質問例

こんな聞き方ができます

  • 「今のMacのセキュリティ状態を教えて。何か直すべきところはある?」
  • 「外部に公開されているポートはある?危険なものが動いていない?」
  • 「このメールに貼られていたURL(https://apple.com.login-verify.xyz)は開いても安全?」
  • 「自動でネットワークを遮断する機能はONになってる?」
よくある質問

MCP連携について

Q. 本当に外部と通信しませんか?

A. はい。MCPサーバーはAIクライアントに標準入出力(stdio)経由で直接起動されるローカルプロセスで、ネットワーク通信のコードを一切含んでいません。診断結果もこのMac上でその場で計算されます。

Q. Pro版でなくても使えますか?

A. はい、無料版でも全てのツールを利用できます。ただし各種自動ガードの実際の有効性はPro版のライセンス状態にも依存するため、ツール側からは設定のトグル状態のみが確認できます。

Q. 対応しているAIクライアントは?

A. MCP(Model Context Protocol)のstdioトランスポートに対応したクライアントであれば、上記以外でも基本的に利用できます。Claude Desktop・Claude Code・OpenAI Codex CLI・OpenCode・Antigravityで動作確認済みです。