vercel-automation

Rube MCP による Vercel の自動化

Rube MCP 経由で Composio の Vercel ツールキットを使用して、Vercel プラットフォームの操作を自動化します。

前提条件

• Rube MCP に接続済みであること（RUBE_SEARCH_TOOLS が利用可能）
• ツールキット vercel を指定して RUBE_MANAGE_CONNECTIONS からアクティブな Vercel 接続を確立していること
• 現在のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

Rube MCP の取得：クライアント設定で https://rube.app/mcp を MCP サーバーとして追加します。エンドポイントを追加しても Vercel の認証は行われません。ホストがサポートする認証済み接続を使用してください。

1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCP が利用可能であることを確かめます
2. ツールキット vercel を指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクに従って Vercel OAuth を完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

主なワークフロー

変更を行う前に、対象のチーム、プロジェクト、環境、および変更不可能なソースリビジョンを特定してください。デプロイの作成はコードを公開し、費用が発生する可能性があります。本番環境への昇格、DNS の変更、シークレットの更新には、ユーザーから明確に範囲を指定した依頼が必要です。既存の DNS レコードを確認し、メール関連および検証用のエントリは保持してください。環境変数を一覧表示する際に、シークレット値を出力しないでください。現在の機密性／暗号化タイプとブランチのスコープを尊重してください。タイムアウトが発生してもデプロイが作成済みの場合があります。再試行の前に状態を確認してください。回数を制限してポーリングし、公開 URL／エイリアスを確認したうえで、認証情報や個人データを伏せてログを報告してください。

1. デプロイの監視と確認

使用する場面：ユーザーがデプロイの一覧表示、確認、またはデバッグを希望する場合

ツールの実行順序：

1. VERCEL_LIST_ALL_DEPLOYMENTS または VERCEL_GET_DEPLOYMENTS - フィルターを指定してデプロイを一覧表示します［必須］
2. VERCEL_GET_DEPLOYMENT または VERCEL_GET_DEPLOYMENT_DETAILS - 特定のデプロイ情報を取得します［任意］
3. VERCEL_GET_DEPLOYMENT_LOGS または VERCEL_GET_RUNTIME_LOGS - ビルド／ランタイムログを表示します［任意］
4. VERCEL_GET_DEPLOYMENT_EVENTS - デプロイのイベントタイムラインを取得します［任意］
5. VERCEL_LIST_DEPLOYMENT_CHECKS - デプロイチェックの結果を表示します［任意］

主なパラメーター：

• projectId：プロジェクトでデプロイをフィルターします
• state：デプロイの状態でフィルターします（例：'READY'、'ERROR'、'BUILDING'）
• limit：返すデプロイの数
• target：環境でフィルターします（'production'、'preview'）
• deploymentId または idOrUrl：特定のデプロイ識別子

注意点：

• ほとんどのエンドポイントでは、デプロイ ID と URL のどちらも識別子として使用できます
• ビルドログとランタイムログは別々です。適切なツールを使用してください
• VERCEL_GET_DEPLOYMENT_LOGS はビルドログを返し、VERCEL_GET_RUNTIME_LOGS はサーバーレス関数のログを返します
• デプロイイベントにはステータスの遷移が含まれており、タイミングの問題のデバッグに役立ちます

2. デプロイの作成と管理

使用する場面：ユーザーが新しいデプロイの実行を希望する場合

ツールの実行順序：

1. VERCEL_LIST_PROJECTS - 対象のプロジェクトを検索します［前提条件］
2. VERCEL_CREATE_NEW_DEPLOYMENT - 新しいデプロイを実行します［必須］
3. VERCEL_GET_DEPLOYMENT - デプロイの進行状況を監視します［任意］

主なパラメーター：

• name：デプロイ対象のプロジェクト名
• target：デプロイ先（'production' または 'preview'）
• gitSource：ref／ブランチ情報を含む Git リポジトリのソース
• files：ファイルベースのデプロイに使用するファイルオブジェクトの配列

注意点：

• gitSource と files のどちらか一方を指定する必要があります。両方は指定できません
• Git ベースのデプロイには、適切なリポジトリ連携が必要です
• 本番デプロイでは、本番ドメインのエイリアスが自動的に更新されます
• デプロイの作成は非同期です。GET_DEPLOYMENT でポーリングしてステータスを確認してください

