Server MCP per i client IA

TikMatrix include un server MCP. Una volta attivato, un'app IA sullo stesso computer — Claude Desktop, Claude Code, Cursor o qualsiasi altro client MCP — può vedere i tuoi dispositivi, account e attività, pianificare nuove attività e leggere log e screenshot, il tutto da una chat.

L'IA non modifica nulla da sola. Creare, interrompere o riprovare attività e aggiungere uno script personalizzato attendono la tua approvazione nella finestra di TikMatrix.

Requisito di licenza

Il server MCP è disponibile nei piani Pro, Team e Business, come l'API locale. Nel piano Starter il client IA può connettersi, ma ogni strumento risponde con un messaggio di aggiornamento.

Attivarlo

1. Apri TikMatrix → Impostazioni → API per sviluppatori.
2. Attiva Client IA (MCP). È disattivato per impostazione predefinita.
3. Copia la configurazione per il tuo client IA dalla stessa sezione. Contiene già il nome del server corretto, l'indirizzo e, per Claude Desktop, il percorso completo del programma TikMatrix su questo computer.

TikMatrix deve essere in esecuzione mentre lo usi. Il server risponde solo a questo computer: gli altri dispositivi della tua rete non possono raggiungerlo.

Collega il tuo client IA

Claude Desktop

Claude Desktop avvia i server MCP come programma, quindi TikMatrix fornisce una piccola modalità relay. Apri Settings → Developer → Edit Config in Claude Desktop e aggiungi lo snippet copiato da TikMatrix a claude_desktop_config.json. Ha questo aspetto — il percorso è quello del tuo computer:

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

Riavvia Claude Desktop. L'opzione --mcp-stdio non apre una seconda finestra; si limita a inoltrare i messaggi al TikMatrix già in esecuzione.

Claude Code

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

Cursor e altri client

I client che accettano l'URL di un server si connettono direttamente all'endpoint Streamable HTTP:

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

Il nome del server cambia in base all'edizione (tikmatrix, igmatrix o tikmatrix-pro); lo snippet in Impostazioni usa quello corretto.

Cosa può fare l'IA

Strumento	Cosa fa	Richiede la tua approvazione
list_devices	Telefoni collegati, se ciascuno è online o occupato, e i loro gruppi	No
list_accounts	Account, il dispositivo su cui si trova ciascuno e se è connesso	No
list_groups	Gruppi di dispositivi	No
get_script_schema	Le impostazioni accettate da ogni script	No
list_tasks	Attività, filtrate per stato, dispositivo o script	No
get_task_log	Il log di una singola attività	No
get_activity_log	Attività recenti dell'app	No
device_screenshot	Ciò che è visualizzato ora sullo schermo di un telefono	No
list_custom_scripts	I tuoi script personalizzati registrati	No
get_custom_script_guide	Come scrivere uno script personalizzato	No
plan_tasks	Calcola esattamente quali attività creerebbe una richiesta, senza crearle	No
create_tasks	Crea le attività di un piano	Sì
stop_task	Interrompe un'attività in esecuzione	Sì
retry_task	Esegue di nuovo un'attività non riuscita	Sì
create_custom_script	Scrive e registra un nuovo script personalizzato	Sì
get_approval	Controlla come è terminata una richiesta in attesa di approvazione	No

Approvare le modifiche

Quando l'IA invia una modifica, TikMatrix passa in primo piano e mostra cosa farebbe: per un gruppo di attività, lo script, le sue impostazioni e ogni dispositivo, account e destinazione, riga per riga. Scegli Approva per eseguirla o Rifiuta per scartarla.

• Se rispondi entro circa 50 secondi, l'IA riceve subito il risultato.
• Se impieghi più tempo, l'IA viene informata che la richiesta è in attesa. Approvarla in seguito la esegue comunque, e l'IA può chiedere l'esito.
• Le richieste senza risposta scadono dopo 15 minuti, insieme al piano da cui provenivano.
• Le attività create in questo modo mostrano l'origine mcp nell'elenco delle attività.

Esempi di richieste

• "Quali dei miei telefoni sono offline e quali account risultano disconnessi?"
• "Scalda tutti gli account del gruppo US-1 per 20 minuti, a partire dalle 9 di stasera."
• "Perché le ultime tre attività di pubblicazione sono fallite? Mostrami lo schermo del telefono che ha fallito."

Sicurezza

• Solo locale. L'endpoint accetta connessioni solo da questo computer e rifiuta le richieste provenienti dalle pagine web.
• Disattivato per impostazione predefinita. Nulla può connettersi finché non lo attivi, e disattivarlo ha effetto immediato.
• Ogni modifica è approvata da te. Questo non dipende dalle impostazioni dei permessi del tuo client IA.

Risoluzione dei problemi

Messaggio	Cosa fare
"AI client access is turned off"	Attiva Client IA (MCP) in Impostazioni → API per sviluppatori.
"The app is not running"	Avvia TikMatrix, quindi riprova.
"API access requires Pro or higher plan"	Passa al piano Pro, Team o Business.
L'IA dice che una richiesta è in attesa, ma non appare nulla	Porta in primo piano la finestra di TikMatrix; l'approvazione è in attesa lì.