> ## 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.

# Vercel

> デプロイ、ドメイン、環境変数、Edge Config、チーム設定をVercelプロジェクト横断で管理

# Vercel

Shanoneのvercel連携は、プロジェクト、デプロイ、ドメイン/DNS、環境変数、Edge Config、キャッシュ、チーム/セキュリティ管理まで、デプロイライフサイクル全体をカバーする107個のツールをエージェントに提供します。

## はじめに

<Steps>
  <Step title="OAuthで接続する">
    エージェントにVercel関連の作業を依頼(例: 「Vercelのプロジェクト一覧を見せて」)するか、Shanoneダッシュボードの**連携**から事前に接続しておきます。
  </Step>

  <Step title="Sign in with Vercelで許可する">
    Shanoneに操作させたいチーム/アカウントについて、VercelのOAuth同意画面を承認します。
  </Step>

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

## 利用可能なツール

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

<AccordionGroup>
  <Accordion title="プロジェクト">
    `vercel_list_projects`, `vercel_get_project`, `vercel_create_project`, `vercel_delete_project`, `vercel_update_project`, `vercel_pause_project`, `vercel_unpause_project`, `vercel_list_project_domains`, `vercel_add_project_domain`
  </Accordion>

  <Accordion title="デプロイ">
    `vercel_list_deployments`, `vercel_get_deployment`, `vercel_cancel_deployment`, `vercel_redeploy`, `vercel_get_deployment_events`, `vercel_get_deployment_logs`, `vercel_promote_deployment`, `vercel_list_deployment_files`, `vercel_get_deployment_file_contents`, `vercel_create_deployment`, `vercel_delete_deployment`, `vercel_get_deployments_extended`, `vercel_get_promote_aliases`
  </Accordion>

  <Accordion title="Edge Config">
    `vercel_list_edge_configs`, `vercel_get_edge_config`, `vercel_create_edge_config`, `vercel_delete_edge_config`, `vercel_get_edge_config_items`, `vercel_update_edge_config_items`, `vercel_create_edge_config_token`, `vercel_list_edge_config_tokens`, `vercel_get_edge_config_token`, `vercel_delete_edge_config_tokens`, `vercel_get_edge_config_item`, `vercel_list_edge_config_backups`, `vercel_get_edge_config_schema`, `vercel_update_edge_config_schema`
  </Accordion>

  <Accordion title="ドメイン購入">
    `vercel_check_domain_availability`, `vercel_get_bulk_domain_availability`, `vercel_buy_domain`, `vercel_buy_domains`, `vercel_list_supported_tlds`, `vercel_get_tld_info`, `vercel_get_tld_price`, `vercel_get_domain_price`
  </Accordion>

  <Accordion title="キャッシュアーティファクト">
    `vercel_check_cache_artifact_exists`, `vercel_get_cache_status`, `vercel_get_artifact_info`, `vercel_delete_all_cache_artifacts`, `vercel_record_cache_event`, `vercel_invalidate_cache_by_tags`, `vercel_delete_cache_by_tags`, `vercel_invalidate_cache_by_image`
  </Accordion>

  <Accordion title="環境変数">
    `vercel_list_env_vars`, `vercel_create_env_var`, `vercel_delete_env_var`, `vercel_update_env_var`, `vercel_list_shared_env_vars`, `vercel_create_shared_env_var`, `vercel_delete_shared_env_var`
  </Accordion>

  <Accordion title="ローリングリリース">
    `vercel_get_rolling_release`, `vercel_get_rolling_release_config`, `vercel_update_rolling_release_config`, `vercel_start_rolling_release`, `vercel_complete_rolling_release`, `vercel_abort_rolling_release`, `vercel_approve_rolling_release_stage`
  </Accordion>

  <Accordion title="認証トークン">
    `vercel_create_auth_token`, `vercel_get_auth_token`, `vercel_delete_auth_token`, `vercel_list_auth_tokens`, `vercel_get_authenticated_user`
  </Accordion>

  <Accordion title="DNSレコード">
    `vercel_list_dns_records`, `vercel_create_dns_record`, `vercel_update_dns_record`, `vercel_delete_dns_record`
  </Accordion>

  <Accordion title="ドメイン">
    `vercel_list_domains`, `vercel_get_domain`, `vercel_add_domain`, `vercel_remove_domain`
  </Accordion>

  <Accordion title="ログドレイン">
    `vercel_list_log_drains`, `vercel_get_log_drain`, `vercel_create_log_drain`, `vercel_delete_log_drain`, `vercel_list_integration_log_drains`
  </Accordion>

  <Accordion title="チームメンバー">
    `vercel_list_team_members`, `vercel_list_project_members`, `vercel_get_team`, `vercel_update_team`
  </Accordion>

  <Accordion title="セキュリティ & ファイアウォール">
    `vercel_get_attack_status`, `vercel_update_attack_mode`, `vercel_get_firewall_config`, `vercel_list_firewall_events`
  </Accordion>

  <Accordion title="Webhook">
    `vercel_list_webhooks`, `vercel_get_webhook`, `vercel_create_webhook`, `vercel_delete_webhook`
  </Accordion>

  <Accordion title="ログ & チェック">
    `vercel_list_deployment_checks`, `vercel_get_deployment_build_logs`, `vercel_get_runtime_logs`
  </Accordion>

  <Accordion title="エイリアス">
    `vercel_list_aliases`, `vercel_list_deployment_aliases`, `vercel_assign_alias`, `vercel_delete_alias`
  </Accordion>

  <Accordion title="ユーザー & Git連携">
    `vercel_get_user`, `vercel_list_teams`, `vercel_list_git_namespaces`, `vercel_search_git_repositories`
  </Accordion>
