メインコンテンツまでスキップ

TinyShield の MCP サーバーで AI エージェントと連携

TinyShield の MCP サーバーを使うと、Claude Code、Codex、Cursor などの AI エージェントが TinyShield を操作できます。エージェントは、どのアプリがどこに接続しているかを確認し、接続の承認リクエストに応え、Block List、Allow List、接続モードを管理できます。指示はすべて普段の言葉で伝えられます。

MCP とコマンドラインは TinyShield PRO の機能です。

Claude Code が TinyShield に天気アプリの接続先を尋ね、2 つのトラッカーをブロックします。

1. メリット​

  • ✅ アプリ、ドメイン、IP アドレスの接続先や、使ったデータ量を尋ねられます。
  • ✅ 無人の作業を止めません。Require Approval モードでは、エージェントが承認待ちのツールを確認し、あなたが実行を頼んだものを許可します。接続のタイムアウトで失敗することはありません。
  • ✅ Block List、Allow List、決定、接続モードをプロンプトから管理できます。
  • ✅ 変更を追跡できます。エージェントが行った決定は、TinyShield の Decisions の一覧にエージェントの名前付きで表示されます。
  • ✅ ローカルだけで動作します。サーバーはこの Mac 上でのみ待ち受け、アクセストークンが必要で、オンにするまでは無効です。

2. MCP サーバーをオンにする​

  1. TinyShield › Settings › MCP を開きます。
  2. Enable MCP & Command Line をオンにします。ステータスに Running on 127.0.0.1 と表示されます。

Settings › MCP には、エージェント用の設定コマンド、コマンドラインのエイリアス、エージェントやスクリプトによるすべての呼び出しを記録した Recent Activity の一覧、Regenerate Access Token もあります。

3. エージェントに TinyShield を追加する​

実行している TinyShield アプリのパスを使います。Setapp 版では、/Applications/Tiny Shield.app を /Applications/Setapp/Tiny Shield.app に置き換えてください。

Claude Code​

claude mcp add --scope user tinyshield -- "/Applications/Tiny Shield.app/Contents/MacOS/tinyshield-mcp"

Codex​

codex mcp add tinyshield -- "/Applications/Tiny Shield.app/Contents/MacOS/tinyshield-mcp"

Cursor などの MCP クライアント​

{
"mcpServers": {
"tinyshield": {
"command": "/Applications/Tiny Shield.app/Contents/MacOS/tinyshield-mcp"
}
}
}

エージェントを起動しても TinyShield は開きません。エージェントが初めて TinyShield のツールを使うときに、TinyShield がウインドウを表示せずにバックグラウンドで起動します。

4. プロンプトの例​

  • forecast の接続先は?トラッカーをブロックして。
  • ビルドがパッケージをダウンロードできない。TinyShield が止めている?
  • このビルドで承認待ちになっているツールを許可して。
  • 今日、新しい国に接続したアプリは?
  • Chrome が直近 1 時間に接続した先をすべて見せて。
  • Safari が今週使ったデータ量は?
  • Require Approval に切り替えて、DNS の例外をオフにして。

5. 使えるツール​

分野ツール
ステータスと設定get_status, set_connection_mode, get_settings, update_settings
Require Approvallist_pending_connections, allow_pending_connections, block_pending_connections, wait_for_pending_connections
決定list_decisions, update_decisions, remove_decisions
Block List と Allow Listlist_block_rules, add_block_rules, remove_block_rules, list_allow_rules, add_allow_rules, remove_allow_rules
ネットワークアクティビティlist_apps, get_app_details, get_app_connections, get_domain_details, get_ip_details, get_activity_tree, list_countries, list_recently_blocked, clear_recently_blocked, clear_network_activity
帯域幅get_bandwidth_usage, get_live_traffic
構成とウインドウexport_configuration, import_configuration, open_window

MCP クライアントには、各ツールの説明と引数が表示されます。読み取り専用のツールにはその印が付いているため、クライアントは確認なしで実行できます。データを削除するツールや保護を弱めるツールには、破壊的な操作であることを示す印が付いています。

get_app_details と get_app_connections には、アプリ名、バンドル ID、パス、または実行中のプロセスの pid を指定できます。get_status は PRO がなくても使えるため、ほかのツールが使えない理由をエージェントが説明できます。

6. 仕組み​

  • TinyShield は 127.0.0.1 で小さなサーバーを動かします。エージェントが起動する tinyshield-mcp ツールが、ツールの呼び出しをこのサーバーに転送します。
  • すべての呼び出しにアクセストークンが必要です。TinyShield はトークンを ~/Library/Application Support/com.proxyman.ProxymanGuard/automation-server.json に書き込みます。このファイルはあなたのユーザアカウントしか読み取れず、トークンはサーバーが起動するたびに新しくなります。ツールは、このファイルを書き込んだ TinyShield のプロセスにだけトークンを送ります。
  • Web ページからのリクエストは拒否されます。
  • Settings でサーバーをオフにすると、サーバーは停止します。その後、エージェントは TinyShield を開かずに、サーバーがオフであることを伝えます。

7. トラブルシューティング​

メッセージ対処方法
Tiny Shield's MCP & Command Line server is offSettings › MCP でオンにします。
…tools are part of Tiny Shield PROTinyShield › License でライセンスを有効にします。
Network activity isn't available yetNetwork Extension をインストールして許可します。
No app is waiting for approvalリクエストが承認待ちになるのは Require Approval モードのときだけです。
エージェントに TinyShield のツールが表示されない設定コマンドのパスを確認してから、エージェントを再起動します。Claude Code なら /mcp を使います。