Servidor MCP para clientes de IA

TikMatrix inclui um servidor MCP. Depois de ativado, um app de IA no mesmo computador (Claude Desktop, Claude Code, Cursor ou qualquer outro cliente MCP) pode ver seus dispositivos, contas e tarefas, planejar novas tarefas e ler logs e capturas de tela, tudo a partir de um chat.

A IA nunca altera nada por conta própria. Criar, parar ou repetir tarefas e adicionar um script personalizado aguardam sua aprovação na janela do TikMatrix.

Requisito de licença

O servidor MCP está disponível nos planos Pro, Team e Business, assim como a API Local. No Starter, o cliente de IA pode se conectar, mas cada ferramenta responde com uma mensagem de atualização de plano.

Ative o recurso

1. Abra o TikMatrix → Configurações → API para programadores.
2. Ative Clientes de IA (MCP). Ele vem desativado por padrão.
3. Copie a configuração do seu cliente de IA na mesma seção. Ela já contém o nome correto do servidor, o endereço e, no caso do Claude Desktop, o caminho completo para o programa TikMatrix neste computador.

O TikMatrix precisa estar em execução enquanto você o usa. O servidor responde apenas a este computador: outras máquinas da sua rede não conseguem acessá-lo.

Conecte seu cliente de IA

Claude Desktop

O Claude Desktop inicia servidores MCP como programas, por isso o TikMatrix oferece um pequeno modo de retransmissão. Abra Settings → Developer → Edit Config no Claude Desktop e adicione o trecho copiado do TikMatrix ao claude_desktop_config.json. Ele fica assim, com o caminho do seu computador:

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

Reinicie o Claude Desktop. A opção --mcp-stdio não abre uma segunda janela; ela apenas repassa as mensagens para o TikMatrix que já está em execução.

Claude Code

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

Cursor e outros clientes

Clientes que aceitam a URL de um servidor se conectam diretamente ao endpoint Streamable HTTP:

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

O nome do servidor muda conforme a edição (tikmatrix, igmatrix ou tikmatrix-pro); o trecho em Configurações já usa o correto.

O que a IA pode fazer

Ferramenta	O que faz	Precisa da sua aprovação
list_devices	Telefones conectados, se cada um está online ou ocupado, e seus grupos	Não
list_accounts	Contas, o dispositivo de cada uma e se está logada	Não
list_groups	Grupos de dispositivos	Não
get_script_schema	As configurações que cada script aceita	Não
list_tasks	Tarefas, filtradas por status, dispositivo ou script	Não
get_task_log	O log de uma tarefa	Não
get_activity_log	Atividade recente do app	Não
device_screenshot	O que está na tela de um telefone agora	Não
list_custom_scripts	Seus scripts personalizados registrados	Não
get_custom_script_guide	Como escrever um script personalizado	Não
plan_tasks	Calcula exatamente quais tarefas um pedido criaria, sem criá-las	Não
create_tasks	Cria as tarefas de um plano	Sim
stop_task	Para uma tarefa em execução	Sim
retry_task	Executa de novo uma tarefa com falha	Sim
create_custom_script	Escreve e registra um novo script personalizado	Sim
get_approval	Verifica como terminou um pedido que aguardava aprovação	Não

Aprovando alterações

Quando a IA envia uma alteração, o TikMatrix vem para a frente e mostra o que faria: para um lote de tarefas, o script, suas configurações e cada dispositivo, conta e destino, linha por linha. Escolha Aprovar para executar ou Recusar para descartar.

• Se você responder em cerca de 50 segundos, a IA recebe o resultado imediatamente.
• Se demorar mais, a IA é informada de que o pedido está aguardando você. Aprovar depois ainda o executa, e a IA pode pedir o resultado.
• Pedidos sem resposta expiram após 15 minutos, junto com o plano de onde vieram.
• Tarefas criadas dessa forma mostram a origem mcp na lista de tarefas.

Exemplos de pedidos

• “Quais dos meus telefones estão offline e quais contas estão deslogadas?”
• “Aqueça todas as contas do grupo US-1 por 20 minutos, começando às 21h.”
• “Por que as últimas três tarefas de post falharam? Mostre a tela do telefone que falhou.”

Segurança

• Somente local. O endpoint aceita conexões apenas deste computador e recusa pedidos feitos por páginas da web.
• Desativado por padrão. Nada pode se conectar até você ativar, e desativar tem efeito imediato.
• Toda alteração é aprovada por você. Isso não depende das configurações de permissão do seu próprio cliente de IA.

Solução de problemas

Mensagem	O que fazer
"AI client access is turned off"	Ative Clientes de IA (MCP) em Configurações → API para programadores.
"The app is not running"	Inicie o TikMatrix e tente novamente.
"API access requires Pro or higher plan"	Faça upgrade para Pro, Team ou Business.
A IA diz que um pedido está aguardando, mas nada aparece	Traga a janela do TikMatrix para a frente; a aprovação está esperando ali.