Servidor MCP de TinyShield para agentes de IA
El servidor MCP de TinyShield permite que agentes de IA como Claude Code, Codex y Cursor trabajen con TinyShield. Un agente puede ver qué apps se conectan y a dónde, responder solicitudes de aprobación de conexiones y gestionar tu Block List, tu Allow List y el modo de conexión, todo en lenguaje natural.
El MCP y la línea de comandos son funciones de TinyShield PRO.
Claude Code le pregunta a TinyShield a qué se conecta una app del tiempo y luego bloquea sus dos rastreadores.
1. Ventajas
- ✅ Pregunta a qué se conectó una app, un dominio o una dirección IP, y cuántos datos usó.
- ✅ Desbloquea el trabajo desatendido: en el modo Require Approval, un agente ve qué herramientas están en espera y permite las que le pediste ejecutar. No falla por un tiempo de espera de conexión.
- ✅ Gestiona la Block List, la Allow List, las decisiones y el modo de conexión desde un prompt.
- ✅ Sigue cada cambio: cada decisión que toma un agente aparece con su nombre en la lista Decisions de TinyShield.
- ✅ Solo local: el servidor escucha en este Mac, necesita un token de acceso y está desactivado hasta que lo actives.
2. Activar el servidor MCP
- Abre TinyShield › Settings › MCP.
- Marca Enable MCP & Command Line. El estado muestra Running on 127.0.0.1.
Settings › MCP también muestra el comando de configuración para tu agente, el alias de la línea de comandos, la lista Recent Activity con cada llamada que hicieron los agentes y los scripts, y Regenerate Access Token.
3. Agregar TinyShield a tu agente
Usa la ruta de la app TinyShield que ejecutas. En la edición de Setapp, reemplaza /Applications/Tiny Shield.app por /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 y otros clientes MCP
{
"mcpServers": {
"tinyshield": {
"command": "/Applications/Tiny Shield.app/Contents/MacOS/tinyshield-mcp"
}
}
}
Iniciar un agente no abre TinyShield. La primera vez que el agente usa una herramienta de TinyShield, TinyShield se abre en segundo plano, sin ventanas.
4. Ejemplos de prompts
- ¿A qué se conecta forecast? Bloquea los rastreadores.
- Mi compilación no puede descargar paquetes. ¿TinyShield la está reteniendo?
- Permite las herramientas de esta compilación que esperan aprobación.
- ¿Qué apps se conectaron hoy a países nuevos?
- Muéstrame todo a lo que se conectó Chrome en la última hora.
- ¿Cuántos datos usó Safari esta semana?
- Cambia a Require Approval y desactiva la excepción de DNS.
5. Herramientas disponibles
| Área | Herramientas |
|---|---|
| Estado y ajustes | get_status, set_connection_mode, get_settings, update_settings |
| Require Approval | list_pending_connections, allow_pending_connections, block_pending_connections, wait_for_pending_connections |
| Decisiones | list_decisions, update_decisions, remove_decisions |
| Block List y Allow List | list_block_rules, add_block_rules, remove_block_rules, list_allow_rules, add_allow_rules, remove_allow_rules |
| Actividad de red | 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 |
| Ancho de banda | get_bandwidth_usage, get_live_traffic |
| Configuración y ventanas | export_configuration, import_configuration, open_window |
Tu cliente MCP muestra la descripción y los argumentos de cada herramienta. Las herramientas de solo lectura están marcadas como tales, así que un cliente puede ejecutarlas sin preguntar. Las que eliminan datos o reducen la protección están marcadas como destructivas.
get_app_details y get_app_connections aceptan el nombre de una app, su bundle ID, su ruta o el pid de un proceso en ejecución. get_status también funciona sin PRO, para que un agente pueda decirte por qué las demás herramientas no están disponibles.
6. Cómo funciona
- TinyShield ejecuta un pequeño servidor en
127.0.0.1. La herramientatinyshield-mcpque inicia tu agente le reenvía cada llamada. - Cada llamada necesita un token de acceso. TinyShield escribe el token en
~/Library/Application Support/com.proxyman.ProxymanGuard/automation-server.json, que solo tu cuenta de usuario puede leer, y lo cambia cada vez que se inicia el servidor. Las herramientas solo envían el token al proceso de TinyShield que escribió el archivo. - Se rechazan las solicitudes que vienen de páginas web.
- Si desactivas el servidor en Settings, se detiene. A partir de entonces, los agentes te informan de que está desactivado en lugar de abrir TinyShield.
7. Solución de problemas
| Mensaje | Qué hacer |
|---|---|
| Tiny Shield's MCP & Command Line server is off | Actívalo en Settings › MCP. |
| …tools are part of Tiny Shield PRO | Activa tu licencia en TinyShield › License. |
| Network activity isn't available yet | Instala y permite la Network Extension. |
| No app is waiting for approval | Las solicitudes solo quedan en espera en el modo Require Approval. |
| El agente no muestra las herramientas de TinyShield | Revisa la ruta del comando de configuración y reinicia el agente, por ejemplo con /mcp en Claude Code. |