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로 할 수 있는 일
- Claude Code, Codex, Cursor에 TinyShield를 추가하는 방법
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 기능이며, 직접 켜기 전까지는 꺼져 있습니다. 업그레이드하려면 가격을 확인하세요.
AI 에이전트에 TinyShield 추가하기
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
# 그중 하나를 허용 (이름, 번들 ID, 경로 또는 pid로 지정)
tinyshield pending allow /opt/homebrew/bin/uv
# 도메인 하나와 다른 도메인의 모든 하위 도메인을 차단
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으로 언제든 새 토큰을 만들 수 있고, 에이전트와 스크립트는 새 토큰을 알아서 가져옵니다.
- 웹사이트 접근 차단: TinyShield는 웹 브라우저에서 오는 요청을 거부하므로, 웹사이트는 TinyShield와 통신할 수 없습니다.
- 클릭과 같은 규칙: 에이전트가 만든 변경 사항은 TinyShield에서 클릭할 때와 같은 경로를 거치며, 열려 있는 창에 바로 반영됩니다.
- 누가 무엇을 했는지 확인: 에이전트나 스크립트가 내린 결정은 Decisions list에 Claude Code via MCP 또는 Command Line처럼 누가 내렸는지가 표시됩니다. Settings → MCP → Recent Activity에서는 모든 호출을 확인할 수 있습니다.
- 에이전트가 먼저 묻습니다: TinyShield는 에이전트가 알 수 없는 앱을 허용하거나, Allow All로 전환하거나, 규칙을 삭제하거나, 구성을 가져오거나, 데이터를 지우기 전에 먼저 사용자에게 묻도록 하고, 모드를 바꾸기보다 앱 하나만 허용하도록 안내합니다.
시작하기
- 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 다운로드