본문으로 건너뛰기

AI 에이전트를 위한 TinyShield MCP 서버

TinyShield의 MCP 서버를 사용하면 Claude Code, Codex, Cursor 같은 AI 에이전트가 TinyShield와 함께 작업할 수 있습니다. 에이전트는 어떤 앱이 어디에 연결하는지 확인하고, 연결 승인 요청에 응답하고, Block List, Allow List, 연결 모드를 관리합니다. 모두 평소 쓰는 말로 요청하면 됩니다.

MCP와 명령줄은 TinyShield PRO 기능입니다.

Claude Code가 TinyShield에 날씨 앱의 연결 대상을 묻고, 트래커 두 개를 차단합니다.

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가 막고 있어?
  • 이 빌드에서 승인을 기다리는 도구를 허용해 줘.
  • 오늘 새로운 국가에 연결한 앱은?
  • 지난 1시간 동안 Chrome이 연결한 곳을 모두 보여 줘.
  • 이번 주에 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 프로세스에만 토큰을 보냅니다.
  • 웹 페이지에서 보낸 요청은 거부됩니다.
  • 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를 사용합니다.