3. 環境変数を管理する

使用する場面：プロジェクトの環境変数を追加、一覧表示、または削除したい場合

ツールの手順：

1. VERCEL_LIST_PROJECTS - プロジェクト ID を確認します［前提条件］
2. VERCEL_LIST_ENV_VARIABLES - 既存の環境変数を一覧表示します［必須］
3. VERCEL_ADD_ENVIRONMENT_VARIABLE - 新しい環境変数を追加します［任意］
4. VERCEL_DELETE_ENVIRONMENT_VARIABLE - 環境変数を削除します［任意］

主なパラメーター：

• projectId：対象プロジェクトの識別子
• key：環境変数名
• value：環境変数の値
• target：環境の配列（'production'、'preview'、'development'）
• type：変数の種類（'plain'、'secret'、'encrypted'、'sensitive'）

注意点：

• 環境変数名は、対象の環境ごとに一意である必要があります
• type: 'secret' の変数は作成後に読み取れません。返されるのは ID のみです
• 環境変数の削除には、projectId と環境変数の id（キー名ではありません）の両方が必要です
• 変更を反映するには、新しいデプロイが必要です

4. ドメインと DNS を管理する

使用する場面：カスタムドメインを設定する、または DNS レコードを管理したい場合

ツールの手順：

1. VERCEL_GET_DOMAIN - ドメインのステータスと設定を確認します［必須］
2. VERCEL_GET_DOMAIN_CONFIG - DNS／SSL 設定の詳細を取得します［任意］
3. VERCEL_LIST_PROJECT_DOMAINS - プロジェクトに紐付けられたドメインを一覧表示します［任意］
4. VERCEL_GET_DNS_RECORDS - ドメインの DNS レコードを一覧表示します［任意］
5. VERCEL_CREATE_DNS_RECORD - 新しい DNS レコードを追加します［任意］
6. VERCEL_UPDATE_DNS_RECORD - 既存の DNS レコードを変更します［任意］

主なパラメーター：

• domain：ドメイン名（例：'example.com'）
• name：DNS レコード名／サブドメイン
• type：DNS レコードの種類（'A'、'AAAA'、'CNAME'、'MX'、'TXT'、'SRV'）
• value：DNS レコードの値
• ttl：秒単位の有効期間

注意点：

• DNS 管理を行う前に、ドメインを Vercel アカウントに追加する必要があります
• SSL 証明書は自動的にプロビジョニングされますが、新しいドメインでは発行に時間がかかる場合があります
• ドメイン／プロバイダーに対して返される DNS の推奨設定をそのまま使用してください。apex エイリアス／フラット化のサポート状況はプロバイダーによって異なります
• MX レコードには優先度の値が必要です

5. プロジェクトを管理する

使用する場面：プロジェクトを一覧表示、確認、または設定を更新したい場合

ツールの手順：

1. VERCEL_LIST_PROJECTS - すべてのプロジェクトを一覧表示します［必須］
2. VERCEL_GET_PROJECT - プロジェクトの詳細情報を取得します［任意］
3. VERCEL_UPDATE_PROJECT - プロジェクト設定を変更します［任意］

主なパラメーター：

• idOrName：検索に使用するプロジェクト ID または名前
• name：更新するプロジェクト名
• framework：フレームワークのプリセット（例：'nextjs'、'vite'、'remix'）
• buildCommand：カスタムビルドコマンドの上書き設定
• rootDirectory：リポジトリのルート以外をルートディレクトリにする場合に指定します

注意点：

• プロジェクト名は、チーム／アカウント内で一意である必要があります
• フレームワーク設定を変更すると、以降のデプロイに影響します
• rootDirectory はリポジトリのルートからの相対パスです

6. チームを管理する

使用する場面：チーム情報を確認する、またはチームメンバーを一覧表示したい場合

ツールの手順：

1. VERCEL_LIST_TEAMS - ユーザーが所属するすべてのチームを一覧表示します［必須］
2. VERCEL_GET_TEAM - チームの詳細情報を取得します［任意］
3. VERCEL_GET_TEAM_MEMBERS - 特定のチームのメンバーを一覧表示します［任意］

