AI クライアント向け MCP サーバー

TikMatrix には MCP サーバーが含まれています。有効にすると、同じコンピューター上の AI アプリ（Claude Desktop、Claude Code、Cursor など任意の MCP クライアント）が、チャットからデバイス、アカウント、タスクを確認したり、新しいタスクを計画したり、ログやスクリーンショットを読んだりできます。

AI が自分で何かを変更することはありません。タスクの作成、停止、再試行、カスタムスクリプトの追加はすべて TikMatrix ウィンドウでのあなたの承認 を待ちます。

ライセンス要件

MCP サーバーは、ローカル API と同様に Pro、Team、Business プランで利用できます。Starter では AI クライアントは接続できますが、すべてのツールがアップグレードを案内するメッセージを返します。

有効にする

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 オプションは 2 つ目のウィンドウを開きません。すでに起動している TikMatrix にメッセージを中継するだけです。

Claude Code

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

Cursor およびその他のクライアント

サーバー URL を受け付けるクライアントは、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`	1 つのタスクのログ	いいえ
`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 と表示されます。

依頼の例

「オフラインのスマートフォンはどれか、ログアウトしているアカウントはどれか教えて」
「グループ US-1 のすべてのアカウントを、今夜 9 時から 20 分間ウォームアップして」
「直近 3 件の投稿タスクはなぜ失敗したか。失敗したスマートフォンの画面を見せて」

セキュリティ

ローカルのみ。 エンドポイントはこのコンピューターからの接続のみを受け付け、Web ページからの要求は拒否します。
初期状態はオフ。 オンにするまで何も接続できず、オフにするとすぐに反映されます。
すべての変更はあなたが承認。 これは 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 のウィンドウを前面に出してください。承認はそこで待っています。

有効にする​

AI クライアントを接続する​

Claude Desktop​

Claude Code​

Cursor およびその他のクライアント​

AI にできること​

変更の承認​

依頼の例​

セキュリティ​

トラブルシューティング​