Claude Code に avacast の MCP をつなぎ、AIアバターの組み込みを任せる

Claude Code に avacast の MCP サーバー (https://api.avacast.jp/v1/mcp) を追加すると、Claude Code から avacast を操作できるようになります。アバターの一覧を確かめ、試しにセッションを作って話させ、そのうえで自分のアプリに組み込むコードを書かせる、という流れを 1 つの会話の中で進められます。

つなぐときは、ブラウザで管理画面のアカウントにログインして許可します (OAuth)。API キーを Claude Code に渡す必要はありません。

用意するもの

• avacast のアカウント (管理画面 https://app.avacast.jp で登録します。無料プランで始められます)
• Claude Code
• 組み込み先のアプリのリポジトリ

MCP サーバーを追加する

Claude Code には、MCP サーバーを追加するコマンドがあります。avacast の MCP は Streamable HTTP で動くため、HTTP の MCP サーバーとして URL を追加します。

claude mcp add --transport http avacast https://api.avacast.jp/v1/mcp

追加したあと、Claude Code から avacast の道具を初めて使うときにブラウザが開きます。管理画面のアカウントでログインし、許可するとつながります。コマンドの細かい書き方や設定の置き場所は、Claude Code の公式の説明に従ってください。

• MCP は OAuth でだけつなぎます。API キーをヘッダや引数で渡してもつながりません。
• できることは、管理画面での役割と同じです。組織のオーナーはすべての操作ができ、メンバーは見るだけです。
• 複数の組織に入っている場合は、list_organizations で組織の ID を確かめ、各道具の organization_id に渡します。

組み込みを任せる進め方

1. 最初に get_integration_guide を読ませる (API・SDK・料金・エラーの全文が返ります)
2. list_avatars で使えるアバターを確かめる
3. create_session で試しのセッションを作り、speak で話させる
4. 動きを確かめたら end_session で閉じる
5. 自分のアプリに、サーバーのセッション作成とブラウザの表示を組み込ませる

Claude Code への頼み方は、たとえば次のようになります。

avacast の get_integration_guide を読んでから、このリポジトリの Next.js アプリに
AIアバターを表示するページを足してください。
API キーはサーバーの環境変数 AVACAST_API_KEY から読み、ブラウザには client_token と webrtc だけを渡してください。
画面を離れたらセッションを閉じるようにしてください。

アプリから REST API を呼ぶための API キーは、create_api_key で発行できます。発行したキーはサーバーの環境変数に置き、リポジトリにはコミットしません。

試しに話させるときの注意

課金はセッションを開いていた時間です。MCP で試したセッションも同じように数えるため、確かめ終わったら end_session で閉じます。閉じ忘れても、無発話が既定の 180 秒続くか、プランの最大長に達すると自動的に閉じます。

create_session が返す client_token をブラウザの SDK に渡すと、映像を確かめられます。手順はHTML 1 枚で AIアバターを試すにまとめています。

プラグインとスキル

Claude Code 向けに、組み込みの手順をまとめたスキルとプラグインも用意しています。

• スキル: https://avacast.jp/skill/SKILL.md
• プラグインのマーケットプレイス: https://avacast.jp/plugin/marketplace.json

MCP の仕組みそのものはMCP とはで説明しています。ほかのエディタではCursorやCodexでも同じ MCP を使えます。

よくある質問

API キーを Claude Code に渡す必要はありますか。

ありません。MCP はブラウザで管理画面のアカウントにログインして許可するとつながります。アプリのサーバーから API を呼ぶ API キーが必要になったら、create_api_key で発行してサーバーの環境変数に置きます。

メンバーの役割でも組み込みを進められますか。

メンバーは見る操作だけができます。セッションの作成や API キーの発行には、組織のオーナーの役割が必要です。

MCP で作ったセッションにも料金はかかりますか。

かかります。課金は接続時間で、MCP から作ったセッションも同じように数えます。試し終わったら end_session で閉じてください。