メインコンテンツへスキップ
Vercelアカウントを接続して、CloudThinkerエージェントがプロジェクトの一覧表示、デプロイとビルドイベントの検査、実行時ログの取得、ドメインとエイリアスの監査を実行できるようにします。また、スタックしたデプロイのキャンセルやプロジェクトの一時停止など、承認が必要な制御操作も行えます。 Vercelの認証は、CloudThinkerが公式Vercel MCPサーバー（@vercel/sdk）に渡すアクセストークンで行います。トークンのスコープ（個人アカウントまたは特定のチーム）がエージェントのアクセス範囲を決定します。OAuthフローは不要です。

​
前提条件

  • 調査したいチームとプロジェクトにアクセスできるVercelアカウント。
  • 適切なチームにスコープされたアクセストークン。
  • そのスコープのトークンを作成する権限。
CloudThinkerが必要とするチームのみにトークンをスコープしてください。接続の読み取り操作はVercelリソースを変更しません。変更するのは3つの承認ゲートの制御操作のみです。

​
セットアップ

1

アクセストークンを作成

Vercelで Settings → Tokens → Create Token に移動します：
  • 名前：cloudthinker
  • スコープ：CloudThinkerがアクセスすべきチーム（または個人アカウント）を選択
  • 有効期限：有効期間を選択してローテーション計画を立てる
トークンをすぐにコピーしてください — Vercelは一度しか表示しません。
2

CloudThinkerに接続を追加

Connections → Vercel に移動して次を入力します：
  • Token：作成したアクセストークン
Connect をクリックします。CloudThinkerがVercel MCPサーバーを起動し、Connected ステータスに変わります。
アクセストークンは作成直後にコピーしてください。紛失した場合は新しいトークンを作成する必要があります。

​
接続詳細

フィールド説明例
VERCEL_TOKENMCPのBearerトークンとして使用されるVercelアクセストークン—
CloudThinkerはトークンのスコープからチームとプロジェクトを解決するため、チームIDやURLの手動設定は不要です。

​
必要な権限

CloudThinkerがアクセスすべきプロジェクト、デプロイ、ドメイン、ログを持つチームにトークンをスコープしてください。読み取り操作はそれらのリソースを参照できるトークンであれば機能します。3つの制御操作にはさらに、それを許可するトークンスコープとCloudThinkerでの明示的な承認の両方が必要です。
最小権限を守ってください。トークンを単一のチームにスコープして有効期限を設定してください。ガードレールを外すのではなく、制御操作は承認ゲートのままにしておいてください。

​
エージェントの機能

接続後、エージェントはVercelのプロジェクトとデプロイへの読み取りアクセスを持ちます。
機能説明
チームとプロジェクトチームとプロジェクトの一覧表示、プロジェクトドメインの検査
デプロイデプロイ、デプロイイベント、ビルド出力の一覧表示と検査
実行時ログエラートリアージのための実行時ログの取得
ドメインとエイリアスドメイン、ドメイン設定、エイリアスの監査
アカウント認証済みVercelユーザーを読み取り
デプロイ制御デプロイのキャンセル、プロジェクトの一時停止と再開 — 承認が必要
Cancel deployment、Pause project、Unpause project は承認ゲートされています。CloudThinkerは実行前に確認を求めます。読み取り専用操作は承認なしで実行されます。

​
接続を確認する

@alex check the Vercel connection and list accessible teams and projects

​
プロンプト例

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

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

トークンが存在しない、期限切れ、または失効しています。新しいVercelトークンを作成して接続を再設定してください。
トークンのスコープにそれらのチームが含まれていません。正しいチームにスコープした新しいトークンを作成して再接続してください。
ワークスペースごとに許可されるVercel接続は1つのみです。既存の接続を使用するか、再接続する前に削除してください。
キャンセル・一時停止・再開には、アクションを許可するトークンスコープとCloudThinkerでの明示的な承認の両方が必要です。プロンプトが表示されたらアクションを承認し、トークンのスコープがそれを許可していることを確認してください。

​
セキュリティ

  • 最小権限 — エージェントがユースケースに必要な権限のみを付与します。まず読み取り専用から始め、後から拡張してください。
  • デフォルトで読み取り専用 — エージェントにこの接続で変更を行わせる場合を除き、読み取り専用の認証情報を使用してください。
  • 認証情報のローテーション — 通常のスケジュールに従ってキーとトークンをローテーションしてください。接続を更新すると、CloudThinker が新しい値を自動的に取得します。
  • オフボーディング時に失効 — 接続を削除するか、チームメンバーが退職する際には、プロバイダー側で認証情報を無効化してください。
  • トークンの有効期限を設定 — トークン作成時に有効期限を選択してローテーション計画を立ててください。Vercelトークンは自動ローテーションされません。
  • 制御操作の承認 — キャンセル・一時停止・再開のアクションは、ガードレールを外すのではなく承認ゲートのままにしておいてください。

​
関連

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

MCP接続

MCPでカスタムツールとサービスを接続

承認

承認ゲートアクションの仕組み