ToRun MCP 서버
마지막 업데이트: 11 11월 2026
소개
ToRun MCP 서버를 사용하면 코딩 에이전트가 프로젝트를 작업하는 동안 ToRun을 쓸 수 있습니다. Claude Code, Cursor, opencode처럼 원격 MCP 서버를 지원하는 에이전트는 사용자가 편집기를 떠나지 않아도 이미지, 음성, 음악, 동영상을 만들고, 이미지를 편집하고, 오디오를 텍스트로 옮기고, 심층 리서치와 ToRun의 워크플로 템플릿을 실행하고, HTML 페이지나 브라우저 게임을 링크로 게시할 수 있습니다. 에이전트가 만든 것은 앱과 같은 가격으로 ToRun 계정에서 결제되며, 앱에서 만든 것과 똑같이 ToRun 계정에 저장됩니다.
주소와 로그인
| 서버 주소 | https://mcp.torun.ai/mcp |
| 전송 방식 | HTTP(원격 MCP 서버) |
| 로그인 | Authorization: Bearer <your developer key> |
개발자 키는 trn_live_로 시작합니다. 키는 ToRun 계정의 개발자 페이지에서 만듭니다. 개발자 키를 참고하세요. 도구별 설정:
도구
| 도구 | 하는 일 | 유료 |
|---|---|---|
image_generate |
프롬프트로 이미지를 만듭니다: 스프라이트, 아이콘, 배경, 일러스트. 이미지를 돌려주며, 에이전트가 정한 대기 시간보다 오래 걸리면 작업 ID를 돌려줍니다. | 예 |
image_edit |
글로 쓴 지시에 따라 이미지를 바꿉니다: 새 배경, 다른 색, 물체 추가나 제거, 다른 스타일. 이미지는 에이전트가 ToRun으로 만든 것이거나, 최대 20 MB의 PNG, JPEG, WebP 파일 링크입니다. 링크로 준 이미지는 먼저 ToRun 라이브러리에 저장됩니다. image_generate처럼 이미지나 작업 ID를 돌려줍니다. |
예 |
tts_generate |
텍스트를 음성으로 바꾸고, 오디오 파일과 파일에서 측정한 재생 길이를 돌려줍니다. | 예 |
stt_transcribe |
오디오나 동영상 파일의 말소리를 텍스트로 바꾸며, 에이전트가 요청하면 자막용 시간 구간도 함께 줍니다. 최대 25 MB의 mp3, m4a, wav, webm, ogg, opus, flac, aac, mp4 파일을 받습니다. | 예 |
music_generate |
보컬이 있거나 없는 트랙을 작곡하고 작업 ID를 돌려줍니다. | 예 |
video_generate |
프롬프트로 짧은 클립을 만들고 작업 ID를 돌려줍니다. | 예 |
job_status |
이미지, 음악, 동영상 작업의 진행 상황을 알려 주고, 준비되면 파일을 돌려줍니다. | 무료 |
deep_research_start |
질문에 대한 심층 리서치를 시작합니다. 여러 출처에 걸쳐 웹을 검색하고 출처를 밝힌 보고서를 씁니다. 작업 ID를 돌려줍니다. | 예 |
deep_research_status |
심층 리서치의 진행 상황을 알려 주고, 준비되면 보고서를 돌려줍니다. | 무료 |
workflow_template_search |
기성 다단계 파이프라인인 ToRun의 워크플로 템플릿을 찾아, 각각 무엇을 출력하는지, 보통 비용이 얼마인지, 어떤 입력을 받는지 보여 줍니다. | 무료 |
workflow_run |
에이전트가 주는 입력으로 워크플로 템플릿을 실행하고 작업 ID를 돌려줍니다. | 예 |
workflow_run_status |
워크플로 실행의 진행 상황과 지금까지 든 Runs를 알려 주고, 준비되면 결과를 돌려줍니다. | 무료 |
canvas_publish |
단일 파일 HTML 페이지나 브라우저 게임을 링크로 게시합니다. | 무료 |
account_balance |
남은 요금제 사용량과 지갑 잔액, 이 키의 월 한도와 지출액을 보여 줍니다. | 무료 |
도구가 돌려주는 파일 링크는 로그인 없이 내려받을 수 있으므로 에이전트가 파일을 프로젝트에 저장할 수 있습니다. 물음표 뒤의 부분까지 포함해 링크 전체를 보관하세요.
게시된 페이지는 비공개 링크입니다. 링크가 있는 사람은 누구나 열 수 있지만, ToRun 탐색에는 표시되지 않으며 검색 엔진도 색인하지 않습니다.
오래 걸리는 작업
음악, 동영상, 심층 리서치, 워크플로 실행은 호출 한 번보다 오래 걸립니다. 도구가 작업 ID를 돌려주면 에이전트는 결과가 준비될 때까지 다시 묻습니다. 이미지, 음악, 동영상은 job_status, 리서치 보고서는 deep_research_status, 워크플로 실행은 workflow_run_status를 씁니다. 에이전트가 정한 대기 시간 안에 준비되지 않은 이미지도 작업 ID로 돌아옵니다.
리서치는 1~10분이 걸리며 에이전트와의 대화가 끝나도 계속 진행됩니다. 보고서는 ToRun 채팅 목록에도 별도의 대화로 나타납니다. 워크플로 실행은 1분에서 수십 분이 걸리며, 실행과 그 파일은 ToRun 계정에 나타납니다. 긴 보고서나 많은 결과는 여러 부분으로 나뉘어 오며, 에이전트가 나머지를 요청합니다.
호출 비용은 어떻게 결제되나요
- 유료 호출은 모두 앱과 같은 가격으로 Runs 단위로 청구됩니다.
- 먼저 요금제 사용량에서 결제되고, 키에서 허용했다면 그다음 지갑에서 결제됩니다.
- 무료 사용량은 API 호출 비용을 결제하지 않습니다.
- 워크플로 실행은 실행되는 동안 단계별로 청구됩니다.
- 모든 청구 내역은 결제 페이지에서 그 청구를 발생시킨 키 아래에 표시됩니다.
키의 기준 금액을 넘는 호출은 먼저 묻습니다
키마다 기준 금액이 있습니다. 호출 한 번의 비용이 그보다 크면 도구는 아직 실행하지 않습니다. 워크플로 실행은 실행의 예상 비용을 비교합니다.
- 사용하는 도구가 MCP 서버의 질문에 양식을 표시할 수 있다면(MCP elicitation), ToRun이 그 양식으로 묻습니다. 양식에 가격이 표시되고 계속할지 묻습니다. 동의하면 호출이 실행되고, 거절하면 아무것도 실행되지 않습니다.
- 그렇지 않으면 도구가 가격을 알려 주고 에이전트가 그 가격을 보여 주며, 동의한 뒤 에이전트가 호출을 다시 할 때만 실행됩니다.
묻는 것 자체에는 비용이 들지 않습니다.
한도
키마다 월 지출 한도와 일일 지출 한도, 분당 호출 수 한도가 있습니다. 계정마다 하루에 게시할 수 있는 페이지 수 한도도 있습니다. 키의 월 한도와 기준 금액은 키를 만들 때 정하며, 기본값은 torun.ai/developers에 있습니다. 바꾸려면 원하는 설정으로 새 키를 만들고 이전 키를 취소하세요.
호출이 거부될 때
| 에이전트가 받는 안내 | 해결 방법 |
|---|---|
| 호출에 개발자 키가 필요합니다 | TORUN_API_KEY에 키 전체가 들어 있는지, 키가 취소되지 않았는지 확인하세요. |
| 요금제 사용량을 다 썼고 키가 지갑에서 지출할 수 없습니다 | 사용량이 갱신될 때까지 기다리거나 지갑에서 지출할 수 있는 키를 만드세요. |
| 개발자 키는 유료 요금제 사용량이나 지갑만 사용합니다 | 충전하거나 구독하세요. |
| 키가 월 또는 일일 지출 한도에 도달했습니다 | 다음 날이나 다음 달까지 기다리거나 한도가 더 높은 키를 만드세요. |
| 키가 1분 동안 너무 많이 호출했습니다 | 잠시 기다린 뒤 다시 시도하세요. |
| 키에 도구가 필요로 하는 범위가 없습니다 | 키의 범위는 바꿀 수 없습니다. 새 키를 만드세요. 새 키에는 모든 범위가 있습니다. |
| 파일은 ToRun 라이브러리 ID나 https 링크 중 하나로만 지정해야 합니다 | 둘 중 정확히 하나만 주세요. |
| 계정의 ToRun 라이브러리에 그런 파일이 없습니다 | 이 계정의 파일을 쓰세요. 다른 계정의 파일을 가리키는 ToRun 링크도 같은 방식으로 거부됩니다. |
| 파일이 너무 크거나, 도구가 받는 형식이 아니거나, 내려받을 수 없습니다 | image_edit용 이미지: PNG, JPEG, WebP, 최대 20 MB. stt_transcribe용 파일: mp3, m4a, wav, webm, ogg, opus, flac, aac, mp4, 최대 25 MB. 링크는 로그인 없이 내려받을 수 있어야 합니다. |