MCP サーバー
MCP サーバーを使うと、AI アシスタントがあなたの Evocal アカウントで作業できます。動画を送り、吹き替えを始め、セグメントを確認・修正し、ファイルをダウンロードします。API キーを使い、クレジットとルールはアプリと同じです。
始める前に
- MCP サーバーは、API と同じく Pro、Studio、Enterprise プランに含まれます。
- アプリの アカウント、API でキーを作成します。アシスタントには専用のキーを渡しましょう。ほかを止めずにそのキーだけ無効化できます。
- アシスタント側で、ヘッダー付きのリモート MCP サーバーを追加できる必要があります。ターミナルで動くエージェントやコードエディターは対応しています。サインインでしか接続できないチャットアプリでは、まだ使えません。
接続する
サーバーのアドレスは https://www.evocal.app/api/mcp(Streamable HTTP)です。キーは Authorization ヘッダーで受け取ります。たとえば Claude Code では次のとおりです:
claude mcp add --transport http evocal https://www.evocal.app/api/mcp \
--header "Authorization: Bearer evk_..."サーバーを JSON ファイルで管理するエディターでは、次のような項目を追加します。ファイル名と正確な書き方は、お使いのエディターのガイドを確認してください。
{
"mcpServers": {
"evocal": {
"url": "https://www.evocal.app/api/mcp",
"headers": { "Authorization": "Bearer evk_..." }
}
}
}そのうえで、たとえば「lesson-4.mp4 をポルトガル語から英語に吹き替えて。始める前に費用を教えて」と頼みます。
アシスタントにできること
| ツール | 内容 |
|---|---|
get_account | 現在のプランとクレジット。 |
list_languages | 現在利用できる言語の組み合わせ。 |
list_projects | プロジェクトの一覧(新しい順)。 |
get_project | 1 つのプロジェクトと、そのファイルの状態と吹き替え。 |
create_project | 翻訳先の言語ごとに吹き替えを 1 つ持つプロジェクトを作成します。 |
start_upload | ファイルのアップロードを始め、最初のパートのアドレスを返します。 |
get_upload_part_urls | 残りのパートのアドレス、または失敗したパートの新しいアドレス。 |
complete_upload | アップロードを終えます。そのあとファイルが確認されます。 |
start_dub | 吹き替えを始めます。クレジットを使います。 |
get_job | ジョブの状態と進み具合。 |
get_dub | 1 つの吹き替えと、そこで最後に実行されたジョブ。 |
get_segments | 吹き替えのセグメント:時間、テキスト、注意。注意や編集があるものだけを表示することもできます。 |
edit_segment | セグメントの新しいテキストを保存します。 |
quote_regeneration | いくつかのセグメントを再生成する費用。 |
regenerate_segments | 保存したテキストでセグメントを再生成します。クレジットを使います。 |
finish_dub | 編集を終えてダウンロードを開きます。 |
get_download_links | 吹き替えのファイルへのリンクで、5 分間有効です。 |
get_subtitles | 字幕をテキストで返します(SRT または WebVTT)。 |
delete_project | プロジェクトを、そのファイルと吹き替えごと削除します。 |
ファイルを送る
アシスタントはパソコン上のファイルを読み、パートに分けて送ります。そのため、ターミナルやファイルへのアクセスがある、ファイルのある場所で動いている必要があります。ファイルを part_size バイトずつのパートに分け、それぞれを PUT でそのアドレスに送ります。
ファイルにアクセスできないアシスタントでも、アプリで送ったプロジェクトなら作業できます。セグメントを読み、修正し、再生成し、ダウンロードできます。
クレジットと安全
- アシスタントはあなたのクレジットを使います。吹き替えは動画 1 秒ごとに 1 クレジット(最低 30)、再生成はそのセグメントの秒数(最低 15)です。サーバーはどちらの前にも費用を伝えてあなたの同意を待つよう指示していますが、あなたのキーで行われたすべての呼び出しはあなたの責任です。
- 吹き替えの完了とプロジェクトの削除は元に戻せません。アシスタントには、先にあなたに確認するよう指示しています。
- どのファイルにもアプリと同じルールが適用されます。あなた自身の声か、話している人から書面で許可を得た声だけを送ってください。キーの音声確認がそれぞれのファイルに適用されます。
- その呼び出しは API の上限に含まれます。アカウント全体で 1 分に 120 回、1 時間に 3,600 回です。
- アシスタントが見られるのは API が示す内容だけです:プロジェクト、吹き替え、セグメント、クレジット。キーが漏れたら、アカウント、API で無効化してください。