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

# Vercel

> プロジェクト一覧、デプロイ検査、実行時ログのトリアージ、ドメイン監査のためにVercelをCloudThinkerに接続します

Vercelアカウントを接続して、CloudThinkerエージェントがプロジェクトの一覧表示、デプロイとビルドイベントの検査、実行時ログの取得、ドメインとエイリアスの監査を実行できるようにします。また、スタックしたデプロイのキャンセルやプロジェクトの一時停止など、承認が必要な制御操作も行えます。

Vercelの認証は、CloudThinkerが公式Vercel MCPサーバー（`@vercel/sdk`）に渡す**アクセストークン**で行います。トークンの**スコープ**（個人アカウントまたは特定のチーム）がエージェントのアクセス範囲を決定します。OAuthフローは不要です。

***

## 前提条件

* 調査したいチームとプロジェクトにアクセスできる**Vercelアカウント**。
* 適切なチームにスコープされた**アクセストークン**。
* そのスコープのトークンを作成する権限。

<Info>
  CloudThinkerが必要とするチームのみにトークンをスコープしてください。接続の読み取り操作はVercelリソースを変更しません。変更するのは3つの承認ゲートの制御操作のみです。
</Info>

***

## セットアップ

<Steps>
  <Step title="アクセストークンを作成">
    Vercelで **Settings → Tokens → Create Token** に移動します：

    * **名前**：`cloudthinker`
    * **スコープ**：CloudThinkerがアクセスすべき**チーム**（または個人アカウント）を選択
    * **有効期限**：有効期間を選択してローテーション計画を立てる

    トークンをすぐにコピーしてください — Vercelは一度しか表示しません。
  </Step>

  <Step title="CloudThinkerに接続を追加">
    **Connections → Vercel** に移動して次を入力します：

    * **Token**：作成したアクセストークン

    **Connect** をクリックします。CloudThinkerがVercel MCPサーバーを起動し、**Connected** ステータスに変わります。
  </Step>
</Steps>

<Warning>
  アクセストークンは作成直後にコピーしてください。紛失した場合は新しいトークンを作成する必要があります。
</Warning>

***

## 接続詳細

| フィールド             | 説明                                   | 例 |
| ----------------- | ------------------------------------ | - |
| **VERCEL\_TOKEN** | MCPのBearerトークンとして使用されるVercelアクセストークン | — |

<Note>
  CloudThinkerはトークンのスコープからチームとプロジェクトを解決するため、チームIDやURLの手動設定は不要です。
</Note>

***

## 必要な権限

CloudThinkerがアクセスすべきプロジェクト、デプロイ、ドメイン、ログを持つ**チーム**にトークンをスコープしてください。読み取り操作はそれらのリソースを参照できるトークンであれば機能します。3つの制御操作にはさらに、それを許可するトークンスコープとCloudThinkerでの明示的な[承認](/ja/guide/approval)の両方が必要です。

<Tip>
  最小権限を守ってください。トークンを単一のチームにスコープして有効期限を設定してください。ガードレールを外すのではなく、制御操作は承認ゲートのままにしておいてください。
</Tip>

***

## エージェントの機能

接続後、エージェントはVercelのプロジェクトとデプロイへの読み取りアクセスを持ちます。

| 機能             | 説明                                    |
| -------------- | ------------------------------------- |
| **チームとプロジェクト** | チームとプロジェクトの一覧表示、プロジェクトドメインの検査         |
| **デプロイ**       | デプロイ、デプロイイベント、ビルド出力の一覧表示と検査           |
| **実行時ログ**      | エラートリアージのための実行時ログの取得                  |
| **ドメインとエイリアス** | ドメイン、ドメイン設定、エイリアスの監査                  |
| **アカウント**      | 認証済みVercelユーザーを読み取り                   |
| **デプロイ制御**     | デプロイのキャンセル、プロジェクトの一時停止と再開 — **承認が必要** |

<Info>
  `Cancel deployment`、`Pause project`、`Unpause project` は承認ゲートされています。CloudThinkerは実行前に確認を求めます。読み取り専用操作は承認なしで実行されます。
</Info>

### 接続を確認する

```text theme={null}
@alex check the Vercel connection and list accessible teams and projects
```

### プロンプト例

```text theme={null}
@alex list all projects across my Vercel teams with their framework and latest deployment status and #report as a table
@alex the latest production deployment failed — pull the build events, find the error, and #recommend a fix
@alex show runtime error logs for my Vercel project over the last 6 hours and #alert on 5xx spikes
```

<Note>
  プロジェクトが多数あるアカウントの場合は、エージェントが絞り込んだ結果を返せるよう、単一のチームまたはプロジェクトにリクエストをスコープしてください。
</Note>

***

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

<Accordion title="401または403 Unauthorized">
  トークンが存在しない、期限切れ、または失効しています。新しいVercelトークンを作成して接続を再設定してください。
</Accordion>

<Accordion title="エージェントが期待するチームやプロジェクトを参照できない">
  トークンのスコープにそれらのチームが含まれていません。正しいチームにスコープした新しいトークンを作成して再接続してください。
</Accordion>

<Accordion title="CloudThinkerがVercelはすでに接続済みと言う">
  ワークスペースごとに許可されるVercel接続は1つのみです。既存の接続を使用するか、再接続する前に削除してください。
</Accordion>

<Accordion title="制御アクションが実行されなかった">
  キャンセル・一時停止・再開には、アクションを許可するトークンスコープとCloudThinkerでの明示的な承認の両方が必要です。プロンプトが表示されたらアクションを承認し、トークンのスコープがそれを許可していることを確認してください。
</Accordion>

***

## セキュリティ

* **最小権限** — エージェントがユースケースに必要な権限のみを付与します。まず読み取り専用から始め、後から拡張してください。
* **デフォルトで読み取り専用** — エージェントにこの接続で変更を行わせる場合を除き、読み取り専用の認証情報を使用してください。
* **認証情報のローテーション** — 通常のスケジュールに従ってキーとトークンをローテーションしてください。接続を更新すると、CloudThinker が新しい値を自動的に取得します。
* **オフボーディング時に失効** — 接続を削除するか、チームメンバーが退職する際には、プロバイダー側で認証情報を無効化してください。

- **トークンの有効期限を設定** — トークン作成時に有効期限を選択してローテーション計画を立ててください。Vercelトークンは自動ローテーションされません。
- **制御操作の承認** — キャンセル・一時停止・再開のアクションは、ガードレールを外すのではなく承認ゲートのままにしておいてください。

***

## 関連

<CardGroup cols={2}>
  <Card title="MCP接続" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/mcp.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=c89b6087a9d233901dea5e354452eff6" href="/ja/guide/connections/mcp" width="24" height="24" data-path="images/icons/mcp.svg">
    MCPでカスタムツールとサービスを接続
  </Card>

  <Card title="承認" icon="shield-check" href="/ja/guide/approval">
    承認ゲートアクションの仕組み
  </Card>
</CardGroup>