Saltar al contenido principal

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​

  1. Abre TinyShield › Settings › MCP.
  2. 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​

ÁreaHerramientas
Estado y ajustesget_status, set_connection_mode, get_settings, update_settings
Require Approvallist_pending_connections, allow_pending_connections, block_pending_connections, wait_for_pending_connections
Decisioneslist_decisions, update_decisions, remove_decisions
Block List y Allow Listlist_block_rules, add_block_rules, remove_block_rules, list_allow_rules, add_allow_rules, remove_allow_rules
Actividad de redlist_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 bandaget_bandwidth_usage, get_live_traffic
Configuración y ventanasexport_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 herramienta tinyshield-mcp que 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​

MensajeQué hacer
Tiny Shield's MCP & Command Line server is offActívalo en Settings › MCP.
…tools are part of Tiny Shield PROActiva tu licencia en TinyShield › License.
Network activity isn't available yetInstala y permite la Network Extension.
No app is waiting for approvalLas solicitudes solo quedan en espera en el modo Require Approval.
El agente no muestra las herramientas de TinyShieldRevisa la ruta del comando de configuración y reinicia el agente, por ejemplo con /mcp en Claude Code.