Vercel MCP Pro

Vercel MCP Pro ▲

最も包括的な Vercel MCP サーバーです。Vercel REST API 全体をカバーする 70 個のツール（デプロイ、プロジェクト、環境変数、ドメイン、DNS、エイリアス、証明書、ログ、チェック、Webhook、エッジ設定、チーム）に加え、vercel_raw による任意のエンドポイントへのアクセス手段と、読み取り専用の安全モードを備えています。

Vercel アクセストークンを使って、Claude Code、Claude Desktop、Cursor、ChatGPT などのあらゆる MCP クライアントで利用できます（OAuth フローは不要です）。ターミナルからのデプロイで Vercel CLI を操作する、オプションの /vercel スキルも付属しています。

公式のものではなく、これを選ぶ理由は？

	公式 mcp.vercel.com	vercel-mcp-pro
認証	OAuth（承認済みクライアントのみ）	トークン（どこでも動作し、セルフホスト可能）
対応範囲	ドキュメント検索、プロジェクト／デプロイの管理、ログの分析	REST API 全体：環境変数、ドメイン、DNS、エイリアス、証明書、Webhook、エッジ設定、チェック、ログドレインなど
エスケープ手段	—	vercel_raw → 任意のエンドポイントに対応し、100％をカバー
安全性	—	VERCEL_READONLY=true ですべての書き込みをブロック

インストール

npx -y vercel-mcp-pro

または、クローンしてローカルでビルドします。

git clone https://github.com/helbertparanhos/vercel-mcp-pro
cd vercel-mcp-pro
npm install && npm run build

設定

1. https://vercel.com/account/settings/tokens でトークンを作成します。
2. .env.example を .env にコピーし、値を入力します。

変数	必須	説明
VERCEL_TOKEN	✅	個人またはチームのアクセストークンです。
VERCEL_TEAM_ID	—	デフォルトのチームスコープ（?teamId として挿入されます）。個人アカウントの場合は空欄にします。
VERCEL_TEAM_SLUG	—	チームのスラッグによるスコープ指定（VERCEL_TEAM_ID の代替）。
VERCEL_READONLY	—	true にすると、すべての書き込み／削除ツールがブロックされます（vercel_raw の GET のみ許可されます）。
VERCEL_DISABLE_RAW	—	true にすると、vercel_raw のエスケープハッチが無効になります。
VERCEL_TIMEOUT_MS	—	リクエストのタイムアウト（デフォルトは 60000）。
VERCEL_MAX_RETRIES	—	429／5xx／ネットワークエラー時の再試行回数（デフォルトは 3）。

クライアントに追加する

Claude Code

claude mcp add vercel-mcp-pro -- npx -y vercel-mcp-pro

または、このプロジェクトの .claude/settings.json の mcpServers に追加します。

"vercel": {
  "command": "node",
  "args": ["projects/vercel-mcp-pro/dist/index.js"],
  "env": {
    "VERCEL_TOKEN": "your_token",
    "VERCEL_TEAM_ID": "team_xxx"
  }
}

Claude Desktop

%APPDATA%\Claude\claude_desktop_config.json（Windows）／~/Library/Application Support/Claude/claude_desktop_config.json（Mac）：

{
  "mcpServers": {
    "vercel": {
      "command": "npx",
      "args": ["-y", "vercel-mcp-pro"],
      "env": { "VERCEL_TOKEN": "your_token", "VERCEL_TEAM_ID": "team_xxx" }
    }
  }
}

Cursor

同じ設定を .cursor/mcp.json に貼り付けます。

ツール（70）

デプロイ（11）

list_deployments · get_deployment · create_deployment · cancel_deployment · delete_deployment · get_deployment_events · list_deployment_files · get_deployment_file_contents · promote_deployment · rollback_deployment · get_promote_aliases

プロジェクト（7）

list_projects · get_project · create_project · update_project · delete_project · pause_project · unpause_project

環境変数（6）

list_env_vars · get_env_var · create_env_var · bulk_create_env_vars · update_env_var · delete_env_var

ドメイン（9）

list_domains · get_domain · get_domain_config · add_domain · verify_domain · remove_domain · list_project_domains · add_project_domain · remove_project_domain

DNS（4）

list_dns_records · create_dns_record · update_dns_record · delete_dns_record

