本文へスキップ

MCP とエージェント

AI アシスタントで画像と動画を生成

公式 MCP サーバーを使うと、Claude、Cursor、Codex、VS Code などのアシスタントが、最新のモデルカタログ、正確な見積もり、タスクの作成を使えるようになります。ふだんの言葉で頼むだけ。課金の前には、あなたの確認を待ちます。

API キーを作成ドキュメントで詳しく見る

MCP サーバーとは？

MCP（Model Context Protocol）は、AI アシスタントに新しいツールを持たせるための標準的な仕組みです。SpicyAPI のサーバーを追加すると、アシスタントがモデルを探し、料金を確かめ、画像や動画を作ってくれます。

  1. あなたとアシスタントClaude、Cursor、Codex、VS Code など
  2. SpicyAPI MCP サーバーnpx であなたのパソコン上で動作
  3. 画像・動画モデル最新のカタログと正確な料金
どのツールを呼ぶかはアシスタントが判断します。お金がかかる操作は、あなたの了承を待って止まります。

こんなときに

  • コーディング中に素材を用意エディタを離れずに、ヒーロー画像や商品の短い動画を頼めます。
  • モデルを調べる用途に合うモデルと、その料金を聞けます。
  • バッチ処理をエージェントに任せる複数タスクの作成、完了待ち、結果の取得をエージェントに任せられます。

頼んだときの流れ

  1. ステップ 1最新のカタログから合うモデルを探し、受け付ける入力を読み取る
  2. ステップ 2ローカルのファイルがあれば、アップロードする
  3. ステップ 3米ドルで正確な見積もりを出し、課金の前にあなたへ確認する
  4. ステップ 4タスクを開始し、完了を待って、結果のリンクを渡す
セッション例

  1. あなた: beach.jpg を、夕暮れの波の 6 秒クリップにして。

  2. spicyapi_models_listspicyapi_model_get
    アシスタント: 開始画像を受け付ける動画モデルが見つかりました
  3. spicyapi_upload_file
    beach.jpg をアップロードしました
  4. spicyapi_task_quote

    米ドルでの正確な料金です。タスクを作成しますか？

  5. spicyapi_task_createspicyapi_task_wait
    完了しました。ダウンロードリンクはこちらです。
よくあるセッションのイメージです。承認するまで課金されません。

アシスタントに追加する

どのクライアントも、npx 経由で同じローカルサーバーを起動します。お使いのクライアントを選ぶと、そのまま使えるコマンドや設定ブロックが表示されます。

{
  "mcpServers": {
    "spicyapi": {
      "command": "npx",
      "args": ["--yes", "--package=@spicyapi/mcp", "spicyapi-mcp"],
      "env": { "SPICY_API_KEY": "YOUR_SERVER_SIDE_KEY" }
    }
  }
}

すべての MCP クライアントで同じ stdio サーバー。各クライアント自身の設定ファイルに貼り付けます。

サードパーティ製クライアントの設定形式は、バージョンによって変わることがあります。ここに載せたスニペットが合わなくなったときは、クライアント自身のドキュメントを優先してください。

Claude をお使いですか？ Claude から画像と動画を生成 →

提供されるツール

読み取り専用のツールは無料です。お金がかかる 2 つのツールと、コンテンツを削除する 1 つのツールは、必ず先に確認します。

無料無料・読み取り専用12

  • spicyapi_service_status公開ヘルスチェック（キー不要）
  • spicyapi_docs_search同梱のドキュメントを検索する
  • spicyapi_models_list利用可能なモデルとあなたの料金
  • spicyapi_model_getモデル 1 件とその入力スキーマ
  • spicyapi_balance_get利用可能残高、仮押さえ額、合計残高
  • spicyapi_usage_get現在のキーの利用額
  • spicyapi_tasks_list現在のキーの最近のタスク
  • spicyapi_task_getタスク 1 件と、取得できる結果リンク
  • spicyapi_task_waitタスクの完了を最大 5 分待つ
  • spicyapi_task_quote作成せずに、指定リクエストの料金を見積もる
  • spicyapi_upload_file入力に使うローカルファイルをアップロードする
  • spicyapi_download_url_create結果の新しいダウンロードリンク

課金の前に確認します実行前に確認3

  • spicyapi_task_create生成タスクを開始する
  • spicyapi_task_retry失敗または期限切れのタスクを再実行する
  • spicyapi_task_purge完了したタスクのコンテンツを完全に削除する
パッケージを開くソースを見る

呼び出し手順は Agent Skill で教える

MCP サーバーはエージェントに「できること」を与え、Agent Skill は「使い方」を教えます。スキーマを読む、見積もりを確認する、試行ごとに同じ冪等キーを使い回す、といった手順です。Claude Code と Codex は両方に対応しています。

パッケージを開くソースを見る
npx skills add spicyapi-ai/spicy-skill \
  --agent claude-code

エージェントが読めるファイル

アシスタントや統合ツールが製品説明、モデルカタログ、正規ドキュメントを見つけるための入口です。

agent.md

簡潔なエージェント統合契約と安全境界です。

/agent.md →

llms.txt

AI 検索向けのサイト・モデル索引です。

/llms.txt →

llms-full.txt

製品、ワークフロー、エンドポイント、探索情報の拡張版です。

/llms-full.txt →

エージェントマニフェスト

ツールと自律クライアント向けの構造化 JSON 探索情報です。

/api/agent →

よくあるエラーの直し方

最初のつまずきは、たいていこの 3 つのどれかです。カードには、表示される内容と直すポイントを 1 つずつ載せています。

  • ツール

    ツールが表示されません

    設定ファイルを編集したらアシスタントを再起動し、JSON の書き方が正しいか確認してください。

  • キー

    API キーがありません

    サーバー設定の env ブロックに SPICY_API_KEY を書いてください。デスクトップアプリは、シェルで export したキーを読み取れません。

  • 確認

    タスクを作成できません

    お使いのクライアントは確認の画面を表示できません。無料のツールは使えます。タスクを作成するには、MCP elicitation に対応したクライアントを使ってください。

よくある質問