Servidor MCP de Vercel para Microsoft Copilot Studio

Un servidor Model Context Protocol de cero dependencias para la plataforma Vercel, construido específicamente para funcionar con Microsoft Copilot Studio (que requiere el transporte HTTP transmisible y admite autenticación mediante clave de API).

Por qué existe esto: El servidor MCP oficial de Vercel (https://mcp.vercel.com) utiliza OAuth con registro dinámico de clientes, algo que la incorporación de MCP de Copilot Studio no puede completar. Este servidor cubre esa brecha: la clave de API que introduces en Copilot Studio es tu token de acceso de Vercel, reenviada en cada solicitud a la API REST de Vercel. El servidor en sí no tiene estado y no almacena nada.

Herramientas

Despliegue

Opción A — Desplegar en Vercel (recomendado, ~1 minuto)

O con la CLI:

vercel deploy --prod

Tu endpoint MCP será: https://<tu-despliegue>.vercel.app/mcp

Opción B — Autohospedaje (cualquier servidor con Node 18 o superior)

node server.js        # listens on PORT (default 3000), endpoint /mcp

No se necesita npm install — no hay dependencias.

Conexión desde Copilot Studio

1. Crea un token de acceso de Vercel en https://vercel.com/account/settings/tokens (limítalo al equipo/proyectos que quieras que el agente gestione).

2. En Copilot Studio, abre tu agente → Herramientas → Agregar una herramienta → Model Context Protocol (MCP).

3. Completa:

   • Nombre: Vercel

   • Descripción: Gestionar proyectos, despliegues, registros de compilación, dominios y variables de entorno de Vercel.

   • URL del servidor: https://<tu-despliegue>.vercel.app/mcp

   • Autenticación: Clave de API

     • Nombre / ubicación del encabezado: x-api-key (encabezado)

     • Valor: tu token de acceso de Vercel

4. Haz clic en Agregar → Copilot Studio realiza el protocolo de enlace MCP y lista las 13 herramientas.

5. Crea la conexión, actívala en el administrador de conexiones y luego pruébala en el panel de vista previa, por ejemplo:

   • "Lista mis proyectos de Vercel"

   • "Muéstrame los registros de compilación del último despliegue fallido de mi-sitio"

   • "Agrega una variable de entorno API_URL=https://api.example.com a mi-sitio solo para vista previa"

El servidor también acepta el token mediante los encabezados Authorization: Bearer <token> o x-vercel-token, y recurre a una variable de entorno VERCEL_TOKEN para autohospedaje de un solo inquilino (en ese caso, elige Sin autenticación en Copilot Studio — solo haz esto si la URL del servidor está protegida/privada).

Arquitectura

Copilot Studio ──POST /mcp (JSON-RPC, Streamable HTTP)──▶ this server ──REST──▶ api.vercel.com
                     x-api-key: <vercel access token>          (stateless, no storage)

• Transporte: MCP HTTP transmisible, modo sin estado (versiones de protocolo 2024-11-05 → 2025-06-18). No se requieren sesiones ni SSE — ideal para serverless.

• Autenticación: de paso. El servidor nunca almacena tokens; cada solicitud lleva el token de Vercel del propio llamante.

• Cero dependencias: Node.js puro ≥18. Nada que instalar, sin cadena de suministro.

Desarrollo y pruebas

node test/mcp.test.js

El conjunto de pruebas inicia el servidor HTTP real, simula api.vercel.com y ejecuta el protocolo de enlace MCP completo (initialize → initialized → tools/list → tools/call), además de los casos de error (token inválido, herramienta/método desconocido, JSON malformado, procesamiento por lotes).

Notas de seguridad

• Usa un token de Vercel con alcance limitado, idealmente en un equipo dedicado con mínimos privilegios.

• Los valores secretos de las variables de entorno nunca se devuelven en list_env_vars.

• Despliega solo bajo HTTPS (automático en Vercel). Copilot Studio requiere HTTPS.

• Considera los encabezados de omisión de Protección de despliegues de Vercel si proteges el despliegue.

Licencia

MIT