Vercel MCP Server

🚀 Vercel Management Console (MCP) Configuration Guide

This guide provides a step-by-step process to configure and use the Vercel Management Console (MCP), enabling you to manage Vercel projects efficiently.

🚀 Quick Start

Prerequisites

• Ensure Node.js is installed on your system.
• Have access to the Vercel website.

📦 Installation

Step 1: Obtain an Access Token

1. Log in to the Vercel website.
2. Navigate to "User Settings" > "Security" > "Access Tokens".
3. Create and copy a new access token.

Step 2: Configure the MCP Server

1. Paste the copied access token into the config.json file.
2. Ensure the file path is: vercel-mcp/config.json.

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

Step 3: Start the Service

1. Open a terminal and navigate to the vercel-mcp directory.
2. Run the following command:

node index.js

3. The server will start at http://localhost:4001.

💻 Usage Examples

Basic Usage

Once the configuration is complete, the MCP server provides all Vercel management tools. Describe the operations you need to perform through Cursor's Composer, and the AI will automatically invoke the corresponding commands.

Example Scenarios

• Query Project List: Enter "List all my projects".
• Create a New Project: Enter "Create a new Next.js project".
• Binding: Enter "Add a custom domain to the project".
• Environment Variable Management: Enter "Set environment variables".

⚠️ Important Note

• Token Security: Ensure that the access token is only used in a trusted network environment.
• Permission Control: Limit the scope and validity period of the token.
• Log Monitoring: Regularly check the operation logs and handle any anomalies promptly.

🔧 Troubleshooting

Common Issues

Node.js Path Error

• Confirm that Node.js is installed on the system.
• Check the version using the command node --version.
• Confirm the path using the command which node (mac/Linux) or where node (Windows).

Token Expired

• Check if the token has expired.
• Ensure that the token has the required permissions.
• If you need to regenerate the token, visit the Vercel website.

Tool Not Recognized

• Click the "Refresh" button in Cursor's MCP settings.
• Confirm the server's running status (no error messages).
• Verify that the Vercel credentials are correct.

Debug Mode

Add DEBUG=true before the command to display detailed logs:

# mac/Linux
DEBUG=true node index.js

# Windows
set DEBUG=true & node index.js

If the issue persists, please provide the following information:

• Operating system version
• Node.js version
• Specific error message
• Steps to reproduce the problem

🤝 Contribution Guidelines

Contributions are welcome! Feel free to submit pull requests for bug fixes or improvements.