MCP-server för AI-klienter

TikMatrix innehåller en MCP-server. När den är påslagen kan en AI-app på samma dator (Claude Desktop, Claude Code, Cursor eller någon annan MCP-klient) se dina enheter, konton och uppgifter, planera nya uppgifter och läsa loggar och skärmbilder, allt från en chatt.

AI:n ändrar aldrig något på egen hand. Att skapa, stoppa eller försöka igen med uppgifter, samt att lägga till ett eget skript, väntar på ditt godkännande i TikMatrix-fönstret.

Licenskrav

MCP-servern ingår i Pro-, Team- och Business-planerna, precis som Lokalt API. På Starter kan AI-klienten ansluta, men varje verktyg svarar med ett meddelande om uppgradering.

Slå på den

1. Öppna TikMatrix → Inställningar → Utvecklar-API.
2. Slå på AI-klienter (MCP). Den är avstängd som standard.
3. Kopiera konfigurationen för din AI-klient från samma avsnitt. Den innehåller redan rätt servernamn, adress och, för Claude Desktop, den fullständiga sökvägen till TikMatrix-programmet på den här datorn.

TikMatrix måste vara igång när du använder den. Servern svarar bara den här datorn: andra maskiner i ditt nätverk kan inte nå den.

Anslut din AI-klient

Claude Desktop

Claude Desktop startar MCP-servrar som program, så TikMatrix tillhandahåller ett litet reläläge. Öppna Settings → Developer → Edit Config i Claude Desktop och lägg till utdraget som kopierats från TikMatrix i claude_desktop_config.json. Det ser ut så här, med sökvägen till din dator:

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

Starta om Claude Desktop. Alternativet --mcp-stdio öppnar inget nytt fönster; det vidarebefordrar bara meddelanden till TikMatrix som redan körs.

Claude Code

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

Cursor och andra klienter

Klienter som accepterar en server-URL ansluter direkt till Streamable HTTP-slutpunkten:

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

Servernamnet skiljer sig mellan utgåvorna (tikmatrix, igmatrix eller tikmatrix-pro); utdraget i Inställningar använder rätt namn.

Vad AI:n kan göra

Verktyg	Vad det gör	Kräver ditt godkännande
list_devices	Anslutna telefoner, om var och en är online eller upptagen, och deras grupper	Nej
list_accounts	Konton, enheten varje konto finns på och om det är inloggat	Nej
list_groups	Enhetsgrupper	Nej
get_script_schema	Inställningarna varje skript accepterar	Nej
list_tasks	Uppgifter, filtrerade på status, enhet eller skript	Nej
get_task_log	Loggen för en uppgift	Nej
get_activity_log	Nylig appaktivitet	Nej
device_screenshot	Vad som visas på en telefons skärm just nu	Nej
list_custom_scripts	Dina registrerade egna skript	Nej
get_custom_script_guide	Hur man skriver ett eget skript	Nej
plan_tasks	Räknar ut exakt vilka uppgifter en begäran skulle skapa, utan att skapa dem	Nej
create_tasks	Skapar uppgifterna i en plan	Ja
stop_task	Stoppar en pågående uppgift	Ja
retry_task	Kör en misslyckad uppgift igen	Ja
create_custom_script	Skriver och registrerar ett nytt eget skript	Ja
get_approval	Kontrollerar hur en begäran som väntade på godkännande slutade	Nej

Godkänna ändringar

När AI:n skickar in en ändring kommer TikMatrix fram och visar vad den skulle göra: för en batch med uppgifter skriptet, dess inställningar och varje enhet, konto och mål, rad för rad. Välj Godkänn för att köra den eller Neka för att släppa den.

• Om du svarar inom cirka 50 sekunder får AI:n resultatet direkt.
• Om det tar längre får AI:n veta att begäran väntar på dig. Godkännande senare kör den ändå, och AI:n kan fråga efter resultatet.
• Obesvarade begäranden går ut efter 15 minuter, tillsammans med planen de kom från.
• Uppgifter som skapats på detta sätt visar källan mcp i uppgiftslistan.

Exempel på begäranden

• “Vilka av mina telefoner är offline, och vilka konton är utloggade?”
• “Värm upp alla konton i gruppen US-1 i 20 minuter, med start klockan 21 ikväll.”
• “Varför misslyckades de tre senaste post-uppgifterna? Visa skärmen på telefonen som misslyckades.”

Säkerhet

• Endast lokalt. Slutpunkten accepterar bara anslutningar från den här datorn och nekar begäranden från webbsidor.
• Avstängt som standard. Ingenting kan ansluta förrän du slår på den, och avstängning gäller omedelbart.
• Du godkänner varje ändring. Detta beror inte på din AI-klients egna behörighetsinställningar.

Felsökning

Meddelande	Vad du ska göra
"AI client access is turned off"	Slå på AI-klienter (MCP) under Inställningar → Utvecklar-API.
"The app is not running"	Starta TikMatrix och försök igen.
"API access requires Pro or higher plan"	Uppgradera till Pro, Team eller Business.
AI:n säger att en begäran väntar, men inget syns	Ta fram TikMatrix-fönstret; godkännandet väntar där.