Aller au contenu principal

Serveur MCP pour clients IA

TikMatrix inclut un serveur MCP. Une fois activé, une application d'IA sur le même ordinateur — Claude Desktop, Claude Code, Cursor ou tout autre client MCP — peut voir vos appareils, comptes et tâches, planifier de nouvelles tâches et lire les journaux et captures d'écran, le tout depuis une conversation.

L'IA ne modifie jamais rien de sa propre initiative. La création, l'arrêt ou la relance de tâches, ainsi que l'ajout d'un script personnalisé, attendent votre approbation dans la fenêtre TikMatrix.

Exigences de licence

Le serveur MCP est disponible sur les forfaits Pro, Team et Business, comme l'API locale. Sur Starter, le client IA peut se connecter, mais chaque outil répond par un message de mise à niveau.

Activer​

  1. Ouvrez TikMatrix → Paramètres → API développeur.
  2. Activez Clients IA (MCP). Cette option est désactivée par défaut.
  3. Copiez la configuration de votre client IA depuis la même section. Elle contient déjà le bon nom de serveur, l'adresse et, pour Claude Desktop, le chemin complet vers le programme TikMatrix sur cet ordinateur.

TikMatrix doit être en cours d'exécution pendant son utilisation. Le serveur ne répond qu'à cet ordinateur : les autres machines de votre réseau ne peuvent pas l'atteindre.

Connecter votre client IA​

Claude Desktop​

Claude Desktop démarre les serveurs MCP comme des programmes ; TikMatrix fournit donc un petit mode relais. Dans Claude Desktop, ouvrez Settings → Developer → Edit Config et ajoutez l'extrait copié depuis TikMatrix dans claude_desktop_config.json. Il ressemble à ceci, le chemin étant celui de votre ordinateur :

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

Redémarrez Claude Desktop. L'option --mcp-stdio n'ouvre pas de seconde fenêtre ; elle relaie seulement les messages vers le TikMatrix déjà en cours d'exécution.

Claude Code​

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

Cursor et autres clients​

Les clients qui acceptent une URL de serveur se connectent directement au point de terminaison Streamable HTTP :

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

Le nom du serveur varie selon l'édition (tikmatrix, igmatrix ou tikmatrix-pro) ; l'extrait des Paramètres utilise le bon.

Ce que l'IA peut faire​

OutilCe qu'il faitNécessite votre approbation
list_devicesTéléphones connectés, indique s'ils sont en ligne ou occupés, et leurs groupesNon
list_accountsComptes, appareil sur lequel se trouve chacun et s'il est connectéNon
list_groupsGroupes d'appareilsNon
get_script_schemaLes paramètres acceptés par chaque scriptNon
list_tasksTâches, filtrées par statut, appareil ou scriptNon
get_task_logLe journal d'une tâcheNon
get_activity_logActivité récente de l'applicationNon
device_screenshotCe qui s'affiche actuellement à l'écran d'un téléphoneNon
list_custom_scriptsVos scripts personnalisés enregistrésNon
get_custom_script_guideComment écrire un script personnaliséNon
plan_tasksDétermine exactement les tâches qu'une demande créerait, sans les créerNon
create_tasksCrée les tâches d'un planOui
stop_taskArrête une tâche en coursOui
retry_taskRelance une tâche échouéeOui
create_custom_scriptÉcrit et enregistre un nouveau script personnaliséOui
get_approvalVérifie l'issue d'une demande qui attendait votre approbationNon

Approuver les modifications​

Lorsque l'IA soumet une modification, TikMatrix passe au premier plan et affiche ce qu'elle ferait : pour un lot de tâches, le script, ses paramètres et chaque appareil, compte et cible, ligne par ligne. Choisissez Approuver pour l'exécuter ou Refuser pour l'abandonner.

  • Si vous répondez dans un délai d'environ 50 secondes, l'IA reçoit le résultat immédiatement.
  • Si vous mettez plus de temps, l'IA est informée que la demande attend votre réponse. Une approbation ultérieure l'exécute quand même, et l'IA peut demander le résultat.
  • Les demandes sans réponse expirent au bout de 15 minutes, avec le plan dont elles sont issues.
  • Les tâches créées de cette façon affichent la source mcp dans la liste des tâches.

Exemples de demandes​

  • « Lesquels de mes téléphones sont hors ligne, et quels comptes sont déconnectés ? »
  • « Préchauffe tous les comptes du groupe US-1 pendant 20 minutes, à partir de 21 h ce soir. »
  • « Pourquoi les trois dernières tâches de publication ont-elles échoué ? Montre-moi l'écran du téléphone en échec. »

Sécurité​

  • Local uniquement. Le point de terminaison n'accepte que les connexions venant de cet ordinateur et refuse les requêtes émises par des pages web.
  • Désactivé par défaut. Rien ne peut se connecter tant que vous ne l'avez pas activé, et le désactiver prend effet immédiatement.
  • Chaque modification est approuvée par vous. Cela ne dépend pas des paramètres de permission de votre client IA.

Dépannage​

MessageQue faire
"AI client access is turned off"Activez Clients IA (MCP) dans Paramètres → API développeur.
"The app is not running"Démarrez TikMatrix, puis réessayez.
"API access requires Pro or higher plan"Passez à Pro, Team ou Business.
L'IA indique qu'une demande attend, mais rien n'apparaîtMettez la fenêtre TikMatrix au premier plan ; l'approbation attend là-bas.