Quegenx Vercel MCP Server

🚀 Vercel 管理命令接口（MCP）インストールガイド

Vercel 管理命令インターフェース（MCP）は、Cursor で Vercel の管理ツールを利用するための便利なインターフェースです。このガイドでは、MCP のインストール、設定、使用方法について説明します。

📦 インストール

インストール手順

1. Node.js のダウンロードとインストール
   Node.js がインストールされていることを確認してください。LTS バージョンの使用を推奨します。
2. MCP リポジトリのクローン
   ターミナルを開き、以下のコマンドを実行します。

   git clone https://github.com/Quegenx/cursor-vercel-mcp.git
   

3. 依存関係のインストール
   リポジトリのディレクトリに移動し、以下のコマンドを実行します。

   npm install
   

4. MCP サービスの起動
   インストールが完了したら、以下のコマンドを実行してサービスを起動します。

   npm start
   

5. Vercel アクセストークンの設定
   Cursor の MCP 設定で、Vercel アクセストークンを追加して認証を完了させます。

🛠️ 設定ガイド

MCP サーバーの初期化

• ターミナルで以下のコマンドを実行して MCP サービスを起動します。

  npm start
  

アクセストークンの設定

• VERCEL_ACCESS_TOKEN 環境変数をプロジェクトに追加し、安全に管理してください。

💻 使用例

設定が完了すると、MCP サーバーは Cursor で Vercel のすべての管理ツールを利用できるようになります。Vercel プロジェクトに対して行いたい操作を説明するだけで、AI が適切なコマンドを実行します。

基本的な使用法

• すべてのプロジェクトをリストする

  vercel projects list
  

• 新しいプロジェクトを作成する

  vercel projects create --name my-next-project --type nextjs
  

• カスタムドメインを追加する

  vercel domains add mydomain.com -p projectId
  

• 環境変数を設定する

  vercel envs create PROJECT_ID VARIABLE_NAME=variable_value
  

⚠️ セキュリティに関する注意事項

1. トークンの安全な管理
   Vercel アクセストークンの安全性を確保し、漏洩を防いでください。
2. 権限管理
   適切なアクセス制御ポリシーを使用し、トークンの使用範囲と権限を制限してください。
3. ベストプラクティスの遵守
   Vercel のセキュリティ推奨事項に従い、定期的に設定を見直して更新してください。

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

一般的な問題

1. Node.js のパス問題
   • 正しい Node.js のパスを使用していることを確認してください。
     • Mac/Linux：which node でパスを確認します。
     • Windows：where node でパスを確認します。
2. トークンが無効
   • Vercel アクセストークンの有効性を確認し、期限が切れていないことと必要な権限があることを確認してください。
3. MCP がツールを認識できない
   • Cursor の MCP 設定でリフレッシュボタンをクリックします。
   • サーバーが正常に動作していることを確認します（エラーメッセージが表示されないこと）。
   • Vercel の認証情報が有効であることを確認します。

デバッグモード

コマンドの前に DEBUG=true を追加して詳細なログ出力を有効にします。

# Mac/Linux
DEBUG=true npm start

# Windows
set DEBUG=true && npm start

🤝 貢献ガイド

貢献を歓迎します！自由に Pull Request を送信してください。