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 サーバーをオンにする
- TinyShield › Settings › MCP を開きます。
- 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 Approval | list_pending_connections, allow_pending_connections, block_pending_connections, wait_for_pending_connections |
| 決定 | list_decisions, update_decisions, remove_decisions |
| Block List と Allow List | list_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 off | Settings › MCP でオンにします。 |
| …tools are part of Tiny Shield PRO | TinyShield › License でライセンスを有効にします。 |
| Network activity isn't available yet | Network Extension をインストールして許可します。 |
| No app is waiting for approval | リクエストが承認待ちになるのは Require Approval モードのときだけです。 |
| エージェントに TinyShield のツールが表示されない | 設定コマンドのパスを確認してから、エージェントを再起動します。Claude Code なら /mcp を使います。 |