TinyShield が MCP サーバーとコマンドラインに対応
Claude Code や Codex などの AI エージェントや自作のスクリプトから、どのアプリがどこに接続しているかを確認し、Require Approval のリクエストに応答し、Block List を管理できます。TinyShield PRO の機能です。
TinyShield に MCP サーバーとコマンドラインツールが加わりました。
Claude Code、Codex、Cursor などの AI エージェントや自作のスクリプトから、どのアプリがどこに接続しているかを確認したり、Require Approval のリクエストに応答したり、Block List、Allow List、接続モードを管理したりできるようになりました。すべての処理はお使いの Mac の中で完結します。
この記事でわかること:
- 開発した理由
- AI エージェントが TinyShield でできること
- TinyShield を Claude Code、Codex、Cursor に追加する方法
tinyshieldコマンドラインの使い方- TinyShield が安全を守るしくみ
開発した理由
Require Approval は、新しいアプリごとに一度だけ確認を求めます。Mac の前にいるときは、これが最適なデフォルトです。
しかし AI エージェントは、新しい Python、パッケージマネージャー、ビルドツールなど、一日中新しいツールを作っては実行します。TinyShield にとってはどれも新しいアプリなので、そのたびに承認待ちになります。エージェントがバックグラウンドで作業しているときや、Mac から離れているときは、誰も確認画面に気づきません。ダウンロードはタイムアウトするだけで、エージェントにはその理由がわかりません。
TinyShield のあるユーザーから、エージェントやスクリプトからこれに対処する方法がほしいという要望をいただきました(issue #103)。これからは、エージェントが承認待ちのアプリを確認し、あなたの指示があれば許可できます。
AI エージェントは TinyShield で何ができる?
MCP サーバーには 32 のツールがあります。これらを使って、エージェントは次のことができます。
- アクティビティの確認:ネットワークを使ったアプリ、接続先のドメインと IP アドレス、その国、そして TinyShield のメインウインドウと同じツリーを確認できます。
- Require Approval への応答:承認待ちのアプリを一覧表示し、許可やブロックをしたり、次のアプリを待ったりできます。
- 判断の管理:App Connection Decisions を一覧表示し、変更したり、削除して TinyShield にもう一度確認させたりできます。
- リストの編集:Block List と Allow List で、ドメイン、IP アドレス、アプリを追加・削除できます。
- 接続モードの切り替え:Allow All、Require Approval、Block All を切り替えられます。
- 帯域幅の確認:過去 5 分、1 時間、1 日、1 週間、1 か月にアプリごとに使ったデータ量と、リアルタイムの通信量を確認できます。
- 設定の管理:設定の変更、構成のエクスポートやインポート、TinyShield のウインドウを開くことができます。
日本語で、ふだんどおりに頼むだけです。
- 「npm install がタイムアウトしました。TinyShield が承認待ちになっていませんか?」
- 「この 1 時間にインターネットに接続したアプリと、その接続先を教えてください。」
- 「ads.example.com と、tracker.net のすべてのサブドメインをブロックしてください。」
- 「今週いちばんデータを使ったアプリはどれですか?」
MCP & Command Line をオンにする
- TinyShield を開き、Settings → MCP に移動します。
- Enable MCP & Command Line をオンにします。
- ステータスに Running on 127.0.0.1 とポート番号が表示されます。
MCP & Command Line は TinyShield PRO の機能で、オンにするまではオフのままです。アップグレードについては価格をご覧ください。
TinyShield を AI エージェントに追加する
Settings → MCP → MCP Configuration には Claude Code、Codex、Manual の各タブがあり、それぞれに Copy ボタンがあります。表示されるコマンドは次のとおりです。
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 クライアント
Manual を選び、クライアントの MCP 設定に次の内容を追加します。
{
"mcpServers": {
"tinyshield": {
"command": "/Applications/Tiny Shield.app/Contents/MacOS/tinyshield-mcp"
}
}
}
エージェントを起動しても TinyShield は開きません。エージェントが初めてツールを使うときに、ウインドウを表示せずにバックグラウンドで起動します。
ヒント:TinyShield が「アプリケーション」フォルダにない場合は、Settings → MCP からコマンドをコピーしてください。お使いの Mac に合った正しいパスが常に入っています。
コマンドラインを使う
コマンドラインツールは、アプリ内にある tinyshield-cli です。Settings → MCP → Command Line に、シェルの設定ファイル(~/.zshrc など)に追加するエイリアスが表示されます。
alias tinyshield='"/Applications/Tiny Shield.app/Contents/MacOS/tinyshield-cli"'
新しいターミナルウインドウを開いて、試してみましょう。
# バージョン、ライセンス、接続モード、各リストの件数
tinyshield status
# Require Approval に切り替える
tinyshield mode require-approval
# 承認待ちのアプリと、接続しようとした先
tinyshield pending list
# そのうちの 1 つを許可する(名前、バンドル ID、パス、pid で指定)
tinyshield pending allow /opt/homebrew/bin/uv
# ドメインを 1 つと、別のドメインのすべてのサブドメインをブロックする
tinyshield block-list add ads.example.com '*.tracker.net'
# 過去 1 時間にブロックされたアプリ
tinyshield apps --range 1h --status blocked
# 過去 1 時間に Chrome が接続した先
tinyshield connections "Google Chrome" --range 1h
# 今週の Safari のデータ使用量
tinyshield bandwidth --timeframe week --app Safari
実行すると、次のように表示されます。
❯ tinyshield block-list add ads.example.com '*.tracker.net'
Added to the Block List: ads.example.com, *.tracker.net. The Block List is on.
tinyshield --help を実行すると、すべてのコマンドを確認できます。各コマンドは、エージェントが MCP 経由で使うものと同じツールを呼び出します。tinyshield call <tool> '<json>' を使えば、どのツールでも呼び出せます。
スクリプトで使う
どのコマンドにも --json を付けると、スクリプトで読み取れる形式で出力されます。何が起きたかは終了コードでスクリプトに伝わります。
| 終了コード | 意味 |
|---|---|
| 0 | 成功しました。 |
| 1 | コマンドが失敗しました。 |
| 3 | 見つかりません。 |
| 4 | TinyShield PRO が必要です。 |
| 69 | TinyShield に接続できません。MCP & Command Line がオフになっているか、アプリがインストールされていません。 |
たとえば tinyshield pending wait は、承認が必要なアプリが現れるまで待ち、そのアプリを表示します。タイムアウトまでにどのアプリからも要求がなければ終了コード 3 で終了するので、スクリプトでループしたり通知したりできます。
# 承認が必要な新しいアプリを最大 10 分間待つ
tinyshield pending wait --timeout 600 --only-new
安全を考えた設計
TinyShield は Mac を守るアプリです。だからこそ、安全で、すべてをあなたがコントロールできるようにしました。
- デフォルトでオフ:Enable MCP & Command Line をオンにするまで、何も接続を待ち受けません。
- この Mac だけ:サーバーは、お使いの Mac(127.0.0.1)からの接続だけを受け付けます。すべての呼び出しには、あなたのユーザーアカウントだけが読み取れるアクセストークンが必要で、トークンはサーバーが起動するたびに変わります。Regenerate Access Token でいつでも新しいトークンを作成でき、エージェントやスクリプトは自動的にそれを使います。
- Web サイトからは使えない:TinyShield は Web ブラウザからのリクエストを拒否するため、Web サイトが TinyShield とやり取りすることはできません。
- クリックと同じルール:エージェントによる変更は、TinyShield でクリックしたときと同じ経路を通り、開いているウインドウにすぐ反映されます。
- 誰が何をしたかわかる:エージェントやスクリプトによる判断は、Claude Code via MCP や Command Line のように、誰が行ったかが Decisions list に表示されます。Settings → MCP → Recent Activity には、すべての呼び出しが一覧表示されます。
- エージェントはまず確認する:TinyShield はエージェントに対し、不明なアプリの許可、Allow All への切り替え、ルールの削除、構成のインポート、データの消去を行う前にあなたに確認すること、そしてモードを変えるのではなくアプリを 1 つだけ許可することを求めています。
さっそく使ってみる
- TinyShield を最新バージョンにアップデートするか、ダウンロードします。
- Settings → MCP を開き、Enable MCP & Command Line をオンにします(TinyShield PRO)。
- Claude Code または Codex 用のコマンドをコピーして、エージェントに聞いてみましょう:「TinyShield で承認待ちになっているものはありますか?」
TinyShield だけではありません。同じチームが開発する Proxyman、TCP Viewer、Device MCP にも、MCP サーバーとコマンドラインが加わりました。詳しくは発表記事をご覧ください。
新しいツールやコマンドのアイデアがあれば、GitHub でお知らせください。
Mac を守る準備はできましたか?
TinyShield のネットワーク監視と保護の機能をぜひお試しください。パフォーマンスを損なうことなく、Mac を脅威から守ります。
TinyShield をダウンロード