主なパラメーター：

• teamId：チームの識別子
• limit：1 ページあたりの結果数
• role：ロールでメンバーを絞り込みます

注意点：

• チーム操作には、適切なチームレベルの権限が必要です
• 個人アカウントにはチームがないため、チームのエンドポイントは空の結果を返します
• メンバーのロールには、'OWNER'、'MEMBER'、'DEVELOPER'、'VIEWER' があります

よく使うパターン

ID の解決

プロジェクト名 -> プロジェクト ID：

1. Call VERCEL_LIST_PROJECTS
2. Find project by name in response
3. Extract id field for subsequent operations

ドメイン -> DNS レコード：

1. Call VERCEL_GET_DNS_RECORDS with domain name
2. Extract record IDs for update/delete operations

ページネーション

• limit パラメーターを使用してページサイズを設定します
• レスポンスにページネーショントークンまたは next フィールドがあるか確認します
• それ以上ページがないことが示されるまで取得を続けます

既知の落とし穴

デプロイ状態：

• 状態には、INITIALIZING、ANALYZING、BUILDING、DEPLOYING、READY、ERROR、CANCELED、QUEUED があります。
• READY はビルド／デプロイの準備が整っていることを示すもので、正しいルーティングやアプリケーションの正常性を示すものではありません。正確な URL と本番エイリアスを確認してください。
• ERROR のデプロイについては、失敗の詳細をログで確認してください。

環境変数：

• シークレット型の変数は書き込み専用です。作成後に値を取得することはできません。
• 環境変数は環境（production、preview、development）ごとにスコープが設定されます。
• 環境変数の変更を反映するには、再デプロイが必要です。

レート制限：

• Vercel API にはエンドポイントごとにレート制限があります。
• 429 レスポンスを受け取った場合は、バックオフを実装してください。
• API 呼び出しを減らすため、可能な場合は操作をまとめて実行してください。

クイックリファレンス

タスク	ツールスラッグ	主なパラメーター
プロジェクトの一覧表示	VERCEL_LIST_PROJECTS	limit
プロジェクトの詳細取得	VERCEL_GET_PROJECT	idOrName
プロジェクトの更新	VERCEL_UPDATE_PROJECT	idOrName, name, framework
デプロイの一覧表示	VERCEL_LIST_ALL_DEPLOYMENTS	projectId, state, limit
デプロイの取得	VERCEL_GET_DEPLOYMENT	idOrUrl
デプロイの作成	VERCEL_CREATE_NEW_DEPLOYMENT	name, target, gitSource
デプロイログ	VERCEL_GET_DEPLOYMENT_LOGS	deploymentId
ランタイムログ	VERCEL_GET_RUNTIME_LOGS	deploymentId
環境変数の一覧表示	VERCEL_LIST_ENV_VARIABLES	projectId
環境変数の追加	VERCEL_ADD_ENVIRONMENT_VARIABLE	projectId, key, value, target
環境変数の削除	VERCEL_DELETE_ENVIRONMENT_VARIABLE	projectId, id
ドメインの取得	VERCEL_GET_DOMAIN	domain
ドメイン設定の取得	VERCEL_GET_DOMAIN_CONFIG	domain
DNS レコードの一覧表示	VERCEL_GET_DNS_RECORDS	domain
DNS レコードの作成	VERCEL_CREATE_DNS_RECORD	domain, name, type, value
DNS レコードの更新	VERCEL_UPDATE_DNS_RECORD	domain, recordId
プロジェクトドメインの一覧表示	VERCEL_LIST_PROJECT_DOMAINS	projectId
チームの一覧表示	VERCEL_LIST_TEAMS	(none)
チームの取得	VERCEL_GET_TEAM	teamId
チームメンバーの取得	VERCEL_GET_TEAM_MEMBERS	teamId, limit

使用する場面

このスキルは、概要で説明されているワークフローまたはアクションを実行する場合に適用できます。

制限事項

• このスキルは、タスクが上記の説明範囲に明確に当てはまる場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中断して確認を求めてください。