面向 AI 客户端的 MCP 服务

TikMatrix 内置了 MCP 服务。打开后，同一台电脑上的 AI 应用（Claude Desktop、Claude Code、Cursor 或其他 MCP 客户端）就能在对话里查看你的设备、账号和任务，规划新任务，读取日志和截图。

AI 不会自行改动任何东西。创建、停止、重试任务以及添加自定义脚本，都要先在 TikMatrix 窗口里由你批准。

授权要求

MCP 服务和本地 API 一样，只对 Pro、Team、Business 套餐开放。Starter 套餐下 AI 客户端可以连上，但每个工具都会返回升级提示。

打开 MCP

打开 TikMatrix → 设置 → 开发者 API。
打开 AI 客户端接入（MCP），默认是关闭的。
在同一区域复制你所用 AI 客户端的配置。配置里已经填好服务名、地址，Claude Desktop 的配置还包含本机 TikMatrix 程序的完整路径。

使用期间 TikMatrix 需要保持运行。该服务只响应本机请求，局域网里的其他电脑无法访问。

连接 AI 客户端

Claude Desktop

Claude Desktop 以启动程序的方式运行 MCP 服务，所以 TikMatrix 提供了一个转发模式。在 Claude Desktop 中打开 Settings → Developer → Edit Config，把从 TikMatrix 复制的配置加到 claude_desktop_config.json 里。格式如下，路径以你电脑上的为准：

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

然后重启 Claude Desktop。--mcp-stdio 不会再打开一个窗口，只负责把消息转发给已经在运行的 TikMatrix。

Claude Code

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

Cursor 及其他客户端

支持填写服务地址的客户端，可以直接连接 Streamable HTTP 端点：

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

服务名随版本不同（tikmatrix、igmatrix 或 tikmatrix-pro），设置页里复制的配置会自动用对的名字。

AI 能做什么

工具	作用	需要你批准
`list_devices`	已连接的手机、是否在线或忙碌、所属分组	否
`list_accounts`	账号、所在设备、是否已登录	否
`list_groups`	设备分组	否
`get_script_schema`	各脚本可用的参数	否
`list_tasks`	任务列表，可按状态、设备或脚本筛选	否
`get_task_log`	单个任务的日志	否
`get_activity_log`	最近的应用活动	否
`device_screenshot`	手机当前的屏幕画面	否
`list_custom_scripts`	已注册的自定义脚本	否
`get_custom_script_guide`	自定义脚本的编写说明	否
`plan_tasks`	算出一个请求具体会创建哪些任务，但不创建	否
`create_tasks`	按计划创建任务	是
`stop_task`	停止正在运行的任务	是
`retry_task`	重新运行失败的任务	是
`create_custom_script`	编写并注册新的自定义脚本	是
`get_approval`	查询等待批准的请求最后结果如何	否

批准操作

AI 提交操作时，TikMatrix 会弹到前台，显示这次要做什么：如果是一批任务，会列出脚本、参数，以及每一行的设备、账号和目标。点批准执行，点拒绝放弃。

约 50 秒内作出选择，AI 会立刻拿到结果。
超过这个时间，AI 会被告知请求正在等你处理。之后再批准依然会执行，AI 可以查询结果。
无人处理的请求 15 分钟后过期，对应的任务计划也一起失效。
通过这种方式创建的任务，在任务列表里来源显示为 mcp。

示例

“我哪些手机离线了？哪些账号没登录？”
“今晚 9 点开始，给 US-1 分组里的所有账号养号 20 分钟。”
“最近三个发布任务为什么失败？给我看看失败那台手机的屏幕。”

安全

仅限本机。 端点只接受本机连接，并拒绝来自网页的请求。
默认关闭。 打开开关之前任何客户端都连不上，关闭后立即生效。
每个改动都由你批准。 这一点不依赖 AI 客户端自己的权限设置。

常见问题

提示	处理方法
"AI client access is turned off"	在设置 → 开发者 API 中打开 AI 客户端接入（MCP）。
"The app is not running"	启动 TikMatrix 后重试。
"API access requires Pro or higher plan"	升级到 Pro、Team 或 Business。
AI 说请求在等待，但没看到弹窗	把 TikMatrix 窗口切到前台，批准窗口就在那里。

打开 MCP​

连接 AI 客户端​

Claude Desktop​

Claude Code​

Cursor 及其他客户端​

AI 能做什么​

批准操作​

示例​

安全​

常见问题​