AI 도구 활용법 – 터치디자이너 TDMCP 설치와 사용법 – AI에게 말로 시켜 노드 만들기
터치디자이너 TDMCP는 터치디자이너(TouchDesigner) 안에서 도는 MCP(Model Context Protocol) 서버입니다. 프로젝트에 컴포넌트 하나를 넣어 두면 Claude Code 같은 AI 코딩 에이전트가 오퍼레이터(Operator), 흔히 노드라고 부르는 것을 만들고 선을 잇고 값을 넣을 수 있게 돼요. 터치디자이너로 작업하는 미디어아트 작가와 학생, 노드 연결이 어려워 미뤄 둔 분이 설치 순서와 쓰기 전에 알아 둘 조건을 한 번에 볼 수 있게 정리했습니다.
미리 밝혀 둘 것이 있습니다. 저는 터치디자이너가 없어서 이 글은 직접 설치해 본 기록이 아니고, 2026년 10월 12일에 공식 저장소의 README와 LICENSE.md, 배포 페이지, 터치디자이너 라이선스 문서를 읽고 정리한 글이에요. 문서에 적힌 기능만 옮겼고 실제 동작은 확인하지 않았습니다.
터치디자이너 TDMCP는 프로젝트 안에서 도는 MCP 서버
MCP는 AI에 외부 도구를 연결하는 규격이고, 개념은 MCP 글에 따로 정리해 뒀습니다. README 첫 문장은 터치디자이너 TDMCP를 “터치디자이너 안에서 실행되는 MCP 서버”라고 소개해요. 컴포넌트 하나를 프로젝트에 넣으면 에이전트가 도구 26개를 받는데, 오퍼레이터 만들기와 연결, 파라미터 설정, DAT 읽기, 실행 중인 값 살펴보기, 터치디자이너 문서 찾아보기가 여기에 들어 있다고 합니다.
저장소는 깃허브(GitHub)의 TouchDesigner 조직 계정에 있고 이 계정의 소개 글은 “By Derivative”입니다. LICENSE.md는 소프트웨어의 소유자를 Derivative Inc.로 적었고, 1.1.55 배포 글은 TDMCP를 “the official MCP server for TouchDesigner”라고 부릅니다.
README가 적은 터치디자이너 TDMCP 지원 클라이언트는 Claude Code, Codex, Antigravity(agy), OpenCode이고, 스트리머블 HTTP(streamable-HTTP) 방식의 MCP를 쓰는 다른 클라이언트도 된다고 해요. 요구 사항 절은 Claude Code를 “다른 준비물이 없는 가장 간단한 출발점”으로 꼽습니다. Node.js 18 이상은 Claude Desktop을 쓸 때만 필요한데, Desktop은 연결 프로그램(bridge)을 하나 거쳐야 하기 때문이라고 적혀 있어요.
말로 시킨 작업은 색으로 보이고 Ctrl+Z로 되돌린다
README의 “What you get” 절은 도구 26개를 다섯 묶음으로 나눠 적었습니다. 아래 표는 그 절의 괄호 안 내용을 옮긴 것이에요.
| 묶음 | README가 적은 일 |
|---|---|
| 오퍼레이터 | 만들기, 연결, 옮기기, 지우기, 주석 달기 |
| 파라미터 | 읽기, 설정, 펄스, 사용자 파라미터 추가, 이름 찾기 |
| 내용과 검사 | DAT 글자, CHOP 채널, TOP 픽셀, 지오메트리, 스크린샷, 파이썬 |
| 조회와 이동 | 둘러보기, 검색, 연결 관계, 터치디자이너 문서 |
| 프로젝트 | 정보, 저장, 오류, 쿡(cook) 성능 |
수정 도구로 한 변경은 실행 취소(Undo) 묶음에 들어갑니다. README 표현으로는 도구 호출 한 번이 되돌리기 한 단계라서 Ctrl+Z로 하나씩 물릴 수 있어요. 주석 만들기는 지금 예외라고 적혀 있습니다.
화면 쪽 설명도 있습니다. 네트워크 편집기가 에이전트가 건드리는 곳으로 따라 움직이고 그 오퍼레이터를 깜빡여 보여 주는데, 수정은 호박색(amber), 살펴보기는 파란색(blue), 보기는 보라색(violet)이라고 해요. 저장소에는 이 장면을 담은 그림이나 영상이 없어서 글에 화면을 싣지는 못했습니다.
스킬(Skills)도 같이 설치합니다. README는 스킬을 터치디자이너가 일을 처리하는 방식을 에이전트에게 알려 주는 자료로 설명하고, 스킬이 없으면 에이전트가 파라미터 이름을 짐작해서 그럴듯해 보이지만 틀린 네트워크를 만든다고 적었어요. 스킬이라는 개념은 에이전트 스킬 글에서 다뤘습니다.
MCP – AI에 도구를 연결하는 표준보충 자료, 터치디자이너 TDMCP 설치 4단계와 처음 시켜 볼 요청문
README의 빠른 시작(Quick start)은 “컴포넌트 넣기”, “에이전트 연결”, “확인” 세 절이고 그 안에 작은 단계가 일곱 개 있습니다. 아래 4단계는 그 순서를 바꾸지 않고 제가 넷으로 묶은 것이에요.
- 저장소의 Releases에서 TDMCP.tox를 내려받는다
- 터치디자이너 프로젝트의 루트에 끌어다 놓고, 컴포넌트의 MCP 페이지에서 Active를 켠다
- MCP 페이지에서 Install For(기본값 Claude Code)와 Install Scope를 고른 뒤, Add MCP에 나온 명령을 복사해 프로젝트 폴더의 터미널에서 실행한다
- 같은 페이지의 Install Skills를 누른다
3단계의 명령은 직접 치는 것이 아니고 컴포넌트가 만들어 줍니다. README는 Add MCP와 Remove MCP가 지금의 포트, 서버 이름, HTTPS 사용 여부, 인증 설정에서 다시 만들어지기 때문에 명령이 실제로 돌고 있는 서버와 늘 맞는다고 설명해요. Claude Code를 기본 설정으로 골랐을 때 나오는 명령은 README에 이렇게 적혀 있습니다.
claude mcp add --transport http --scope local touchdesigner http://127.0.0.1:13316/mcpREADME는 이 명령을 프로젝트 디렉터리에서 실행하라고 적었어요. 셸 명령이라 프로젝트 폴더에서 터미널을 열고 붙여 넣으면 됩니다.
연결이 됐는지는 claude mcp list로 봅니다. README의 예시 출력에는 touchdesigner 줄 끝에 Connected 표시가 붙어 있어요. 그다음에 에이전트에게 보낼 문장 두 개가 README에 그대로 실려 있습니다.
| 순서 | README의 요청문 | 뜻 |
|---|---|---|
| 연결 확인 | What TouchDesigner project am I connected to? | 지금 연결된 터치디자이너 프로젝트가 무엇인지 묻는다 |
| 첫 작업 | Create a noise TOP, blur it, and end the chain in a null. | 노이즈 TOP을 만들고 블러를 건 뒤 null로 끝낸다 |
첫 문장에 맞는 답이 오면 서버가 돌고 있고, 클라이언트가 서버를 찾았고, 도구 호출이 한 번 오갔다는 뜻이라고 README는 설명합니다.
README에 있는 요청문은 이 두 개가 전부입니다. 아래 세 문장은 “What you get” 절에 적힌 기능(오류 조회, 파라미터 읽기, 문서 찾기)에 맞춰 제가 예시로 써 본 문장이며 결과를 확인한 것은 아니에요.
- 지금 프로젝트에 오류가 난 오퍼레이터가 있으면 알려 줘.
- noise1의 파라미터 값을 읽어서 표로 정리해 줘.
- Feedback TOP 사용법을 터치디자이너 문서에서 찾아서 요약해 줘.
연결이 안 될 때 README가 먼저 보라는 곳
Active가 켜져 있는지, Add MCP의 포트가 클라이언트에 등록한 값과 같은지 확인하고 클라이언트를 다시 시작합니다. 주소는 localhost가 아닌 127.0.0.1을 쓰라고 적혀 있어요. 소켓이 IPv4 전용이라 localhost로는 연결 거부가 날 수 있다는 설명입니다.
쓰기 전에 알아 둘 것, 베타와 삭제 확인 창
터치디자이너 TDMCP의 README 첫머리에는 베타(Beta) 표시가 있고 인터페이스가 아직 바뀔 수 있다고 적혀 있습니다. 변경 기록(CHANGELOG)을 보면 1.1.52부터 1.1.55까지가 2026년 9월 24일에서 27일 사이에 나왔어요. 1.1.52부터는 About 페이지의 Update 단추로 새 배포를 확인하고 설정을 유지한 채 컴포넌트를 바꿀 수 있다고 합니다.
삭제는 따로 챙겨 둘 만합니다. MCP 페이지의 Auto-accept deletion이 기본으로 켜져 있어서 에이전트가 오퍼레이터를 지울 때 확인 창이 뜨지 않아요. README에 따르면 TDMCP가 띄우는 확인 창은 이것 하나뿐이고, 지우기 전에 물어보게 하려면 이 항목을 끄면 됩니다.
보안 절이 적은 내용
서버에는 파이썬 코드를 실행하는 execute_code 도구가 있고, README는 이 서버에 닿는 것을 “내 컴퓨터의 셸에 닿는 것과 같게” 다루라고 적었습니다. 기본 설정은 내 컴퓨터 안에서만 접속을 받는 Localhost only예요. All interfaces로 바꿔도 다른 기기에서 온 요청에는 인증(Ask for authentication)과 HTTPS를 둘 다 켰을 때만 응답하고, 하나라도 꺼져 있으면 거절한다고 합니다.
LICENSE.md의 이용 약관 쪽에는 작업 파일에 관한 문장이 있습니다. AI가 낸 결과로 파일과 프로젝트가 지워지거나 덮어써질 수 있으니 쓰기 전에 프로젝트 파일을 백업해 두라고 강하게 권한다는 내용이에요. 오브젝트 이름(object names), 노드 구조, 파라미터 값, 오류 메시지 같은 자료가 AI 서비스 쪽 서버로 전송될 수 있다는 점과, AI 서비스의 토큰 비용과 사용 한도는 Derivative가 책임지지 않는다는 점도 같은 문서에 적혀 있습니다.
에이전트 스킬 – 반복 작업을 절차로 묶는 방법터치디자이너 TDMCP 라이선스와 무료판 조건
라이선스는 Shared Use License입니다. LICENSE.md에 따르면 이 소프트웨어는 터치디자이너와 함께 쓰는 용도로만 사용하거나 고칠 수 있고, 터치디자이너의 라이선스 계약을 받아들인 사용자여야 해요. 고친 버전을 공유하거나 재배포할 때 Shared Use License 부분이 붙이는 조건은 두 가지입니다. 위 안내 문구와 조건 목록을 그대로 남겨 둘 것, 그리고 서면 허락 없이 Derivative의 이름이나 상표를 파생 제품의 홍보에 쓰지 말 것입니다. 이용 약관 쪽에는 파생물에 Derivative Inc.를 원저작자로 표시하라는 조항도 따로 있으니, 고쳐서 나눌 계획이라면 LICENSE.md 전문을 읽어 보세요.
README는 이 라이선스를 한 줄로 요약했습니다. 내 프로젝트를 위한 사용과 수정은 허용하고 TDMCP 자체를 제품으로 재배포하는 것은 금지한다는 것이고, 이걸 바탕으로 만든 것을 상업적으로 내놓기 전에 원문을 읽으라고 덧붙였어요.
무료판인 Non-Commercial에서 터치디자이너 TDMCP가 도는지는 README와 LICENSE.md에 적혀 있지 않습니다. 확인할 수 있는 것은 무료판 자체의 조건이에요. 터치디자이너 라이선스 문서의 비교표는 Non-Commercial의 해상도를 1280×1280으로 제한한다고 적었고, 같은 문서는 이 라이선스를 돈을 받는 터치디자이너 작업에 쓸 수 없다고 적었습니다. 해상도 제한은 터치디자이너 무료판에 걸린 조건이고, TDMCP 문서에는 해상도 얘기가 없습니다.
커뮤니티가 만든 터치디자이너 MCP와 다른 점
터치디자이너에 MCP를 붙이는 도구는 커뮤니티에서도 여럿 나와 있습니다. 2026년 10월 12일에 깃허브에서 확인한 값은 아래와 같아요. 별 개수는 그날의 값이고, 세 저장소의 기능은 이 글에서 읽어 보지 않았습니다.
| 저장소 | 별 개수 | 라이선스 표시 |
|---|---|---|
| 8beeeaaat/touchdesigner-mcp | 575개 | MIT |
| dylanroscover/Embody | 197개 | MIT |
| Pantani/tdmcp | 50개 | MIT |
같은 날 TouchDesigner/TDMCP 저장소의 별은 38개였고 저장소가 만들어진 날은 2026년 9월 21일입니다. 문서로 확인되는 차이는 저장소의 주인과 라이선스예요. 커뮤니티 저장소 셋은 MIT 표시가 붙어 있고, 터치디자이너 TDMCP는 TouchDesigner 조직 계정에 있으면서 Shared Use License를 씁니다.
AI에게 맡긴 결과를 내레이션까지 붙여 영상으로 만들 생각이라면 무료 AI 목소리 복제 3가지 글도 같이 보세요.
참고한 공식 문서
TDMCP 저장소의 README, LICENSE.md, Releases, 고급 설정 문서, 그리고 터치디자이너 라이선스 문서를 2026년 10월 12일에 읽고 썼습니다. 베타라서 내용이 바뀔 수 있으니 설치 전에 원문을 확인하세요.
터치디자이너 TDMCP 자주 묻는 질문
터치디자이너 TDMCP를 쓰려면 무엇이 필요한가요?
공식 문서(README)는 터치디자이너와 MCP 클라이언트를 요구 사항으로 적었습니다. 시험한 빌드는 2025.33070이고, 1.1.55 배포 글에는 2025.33070 이상이 필요하다고 적혀 있어요. Claude Code는 다른 준비물이 없고, Node.js 18 이상은 Claude Desktop을 쓸 때만 필요하다고 합니다.
터치디자이너 무료판(Non-Commercial)에서도 TDMCP가 되나요?
README와 LICENSE.md에는 무료판에서 도는지가 적혀 있지 않습니다. 무료판 자체의 조건은 터치디자이너 라이선스 문서에 있는데, 해상도가 1280×1280으로 제한되고 돈을 받는 작업에는 쓸 수 없다고 적혀 있어요.
AI가 노드를 잘못 만들거나 지우면 되돌릴 수 있나요?
README에 따르면 수정 도구로 한 변경은 실행 취소 묶음에 들어가서 Ctrl+Z로 되돌릴 수 있고, 도구 호출 한 번이 되돌리기 한 단계입니다. 주석(annotation) 만들기는 예외라고 적혀 있어요. 삭제 확인 창은 기본으로 뜨지 않으니 MCP 페이지의 Auto-accept deletion을 꺼 두면 지우기 전에 물어봅니다.
TDMCP는 어떤 AI 도구와 연결되나요?
README는 Claude Code, Codex, Antigravity(agy), OpenCode와 스트리머블 HTTP 방식의 MCP를 지원하는 다른 클라이언트를 적었습니다. 설치 대상의 기본값은 Claude Code이고, Claude Desktop은 따로 연결 프로그램(mcp-remote)을 거쳐야 한다고 해요.
글에 나온 규칙 파일과 에이전트는 Claude Code에서 쓰는 방식이고, 공식 안내는 Claude Code 공식 문서에 있습니다.
이 글은 직접 만들고 운영하며 남긴 기록입니다. 적힌 수치는 작성 시점의 제 계정 기준이며, 같은 결과나 수익을 보장하지 않습니다.
