設定方法
MCP は、お使いの対応アプリ(クライアント)に下記の設定を貼り付けて使います。 タブからアプリを選び、表示された設定をコピーしてください。
Claude Desktop / Claude Code: Claude Desktop(公式デスクトップアプリ)と Claude Code(公式CLI)は同じ JSON を使います。Desktop は設定ファイルに貼り付け、Claude Code は `.mcp.json` に記述するか `claude mcp add` で追加します。
{
"mcpServers": {
"vercel": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.vercel.com"]
}
}
}
Cursor: AI 機能を内蔵したコードエディタ(`~/.cursor/mcp.json` に記述)
{
"mcpServers": {
"vercel": {
"url": "https://mcp.vercel.com"
}
}
}
Cline: VS Code に追加する AI アシスタント拡張(設定画面の MCP Servers から記述)
{
"mcpServers": {
"vercel": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.vercel.com"]
}
}
}
Gemini CLI: Google の AI CLI。設定形式は Claude Desktop と同じで、`~/.gemini/settings.json` の `mcpServers` に記述するか `gemini mcp add` で追加します。
{
"mcpServers": {
"vercel": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.vercel.com"]
}
}
}
OpenAI Codex: OpenAI の CLI/IDE。設定は TOML 形式で `~/.codex/config.toml` に記述します(下記は左の JSON から自動変換した参考値です)。
[mcp_servers.vercel]
command = "npx"
args = ["mcp-remote", "https://mcp.vercel.com"]VS Code: VS Code(GitHub Copilot のエージェント)。`mcp.json` の `servers` キーに記述します(下記は左の JSON から自動変換した参考値です)。
{
"servers": {
"vercel": {
"type": "stdio",
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.vercel.com"
]
}
}
}※ Gemini CLI は Claude Desktop と同じ mcpServers 形式のため同一の JSON を表示しています。Codex / VS Code タブの設定は、上記 JSON を各公式スキーマ(Codex=~/.codex/config.toml の TOML 形式 / VS Code=mcp.json の servers キー)へ 自動変換した参考値です。貼り付け前にお使いのバージョンの公式ドキュメントもご確認ください。
Vercel とは
Vercel は、Web サイトやアプリを公開するための場所として最も人気のサービスです。コードを GitHub に push するだけで自動的に公開先の URL が生まれ、独自ドメインも数クリックで設定できる手軽さで、個人開発者から大手企業まで広く使われています。
Next.js(Vercel 社が開発するフレームワーク)と組み合わせて使われることが多く、「Next.js で作って Vercel で公開」は近年の Web 開発の定番パターンの一つです。プレビュー URL の自動生成・環境変数管理・ビルドログ・解析(Analytics)など、Web サイトの運用に必要な機能が一通り揃っています。
これは Vercel 公式のツールです。
Vercel × AI でできること
この MCP サーバーを導入すると、Vercel の運用作業を AI への一言で実行できます。
🚀 デプロイ
「main ブランチの最新コードをデプロイして」
→ Vercel API 経由でデプロイ実行
🔍 ビルド失敗を解析
「最新のビルドが失敗している原因を調べて」
→ ビルドログ取得 + エラー解析 + 修正案
🔗 プレビュー URL を取得
「最新のプレビューデプロイの URL を教えて」
→ デプロイ一覧からプレビュー URL を取得
📊 ランタイムログを調査
「直近のランタイムログからエラーを抽出して原因を教えて」
→ 関数のログを環境・レベル・時間で絞り込み取得
提供される主なツール
Vercel MCP Server が公式に提供するツール(全 32 種・公式ドキュメントの区分に沿って整理):
| 機能カテゴリ | 内容(主なツール) |
|---|---|
| ドキュメント検索 | Vercel 公式ドキュメントの検索(search_vercel_documentation) |
| プロジェクト管理 | チーム一覧(list_teams)/ プロジェクト一覧(list_projects)/ 詳細取得(get_project) |
| デプロイ | デプロイ実行(deploy_to_vercel)/ 一覧(list_deployments)/ 詳細取得(get_deployment)/ ビルドログ(get_deployment_build_logs)/ ランタイムログ(get_runtime_logs)/ ランタイムエラー(get_runtime_errors) |
| アクセス解析 | Web Analytics の取得(get_web_analytics)。合計値の取得と、ページ・国・参照元・デバイス等で切った集計に対応 |
| エージェント実行の可視化 | eve フレームワークで作ったエージェントの実行記録を追う。プロジェクト一覧(list_agent_run_projects)/ 実行一覧(list_agent_runs)/ 詳細(get_agent_run)/ 実行トレース(get_agent_run_trace) |
| ドメイン | 空き状況・価格の確認(check_domain_availability_and_price) |
| 購入・課金 | 見積もり(get_purchase_quote)/ Pro プラン購入(buy_pro)/ クレジット購入(buy_credits)/ アドオン購入(buy_addon)/ ドメイン購入(buy_domain)/ 注文状況(get_domain_order) |
| アクセス | 保護デプロイの共有リンク発行・コンテンツ取得(get_access_to_vercel_url / web_fetch_vercel_url) |
| デザインの取り込み | Claude Design で作った HTML 一式を URL から取り込んで Vercel に公開(import-claude-design-from-url) |
| Toolbar コメント | コメントスレッドの一覧・取得・返信・解決状態変更・リアクション(list_toolbar_threads ほか) |
| CLI 連携 | Vercel CLI コマンドの実行(use_vercel_cli) |
注: 環境変数の操作・デプロイのロールバック専用ツールは、現在も提供されていません(2026-08-13 に公式ツール一覧で再確認)。最新の一覧は公式ドキュメント でご確認ください。
Vercel MCP Server について
Vercel MCP Server は、Vercel 社が公式に提供するリモート型 MCP サーバーです。Vercel API を経由して、AI エージェントからデプロイ実行・ビルドログ取得・環境変数確認・ドメイン管理などを実行できます。
エンドポイント https://mcp.vercel.com に接続するリモート型 MCPのため、ローカル npm インストールは不要です。OAuth 認証で接続するため API トークンの管理も不要で、Linear MCP・Supabase MCP と同じく「公式が運用するリモート MCP」のモダンな構成を採用しています。
スペック
- 配布形態: リモート型 MCP サーバー(Vercel 管理)
- エンドポイント:
https://mcp.vercel.com - 認証: OAuth(ブラウザ)/ API トークン不要
- 提供元: Vercel 社(公式)/ Proprietary(公式ホスト)
- 対応範囲: プロジェクト / デプロイ / ビルド・ランタイムログ・ランタイムエラー / アクセス解析(Web Analytics) / エージェント実行の可視化 / ドメイン / 購入・課金 / デザインの取り込み / Toolbar コメント / CLI 連携 / ドキュメント検索(全 32 種)
- 公式ドキュメント: vercel.com/docs/agent-resources/vercel-mcp
導入手順
前提条件
- Node.js 18 以上(
mcp-remoteブリッジ経由の場合) - Vercel アカウント(OAuth 認証のため、API トークンは不要)
ステップ
- ページ上部のタブから使用環境を選択し、JSON 設定をコピー
- コピーした JSON を設定ファイル(claude_desktop_config.json など)に追記して保存
- クライアントを再起動
- 初回接続時にブラウザが開くので、Vercel アカウントでログインして認証を完了
注意事項
- Vercel MCP は OAuth を使用するため、API トークンの管理は不要です。認証は Vercel アカウントへの OAuth ログインで完結します。
- AI クライアントには Vercel アカウントと同等の権限が付与されます。デプロイの実行は本番環境に即座に反映されるため、AI 実行前に確認を求めるよう設定することを推奨します。
- お金が動くツールが含まれます(
buy_pro/buy_credits/buy_addon/buy_domain)。購入は「見積もり → 確認」の 2 段階で、見積もりのget_purchase_quoteは読み取り専用のため課金は発生せず、支出上限もあわせて返ります。ただし確認の実行自体を AI にまかせることは可能なため、ツール実行前に人の承認を求める設定を必ず有効にしてください。公式ドキュメントも、実行時の人による確認を有効にすることと、他のサーバーと併用する際に不正な指示を紛れ込ませる攻撃に注意することを促しています。 - Beta 提供中です(2026-08-13 に公式ドキュメントで再確認)。Vercel 側は無料の Hobby を含む全プランで利用できます(Public Beta Agreement と AI Product Terms が適用されます)。なお Claude の設定画面(コネクタ)から追加する場合は、Claude 側で Pro / Max / Team / Enterprise プランが必要です。本ページの JSON 設定(
mcp-remote経由)ならこの制限はかかりません。 - リモート MCP のため、本サービスへの接続にはインターネットが必要です。
主なユースケース
- 「main ブランチの最新コードをデプロイして」と頼むだけで Vercel へのデプロイが完了するため、コンソールを開く手間がなくなる
- ビルドが失敗したときに「ビルドログを確認してエラーの原因と修正方法を教えて」と頼むと、AI が即座に解析してくれる
- 「最新のプレビューデプロイの URL を教えて」と頼めば、レビュー依頼に使う URL をすぐ取得できる
- 本番でエラーが出たとき「直近のランタイムログからエラーを抽出して原因を教えて」と頼めば、関数のログを横断して調査できる
プラットフォーム別の注意事項
- Windows初回接続時にブラウザが開き、Vercel アカウントへの OAuth 認証が求められます。API トークンは不要です。
- プロキシ環境社内プロキシ環境では `HTTPS_PROXY` 環境変数を設定してください。