vercel-automation

Rube MCP による Vercel の自動化

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

ツールキットのドキュメント：composio.dev/toolkits/vercel

前提条件

• Rube MCP が接続されていること（RUBE_SEARCH_TOOLS が利用可能）
• vercel ツールキットを指定した RUBE_MANAGE_CONNECTIONS による有効な Vercel 接続
• 必ず最初に RUBE_SEARCH_TOOLS を呼び出し、最新のツールスキーマを取得すること

セットアップ

Rube MCP を取得する：クライアント設定で https://rube.app/mcp を MCP サーバーとして追加します。API キーは不要です。エンドポイントを追加するだけで動作します。

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

主要なワークフロー

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 ベースのデプロイには、適切なリポジトリ連携が必要です
• Production デプロイでは、Production ドメインのエイリアスが自動的に更新されます
• デプロイの作成は非同期です。ステータスを確認するには 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：秒単位の TTL

注意点：

• DNS を管理する前に、ドメインを Vercel アカウントに追加する必要があります
• SSL 証明書は自動でプロビジョニングされますが、新しいドメインでは時間がかかる場合があります
• アペックスドメインの CNAME レコードはサポートされていません。代わりに A レコードを使用してください
• 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：ページごとの結果数
• 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 パラメーターを使用して、1 ページあたりの件数を指定します
• レスポンスにページネーショントークンまたは next フィールドがあるか確認します
• 次のページがないことが示されるまで、取得を続けます

既知の注意点

デプロイの状態：

• 状態には INITIALIZING、ANALYZING、BUILDING、DEPLOYING、READY、ERROR、CANCELED、QUEUED があります
• READY 状態のデプロイのみが稼働し、トラフィックを処理します
• ERROR 状態のデプロイは、失敗の詳細を確認するためにログを調査してください

環境変数：

• Secret タイプの変数は書き込み専用です。作成後に値を取得することはできません
• 環境変数は環境（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

---

Composio 提供