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 창을 앞으로 가져오세요. 승인 요청은 그곳에서 기다리고 있습니다. |