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 옵션은 두 번째 창을 열지 않습니다. 이미 실행 중인 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`	작업 하나의 로그	아니요
`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개가 실패한 이유는 무엇인가요? 실패한 휴대폰의 화면을 보여 주세요.”

보안

로컬 전용. 엔드포인트는 이 컴퓨터의 연결만 허용하며, 웹 페이지에서 보낸 요청은 거부합니다.
기본값은 꺼짐. 켜기 전까지는 아무것도 연결할 수 없으며, 끄면 즉시 적용됩니다.
모든 변경은 사용자가 승인. 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가 할 수 있는 일​

변경 승인​

요청 예시​

보안​

문제 해결​

켜기