Packetrove を AI エージェントに接続する
対応する MCP クライアントを接続して集約 CIDR を計算したり、そのクライアントの接続を確認したりできます。以下の手順で接続し、ツールの例を参照してください。
Streamable HTTP · アカウントや API キーは不要
https://api.packetrove.com/mcp
クライアントを接続する
Claude Code または Codex をインストールしたら、このリモートサーバーを追加してください。以下のコマンドはクライアントを設定し、ローカルの Packetrove サーバーはインストールしません。
Claude Code
claude mcp add --transport http --scope user packetrove \ https://api.packetrove.com/mcpClaude Code の MCP 公式ドキュメント
クライアントで /mcp を使って接続を確認し、smallest_covering_cidr と public-ip が利用できることを確認してください。
設定後、クライアントは tools/list でツールを検出し、説明とスキーマに基づいてツールと引数を選びます。Web ページを読むだけではクライアントの設定やアクセス権の付与は行われません。
MCP から計算ツールを使う
選択したファイアウォールの許可リストや拒否リストの項目を覆う単一 CIDR を AI エージェントに計算させ、追加範囲を確認できます。
ツール名: smallest_covering_cidr
サーバーアドレス: https://api.packetrove.com/mcp
Streamable HTTP · アカウントや API キーは不要
IPv4 または IPv6 のアドレスまたは CIDR を 1～1,000 件、各 64 文字以内で受け付けます。1 回の呼び出しでは同じアドレスファミリーを使います。
引数の例
{
"inputs": [
"203.0.113.1",
"203.0.113.2",
"203.0.113.6"
]
}文書用アドレスを使った結果の例
{
"family": "ipv4",
"normalizedInputs": [
"203.0.113.1/32",
"203.0.113.2/32",
"203.0.113.6/32"
],
"cidr": "203.0.113.0/29",
"range": {
"first": "203.0.113.0",
"last": "203.0.113.7"
},
"inputAddressCount": "3",
"coveredAddressCount": "8",
"additionalAddressCount": "5"
}cidr と range で対象ネットワークを確認し、ルールに適用する前に additionalAddressCount を確認してください。IPv6 の精度を保つため、アドレス数はすべて十進数の文字列です。
リモート MCP 呼び出しでは入力をサーバーに送信します。Web 計算はブラウザー内で実行します。このツールは単一 CIDR を計算します。リスト全体の項目数制限を満たす複数の集約には、別途目標の定義が必要です。ファイアウォールのルールは変更しません。
ブラウザーの計算ツールを開くMCP から接続を確認する
MCP ツール呼び出しを行う接続のパブリック IP を AI エージェントで確認できます。
ツール名: public-ip
サーバーアドレス: https://api.packetrove.com/mcp
Streamable HTTP · アカウントや API キーは不要
空のオブジェクト {} を渡します。ツールはリクエストの接続を確認するため、検索対象の IP アドレスは受け付けません。
引数の例
{}文書用アドレスを使った結果の例
{
"ip": "203.0.113.1",
"family": "ipv4"
}例は文書用のアドレスです。実際の呼び出しでは、そのリクエストで観測した ip と family が返り、family は ipv4 または ipv6 です。
ホスト型 AI クライアントは自身の出口アドレスを返す場合があります。ブラウザーの接続にはこの Web ツールを使い、端末の接続にはそのコンピューター上で CLI を実行してください。一回の呼び出しで両方のファミリー、ローカルのプライベート IP、プロキシ前の IP を検出することはできません。結果は本人確認には使えません。
ブラウザーのパブリック IP を確認結果の読み取りとエラー処理
structuredContent またはテキストブロックの JSON を読み取ってください。アドレス数は十進数の文字列か任意精度整数として保持してください。大きな IPv6 の値を浮動小数点数に変換すると精度が失われます。
isError が true の場合は再試行前にエラー JSON を確認してください。ユーザーの情報で INVALID_INPUT と MIXED_ADDRESS_FAMILIES を修正します。CLIENT_IP_UNAVAILABLE は信頼できる接続情報がないことを示すため、アドレスを推測しないでください。