</AccordionGroup>

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

<CardGroup cols={2}>
  <Card title="デプロイのトリアージ" icon="rocket">
    最近のデプロイを一覧し、ビルド/実行ログを取得して失敗したビルドを調査する
  </Card>

  <Card title="新規プロジェクトの環境構築" icon="settings-2">
    プロジェクトを作成し、環境変数を設定してカスタムドメインを追加する
  </Card>

  <Card title="段階的なロールアウト" icon="git-branch">
    ローリングリリースを開始し、各ステージを監視して指標に基づき承認または中止する
  </Card>

  <Card title="ドメイン・DNS管理" icon="globe">
    ドメインの空き状況を確認・購入し、プロジェクトのDNSレコードを設定する
  </Card>
</CardGroup>

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

<AccordionGroup>
  <Accordion title="vercel_create_projectやvercel_add_domainが権限エラーで失敗する">
    プロジェクト/ドメイン/チーム系ツールの多くは、接続中のVercelアカウントが所属するチームに対して操作します。権限バグと決めつける前に、`vercel_list_teams`と`vercel_get_team`で正しいチームコンテキストを確認してください。
  </Accordion>

  <Accordion title="vercel_redeployやvercel_promote_deploymentの効果が反映されない">
    どちらも暗黙的に「最新の」デプロイを対象にするのではなく、特定のデプロイIDに対して操作します — まず`vercel_list_deployments`を呼び出し、意図したデプロイを対象にしているか確認してください。
  </Accordion>

  <Accordion title="Edge Configやキャッシュの変更がすぐに反映されない">
    Edge Configの読み取りは高速だが結果整合性のあるエッジキャッシュから提供されます。`vercel_update_edge_config_items`の変更が`vercel_get_edge_config_items`にグローバルに反映されるまで、短い伝播時間がかかることがあります。
  </Accordion>

  <Accordion title="OAuth接続が予期せず期限切れになる">
    VercelのOAuthトークンは有効期間が短めです。認証エラーで呼び出しが失敗した場合は、トークンが永続的だと考えるのではなく**連携**画面から再接続してください。
  </Accordion>
</AccordionGroup>