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 の「見つける」には表示されず、検索エンジンにもインデックスされません。
時間のかかるジョブ
音楽、動画、ディープリサーチ、ワークフローの実行は、1 回の呼び出しより時間がかかります。ツールはジョブ ID を返し、エージェントは結果ができるまで問い合わせを続けます。画像、音楽、動画には job_status、リサーチのレポートには deep_research_status、ワークフローの実行には workflow_run_status を使います。エージェントが選んだ待ち時間内にできあがらなかった画像も、ジョブ ID として返されます。
リサーチには 1〜10 分かかり、エージェントとの会話が終わっても続きます。レポートは ToRun のチャット一覧にも独立した会話として表示されます。ワークフローの実行には 1 分から数十分かかり、実行とそのファイルは ToRun アカウントに表示されます。長いレポートや多数の結果は分割して届き、エージェントが残りを要求します。
呼び出しの支払い方法
- 有料の呼び出しは、アプリと同じ価格で Runs として課金されます。
- まずプランの利用枠から支払われ、キーで許可していればその後ウォレットから支払われます。
- 無料枠が API 呼び出しの支払いに使われることはありません。
- ワークフローの実行は、実行中にステップごとに課金されます。
- すべての課金は、請求ページでその課金を行ったキーの下に表示されます。
キーのしきい値を超える呼び出しは事前に確認されます
キーにはそれぞれしきい値があります。1 回の呼び出しがそれより高くなる場合、ツールはまだ実行しません。ワークフローの実行では、その実行の見積もりが比較されます。
- MCP サーバーが質問したときにフォームを表示できるツール(MCP elicitation)では、ToRun がそこで確認します。フォームには価格が表示され、続行するかどうかが尋ねられます。承認すれば呼び出しは実行され、断れば何も実行されません。
- それ以外の場合、ツールは価格を返し、エージェントがそれをあなたに示します。あなたが同意したあとにエージェントが呼び出しをやり直したときだけ、呼び出しが実行されます。
確認すること自体に料金はかかりません。
上限
キーごとに月間と 1 日の支出上限、および 1 分あたりの呼び出し数の上限があります。アカウントごとに、公開できるページ数の 1 日の上限もあります。キーの月間上限としきい値はキーの作成時に設定します。既定値は torun.ai/developers に記載されています。変更するには、希望する設定で新しいキーを作成し、古いキーを取り消してください。
呼び出しが拒否されたとき
| エージェントに伝えられる内容 | 対処方法 |
|---|---|
| 呼び出しには開発者キーが必要 | TORUN_API_KEY にキー全体が入っていること、キーが取り消されていないことを確認します。 |
| プランの利用枠を使い切っていて、キーがウォレットから支払えない | 利用枠が更新されるのを待つか、ウォレットから支払えるキーを作成します。 |
| 開発者キーが使えるのは有料プランの利用枠かウォレットだけ | チャージするか、プランに登録します。 |
| キーが月間または 1 日の支出上限に達した | 翌日か翌月まで待つか、上限の高いキーを作成します。 |
| キーの 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。リンクはサインインせずにダウンロードできる必要があります。 |