Servidor MCP para clientes de IA

TikMatrix incluye un servidor MCP. Una vez activado, una aplicación de IA en el mismo equipo — Claude Desktop, Claude Code, Cursor o cualquier otro cliente MCP — puede ver tus dispositivos, cuentas y tareas, planificar nuevas tareas y leer registros y capturas de pantalla, todo desde un chat.

La IA nunca cambia nada por su cuenta. Crear, detener o reintentar tareas, y añadir un script personalizado, esperan tu aprobación en la ventana de TikMatrix.

Requisito de licencia

El servidor MCP está disponible en los planes Pro, Team y Business, igual que la API local. En Starter, el cliente de IA puede conectarse, pero cada herramienta responde con un mensaje de actualización.

Activarlo

1. Abre TikMatrix → Configuración → API para desarrolladores.
2. Activa Clientes de IA (MCP). Está desactivado por defecto.
3. Copia la configuración de tu cliente de IA desde la misma sección. Ya contiene el nombre correcto del servidor, la dirección y, en el caso de Claude Desktop, la ruta completa al programa TikMatrix en este equipo.

TikMatrix debe estar en ejecución mientras lo usas. El servidor solo responde a este equipo: otras máquinas de tu red no pueden acceder a él.

Conecta tu cliente de IA

Claude Desktop

Claude Desktop inicia los servidores MCP como programas, así que TikMatrix ofrece un pequeño modo de retransmisión. Abre Settings → Developer → Edit Config en Claude Desktop y añade el fragmento copiado desde TikMatrix a claude_desktop_config.json. Tendrá este aspecto; la ruta es la de tu equipo:

{
  "mcpServers": {
    "tikmatrix": {
      "command": "C:\\Program Files\\TikMatrix\\TikMatrix.exe",
      "args": ["--mcp-stdio"]
    }
  }
}

Reinicia Claude Desktop. La opción --mcp-stdio no abre una segunda ventana; solo retransmite mensajes a TikMatrix, que ya está en ejecución.

Claude Code

claude mcp add --transport http tikmatrix http://127.0.0.1:50809/mcp

Cursor y otros clientes

Los clientes que aceptan una URL de servidor se conectan directamente al endpoint Streamable HTTP:

{
  "mcpServers": {
    "tikmatrix": {
      "url": "http://127.0.0.1:50809/mcp"
    }
  }
}

El nombre del servidor cambia según la edición (tikmatrix, igmatrix o tikmatrix-pro); el fragmento de Configuración usa el correcto.

Lo que puede hacer la IA

Herramienta	Qué hace	Necesita tu aprobación
list_devices	Teléfonos conectados, si cada uno está en línea o ocupado, y sus grupos	No
list_accounts	Cuentas, el dispositivo en el que está cada una y si ha iniciado sesión	No
list_groups	Grupos de dispositivos	No
get_script_schema	La configuración que acepta cada script	No
list_tasks	Tareas, filtradas por estado, dispositivo o script	No
get_task_log	El registro de una tarea	No
get_activity_log	Actividad reciente de la aplicación	No
device_screenshot	Lo que se ve ahora mismo en la pantalla de un teléfono	No
list_custom_scripts	Tus scripts personalizados registrados	No
get_custom_script_guide	Cómo escribir un script personalizado	No
plan_tasks	Calcula exactamente qué tareas crearía una solicitud, sin crearlas	No
create_tasks	Crea las tareas de un plan	Sí
stop_task	Detiene una tarea en ejecución	Sí
retry_task	Vuelve a ejecutar una tarea fallida	Sí
create_custom_script	Escribe y registra un nuevo script personalizado	Sí
get_approval	Comprueba cómo terminó una solicitud que esperaba aprobación	No

Aprobar cambios

Cuando la IA envía un cambio, TikMatrix pasa al primer plano y muestra lo que haría: en un lote de tareas, el script, su configuración y cada dispositivo, cuenta y destino, fila por fila. Elige Aprobar para ejecutarlo o Rechazar para descartarlo.

• Si respondes en unos 50 segundos, la IA recibe el resultado de inmediato.
• Si tardas más, a la IA se le indica que la solicitud está esperando. Aprobarla más tarde sigue ejecutándola, y la IA puede preguntar por el resultado.
• Las solicitudes sin respuesta caducan a los 15 minutos, junto con el plan del que provienen.
• Las tareas creadas así muestran el origen mcp en la lista de tareas.

Ejemplos de solicitudes

• “¿Cuáles de mis teléfonos están sin conexión y qué cuentas han cerrado sesión?”
• “Calienta todas las cuentas del grupo US-1 durante 20 minutos, empezando a las 21:00 de esta noche.”
• “¿Por qué fallaron las últimas tres tareas de publicación? Muéstrame la pantalla del teléfono que falló.”

Seguridad

• Solo local. El endpoint acepta conexiones solo desde este equipo y rechaza las solicitudes hechas desde páginas web.
• Desactivado por defecto. Nada puede conectarse hasta que lo actives, y desactivarlo surte efecto de inmediato.
• Cada cambio lo apruebas tú. Esto no depende de la configuración de permisos de tu propio cliente de IA.

Solución de problemas

Mensaje	Qué hacer
"AI client access is turned off"	Activa Clientes de IA (MCP) en Configuración → API para desarrolladores.
"The app is not running"	Inicia TikMatrix y vuelve a intentarlo.
"API access requires Pro or higher plan"	Actualiza a Pro, Team o Business.
La IA dice que una solicitud está en espera, pero no aparece nada	Trae la ventana de TikMatrix al frente; la aprobación está esperando allí.