MCP-server voor AI-clients

TikMatrix bevat een MCP-server. Zodra die is ingeschakeld, kan een AI-app op dezelfde computer — Claude Desktop, Claude Code, Cursor of een andere MCP-client — uw apparaten, accounts en taken bekijken, nieuwe taken plannen, en logs en screenshots lezen, allemaal vanuit een chat.

De AI wijzigt nooit zelfstandig iets. Taken maken, stoppen of opnieuw proberen en een aangepast script toevoegen wachten allemaal op uw goedkeuring in het TikMatrix-venster.

Licentievereiste

De MCP-server is beschikbaar voor de abonnementen Pro, Team en Business, net als de Local API. Op Starter kan de AI-client verbinding maken, maar elke tool antwoordt met een upgradebericht.

Inschakelen

1. Open TikMatrix → Instellingen → Ontwikkelaars-API.
2. Schakel AI-clients (MCP) in. Standaard staat dit uit.
3. Kopieer de configuratie voor uw AI-client uit dezelfde sectie. Die bevat al de juiste servernaam, het adres en, voor Claude Desktop, het volledige pad naar het TikMatrix-programma op deze computer.

TikMatrix moet draaien terwijl u het gebruikt. De server antwoordt alleen deze computer: andere computers op uw netwerk kunnen hem niet bereiken.

Verbind uw AI-client

Claude Desktop

Claude Desktop start MCP-servers als programma, dus TikMatrix biedt een kleine relaismodus. Open in Claude Desktop Settings → Developer → Edit Config en voeg het fragment dat u uit TikMatrix kopieert toe aan claude_desktop_config.json. Het ziet er zo uit — het pad is dat op uw computer:

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

Start Claude Desktop opnieuw. De optie --mcp-stdio opent geen tweede venster; ze stuurt alleen berichten door naar het TikMatrix dat al draait.

Claude Code

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

Cursor en andere clients

Clients die een server-URL accepteren, verbinden rechtstreeks met het Streamable HTTP-eindpunt:

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

De servernaam verschilt per editie (tikmatrix, igmatrix of tikmatrix-pro); het fragment in Instellingen gebruikt de juiste.

Wat de AI kan doen

Tool	Wat het doet	Heeft uw goedkeuring nodig
list_devices	Verbonden telefoons, of elke telefoon online of bezet is, en hun groepen	Nee
list_accounts	Accounts, het apparaat waarop elk staat, en of het is ingelogd	Nee
list_groups	Apparaatgroepen	Nee
get_script_schema	De instellingen die elk script accepteert	Nee
list_tasks	Taken, gefilterd op status, apparaat of script	Nee
get_task_log	Het log van één taak	Nee
get_activity_log	Recente appactiviteit	Nee
device_screenshot	Wat er nu op het scherm van een telefoon staat	Nee
list_custom_scripts	Uw geregistreerde aangepaste scripts	Nee
get_custom_script_guide	Hoe u een aangepast script schrijft	Nee
plan_tasks	Berekent precies welke taken een verzoek zou maken, zonder ze aan te maken	Nee
create_tasks	Maakt de taken van een plan aan	Ja
stop_task	Stopt een lopende taak	Ja
retry_task	Voert een mislukte taak opnieuw uit	Ja
create_custom_script	Schrijft een nieuw aangepast script en registreert het	Ja
get_approval	Controleert hoe een verzoek dat op goedkeuring wachtte is afgelopen	Nee

Wijzigingen goedkeuren

Wanneer de AI een wijziging indient, komt TikMatrix naar voren en toont wat het zou doen: bij een batch taken het script, de instellingen en elk apparaat, account en doel, rij voor rij. Kies Goedkeuren om het uit te voeren of Weigeren om het te laten vallen.

• Als u binnen ongeveer 50 seconden antwoordt, krijgt de AI direct het resultaat.
• Als u langer doet, wordt de AI verteld dat het verzoek op u wacht. Later goedkeuren voert het alsnog uit, en de AI kan naar het resultaat vragen.
• Onbeantwoorde verzoeken verlopen na 15 minuten, samen met het plan waaruit ze kwamen.
• Taken die zo zijn aangemaakt, tonen de bron mcp in de takenlijst.

Voorbeeldverzoeken

• “Welke van mijn telefoons zijn offline, en welke accounts zijn uitgelogd?”
• “Warm elk account in de groep US-1 20 minuten op, vanaf 9 uur vanavond.”
• “Waarom zijn de laatste drie posttaken mislukt? Laat me het scherm zien van de telefoon die faalde.”

Beveiliging

• Alleen lokaal. Het eindpunt accepteert alleen verbindingen vanaf deze computer en weigert verzoeken van webpagina's.
• Standaard uit. Niets kan verbinden totdat u het inschakelt, en uitschakelen werkt meteen.
• Elke wijziging wordt door u goedgekeurd. Dit hangt niet af van de eigen machtigingsinstellingen van uw AI-client.

Probleemoplossing

Bericht	Wat te doen
"AI client access is turned off"	Schakel AI-clients (MCP) in via Instellingen → Ontwikkelaars-API.
"The app is not running"	Start TikMatrix en probeer het opnieuw.
"API access requires Pro or higher plan"	Upgrade naar Pro, Team of Business.
De AI zegt dat een verzoek wacht, maar er verschijnt niets	Breng het TikMatrix-venster naar voren; de goedkeuring wacht daar.