Vercel MCP Server

🚀 Vercel管理コンソール（MCP）設定ガイド

Vercel管理コンソール（MCP）は、Vercelの管理ツールを提供し、CursorのComposerを通じて操作を簡単に行えます。このガイドでは、MCPのインストール、使用方法、セキュリティ対策、トラブルシューティングなどについて説明します。

🚀 クイックスタート

Vercel管理コンソール（MCP）を使用するには、まず以下の手順でインストールと設定を行います。

📦 インストール

Vercel管理ツールを使用するには、以下の手順に従ってください。

1. アクセストークンの取得

• Vercel公式サイトにログインします。
• 「ユーザー設定」>「セキュリティ」>「アクセストークン」に移動します。
• 新しいアクセストークンを作成し、コピーします。

2. MCPサーバーの設定

• コピーしたアクセストークンをconfig.jsonファイルに貼り付けます。
• ファイルパスはvercel-mcp/config.jsonであることを確認してください。

{
  "token": "your-vercel-token"
}

3. サービスの起動

• ターミナルを開き、vercel-mcpディレクトリに移動します。
• 以下のコマンドを実行します。

node index.js

• サーバーはhttp://localhost:4001で起動します。

💻 使用例

基本的な使用法

設定が完了すると、MCPサーバーはすべてのVercel管理ツールを提供します。CursorのComposerを使用して実行したい操作を記述すると、AIが自動的に対応するコマンドを呼び出します。

例

• プロジェクトリストの照会：「すべてのプロジェクトをリストアップ」と入力
• 新しいプロジェクトの作成：「新しいNext.jsプロジェクトを作成」と入力
• バインド：「プロジェクトにカスタムドメインを追加」と入力
• 環境変数の管理：「環境変数を設定」と入力

⚠️ 重要提示

⚠️ 重要提示

• トークンのセキュリティ：アクセストークンは信頼できるネットワーク環境でのみ使用するようにしてください。
• 権限管理：トークンの使用範囲と有効期限を制限してください。
• ログ監視：定期的に操作ログを確認し、異常があればすぐに対応してください。

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

一般的な問題

1. Node.jsパスのエラー

• システムにNode.jsがインストールされていることを確認します。
• node --versionコマンドを使用してバージョンを確認します。
• which node（mac/Linux）またはwhere node（Windows）コマンドを使用してパスを確認します。

2. トークンが無効になっている

• トークンが期限切れになっていないか確認します。
• トークンに必要な権限があることを確認します。
• トークンを再生成する必要がある場合は、Vercel公式サイトにアクセスしてください。

3. ツールが認識されない

• CursorのMCP設定で「更新」ボタンをクリックします。
• サーバーの実行状態を確認し（エラーメッセージが表示されないこと）、Vercelの認証情報が正しいことを確認します。

デバッグモード

コマンドの前にDEBUG=trueを追加すると、詳細なログが表示されます。

# mac/Linux
DEBUG=true node index.js

# Windows
set DEBUG=true & node index.js

問題が解決しない場合は、以下の情報を提供してください。

• オペレーティングシステムのバージョン
• Node.jsのバージョン
• 具体的なエラーメッセージ
• 問題を再現する手順

🤝 貢献ガイド

皆さんの貢献を歓迎します！修正や改善のPull Requestを自由に送信してください。