エイリアス（4）

list_aliases · get_alias · assign_alias · delete_alias

証明書（4）

get_cert · issue_cert · upload_cert · remove_cert

ログ（2）

get_build_logs · get_runtime_logs

チェック（5）

list_checks · get_check · create_check · update_check · rerequest_check

Webhook（3）

list_webhooks · create_webhook · delete_webhook

Edge Config（6）

list_edge_configs · get_edge_config · get_edge_config_items · create_edge_config · update_edge_config_items · delete_edge_config

チームとユーザー（4）

get_user · list_teams · get_team · list_team_members

インテグレーションとログドレイン（4）

list_integrations · list_log_drains · create_log_drain · delete_log_drain

エスケープハッチ（1）

vercel_raw — Vercel REST エンドポイント（メソッド＋完全なバージョン付きパス＋パラメーター＋本文）を任意に呼び出します。ニッチなエンドポイントや新しいエンドポイント（マーケットプレイス、サンドボックス、機能フラグ、アクセスグループ、段階的リリースなど）も含め、100％の網羅性を保証します。チームスコープを自動挿入します。読み取り専用モードでは GET に限り使用できます。

よく使うレシピ

失敗したデプロイを診断する

list_deployments(projectId:"my-app", state:"ERROR")  →  get_build_logs(idOrUrl:"dpl_...")

プレビューを再ビルドせずに本番環境へ反映する

promote_deployment(projectId:"my-app", deploymentId:"dpl_...")

すばやくロールバックする

rollback_deployment(projectId:"my-app", deploymentId:"dpl_previous")

すべての環境に環境変数を追加する

create_env_var(projectId:"my-app", key:"API_KEY", value:"…", target:["production","preview","development"])

対応していない操作を行う

vercel_raw(method:"GET", path:"/v1/security/firewall/config", params:{ projectId:"my-app" })

/vercel CLI スキル（同梱）

ターミナルからデプロイする場合、このリポジトリには公式の Vercel CLI（vercel deploy、vercel logs、vercel env、vercel rollback）を操作する Claude Code スキルも skill/ に同梱されています。MCP はあらゆるクライアントで API を完全に利用でき、スキルはターミナルでの最もスムーズな git push → deploy ワークフローを実現します。両者は互いに補完し合います。詳しくは skill/SKILL.md をご覧ください。

安全性

• VERCEL_READONLY=true を設定すると、書き込み／削除を行うすべてのツールがブロックされ、読み取りと vercel_raw の GET のみが実行されます。監査や調査に最適です。
• vercel_raw のパスはサニタイズされます（/v9/… のようなバージョンセグメントで始まる必要があり、スキーム／ホスト／パストラバーサル／制御文字は使用できません）。また、api.vercel.com に制限されます。
• 認証、再試行（Retry-After を伴う 429、5xx、ネットワークエラー）、レート制限は自動的に処理されます。トークンが送信されるのは Authorization ヘッダーのみで、クエリ文字列やログに含まれることはありません。

セキュリティモデル — ガードを信頼する前にお読みください

• VERCEL_READONLY がブロックするのは 変更 であり、シークレットの読み取り ではありません。 list_env_vars（decrypt:true を指定）、get_env_var、get_edge_config_items などの読み取りツールは、復号済みの値を返し、読み取り専用モードでも実行されます。それがこれらのツールの目的です。環境内のシークレットをモデルに絶対に公開できない場合は、これらのツールを公開しないでください。または、最小権限のトークンを使用してください。
• VERCEL_TEAM_ID は利便性のためのスコープであり、セキュリティ境界ではありません。 デフォルトのチームを設定しますが、呼び出しごとに別の teamId／slug を渡すことができます（vercel_raw 経由の場合も同様です）。実際の境界となるのは トークン自体のスコープ です。自動化する対象のチーム／プロジェクトに限定したトークンを使用してください。
• トークンは本番環境の認証情報として扱ってください。 Vercel アカウント／チームと同じアクセス権が付与されます。スコープを限定したトークンを優先し、.env（gitignore 対象）またはクライアントのシークレットストアに保管してください。共有したりチャットに貼り付けたりした場合は、ローテーションしてください。

ライセンス

MIT © Helbert Paranhos / Strat Academy