> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shanone.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# V0

> VercelのUI生成AI「v0」でUIコードを生成・反復 — チャット、プロジェクト、デプロイ、MCPサーバー管理

# V0

Shanoneのv0連携は、Vercelのv0 AI UIジェネレーターを操作するための42個のツールをエージェントに提供します。チャットの作成・反復、プロジェクト・デプロイの管理、MCPサーバーの設定に加え、v0の新しいv2チャット/メッセージAPIにも対応しています。

## はじめに

<Steps>
  <Step title="v0のAPIキーを作成する">
    [v0.dev/settings](https://v0.dev/settings)でキーを発行します。
  </Step>

  <Step title="APIキーで接続する">
    Shanoneダッシュボードの**連携 → V0**でキー(`v0_...`で始まる文字列)を貼り付けます。
  </Step>

  <Step title="リクエストを再実行する">
    接続が完了すると、`v0_*`ツールに対する`shanone_execute_tool`呼び出しが成功するようになります。
  </Step>
</Steps>

## 利用可能なツール

Shanoneはv0向けに**42個のツール**を、以下のカテゴリに整理して提供しています。

<AccordionGroup>
  <Accordion title="チャット (v1)">
    `v0_create_chat`, `v0_get_chat`, `v0_send_message`, `v0_get_chat_messages`, `v0_list_chats`, `v0_delete_chat`, `v0_update_chat`, `v0_favorite_chat`, `v0_fork_chat`, `v0_init_chat`, `v0_restore_chat_version`, `v0_list_chat_versions`, `v0_get_chat_version`, `v0_update_chat_version_files`, `v0_download_chat_version`, `v0_delete_chat_version_files`, `v0_resolve_chat_task`, `v0_stop_chat_message`
  </Accordion>

  <Accordion title="チャット (v2)">
    `v0_v2_list_chats`, `v0_v2_create_chat`, `v0_v2_create_chat_async`, `v0_v2_create_chat_from_files`, `v0_v2_create_chat_from_repo`, `v0_v2_create_chat_from_zip`, `v0_v2_get_chat`, `v0_v2_update_chat`, `v0_v2_delete_chat`, `v0_v2_duplicate_chat`, `v0_v2_get_chat_files`, `v0_v2_update_chat_files`, `v0_v2_download_chat_files`, `v0_v2_get_preview_url`, `v0_v2_deploy_chat`, `v0_v2_create_vercel_project`, `v0_v2_restore_message`, `v0_v2_get_connect_setup_status`
  </Accordion>

  <Accordion title="メッセージ (v2)">
    `v0_v2_list_messages`, `v0_v2_get_message`, `v0_v2_send_message`, `v0_v2_send_message_async`, `v0_v2_resolve_task`, `v0_v2_resolve_task_async`, `v0_v2_stop_message`
  </Accordion>

  <Accordion title="プロジェクト">
    `v0_list_projects`, `v0_get_project`, `v0_create_project`, `v0_update_project`, `v0_delete_project`, `v0_get_project_by_chat_id`, `v0_list_project_env_vars`, `v0_get_project_env_var`, `v0_create_project_env_vars`, `v0_update_project_env_vars`, `v0_delete_project_env_vars`
  </Accordion>

  <Accordion title="デプロイ">
    `v0_create_deployment`, `v0_get_deployment`, `v0_list_deployments`, `v0_delete_deployment`, `v0_find_deployment_logs`, `v0_find_deployment_errors`
  </Accordion>

  <Accordion title="MCPサーバー (v1 & v2)">
    `v0_list_mcp_servers`, `v0_get_mcp_server`, `v0_create_mcp_server`, `v0_update_mcp_server`, `v0_delete_mcp_server`, `v0_create_mcp_server_oauth_url`, `v0_v2_list_mcp_servers`, `v0_v2_get_mcp_server`, `v0_v2_create_mcp_server`, `v0_v2_update_mcp_server`, `v0_v2_delete_mcp_server`
  </Accordion>

  <Accordion title="Webhook & Hook">
    `v0_list_hooks`, `v0_get_hook`, `v0_create_hook`, `v0_update_hook`, `v0_delete_hook`, `v0_v2_list_webhooks`, `v0_v2_create_webhook`, `v0_v2_get_webhook`, `v0_v2_update_webhook`, `v0_v2_delete_webhook`
  </Accordion>

  <Accordion title="レポート、Vercel連携 & ユーザー">
    `v0_get_usage_report`, `v0_get_ai_usage_report`, `v0_get_user_activity_report`, `v0_find_vercel_projects`, `v0_create_vercel_project_link`, `v0_get_rate_limit`, `v0_get_user`, `v0_get_user_billing`, `v0_get_user_plan`, `v0_get_user_scopes`, `v0_v2_get_trusted_preview_hosts`, `v0_v2_set_trusted_preview_hosts`
  </Accordion>
</AccordionGroup>

## よくあるユースケース

<CardGroup cols={2}>
  <Card title="UIの高速プロトタイピング" icon="layout-panel-left">
    チャットでUIを説明し、生成されたコンポーネントコードをバージョンを重ねて反復する
  </Card>

  <Card title="モックアップからデプロイ済みページへ" icon="rocket">
    リポジトリやファイルからチャットを作成し、結果をそのままVercelにデプロイする
  </Card>

  <Card title="環境変数とプロジェクトのセットアップ" icon="settings">
    プロジェクトを作成し、環境変数を設定してVercelプロジェクトに連携する
  </Card>

  <Card title="使用量トラッキング" icon="gauge">
    使用量やAIクレジットのレポートを取得し、チャット横断で消費量を監視する
  </Card>
</CardGroup>

## トラブルシューティング

<AccordionGroup>
  <Accordion title="v1とv2のどちらのチャットツールを使うべきか分からない">
    `v0_v2_*`系はv0の新しいチャット/メッセージAPIで、より多くの作成オプション(ファイル・リポジトリ・zipから)と非同期版を備えています。新規連携では`v0_v2_*`系を優先し、v1の`v0_create_chat`/`v0_send_message`系は既存チャットの操作用に残されています。
  </Accordion>

  <Accordion title="v0_v2_deploy_chatやv0_v2_create_vercel_projectが失敗する">
    どちらも有効なVercelアカウント連携が必要です — まず`v0_find_vercel_projects`または`v0_create_vercel_project_link`を実行し、v0アカウントがVercelのチーム/プロジェクトに接続されているか確認してください。
  </Accordion>

  <Accordion title="非同期のメッセージ/タスクツールがいつまでも完了しない">
    `v0_v2_send_message_async`や`v0_v2_resolve_task_async`はタスク参照を即座に返す仕組みです。呼び出し自体が完了までブロックすることを期待せず、`v0_v2_get_message`やチャットのメッセージ一覧をポーリングしてください。
  </Accordion>
</AccordionGroup>