Vercel MCP Server für Microsoft Copilot Studio

Ein abhängigkeitsfreier Model Context Protocol-Server für die Vercel-Plattform, der speziell für die Zusammenarbeit mit Microsoft Copilot Studio entwickelt wurde (das den Streamable-HTTP-Transport erfordert und die Authentifizierung per API-Schlüssel unterstützt).

Warum es das gibt: Vercels offizieller MCP-Server (https://mcp.vercel.com) verwendet OAuth mit dynamischer Client-Registrierung, was das MCP-Onboarding von Copilot Studio nicht abschließen kann. Dieser Server schließt die Lücke: Der API-Schlüssel, den Sie in Copilot Studio eingeben, ist Ihr Vercel-Zugriffstoken, das pro Anfrage an die Vercel-REST-API weitergeleitet wird. Der Server selbst ist zustandslos und speichert nichts.

Tools

Bereitstellen

Option A – Auf Vercel bereitstellen (empfohlen, ~1 Minute)

Oder mit der CLI:

vercel deploy --prod

Ihr MCP-Endpunkt lautet: https://<your-deployment>.vercel.app/mcp

Option B – Selbst hosten (beliebiger Node-18+-Host)

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

Kein npm install erforderlich – es gibt keine Abhängigkeiten.

Von Copilot Studio aus verbinden

1. Erstellen Sie ein Vercel-Zugriffstoken unter https://vercel.com/account/settings/tokens (beschränken Sie es auf das Team/die Projekte, die der Agent verwalten soll).

2. Öffnen Sie in Copilot Studio Ihren Agenten → Werkzeuge → Werkzeug hinzufügen → Model Context Protocol (MCP).

3. Füllen Sie aus:

   • Name: Vercel

   • Beschreibung: Manage Vercel projects, deployments, build logs, domains and environment variables.

   • Server-URL: https://<your-deployment>.vercel.app/mcp

   • Authentifizierung: API-Schlüssel

     • Header-Name / -Ort: x-api-key (Header)

     • Wert: Ihr Vercel-Zugriffstoken

4. Klicken Sie auf Hinzufügen → Copilot Studio führt den MCP-Handshake durch und listet alle 13 Tools auf.

5. Verbindung erstellen, aktivieren Sie sie im Verbindungsmanager und testen Sie dann im Vorschaubereich, z. B.:

   • „Liste meine Vercel-Projekte auf"

   • „Zeig mir die Build-Logs des letzten fehlgeschlagenen Deployments von my-site"

   • „Füge my-site eine Umgebungsvariable API_URL=https://api.example.com nur für die Vorschau hinzu"

Der Server akzeptiert das Token auch über die Header Authorization: Bearer <token> oder x-vercel-token und greift für Single-Tenant-Self-Hosted-Deployments auf eine VERCEL_TOKEN-Umgebungsvariable zurück (wählen Sie in diesem Fall in Copilot Studio Keine Authentifizierung – tun Sie dies nur, wenn die Server-URL selbst geschützt/privat ist).

Architektur

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

• Transport: MCP Streamable HTTP, zustandsloser Modus (Protokollversionen 2024-11-05 → 2025-06-18). Keine Sitzungen, kein SSE erforderlich – ideal für Serverless.

• Auth: Durchreichung. Der Server speichert niemals Tokens; jede Anfrage trägt das eigene Vercel-Token des Aufrufers.

• Null Abhängigkeiten: reines Node.js ≥18. Nichts zu installieren, keine Lieferkette.

Entwicklung & Tests

node test/mcp.test.js

Die Testsuite startet den echten HTTP-Server, mockt api.vercel.com und führt den vollständigen MCP-Handshake durch (initialize → initialized → tools/list → tools/call), plus Fehlerpfade (ungültiges Token, unbekanntes Tool/Methode, fehlerhaftes JSON, Batching).

Sicherheitshinweise

• Verwenden Sie ein eingeschränktes Vercel-Token, idealerweise in einem dedizierten Team mit minimalen Berechtigungen.

• Geheime Werte von Umgebungsvariablen werden von list_env_vars niemals zurückgegeben.

• Nur unter HTTPS bereitstellen (auf Vercel automatisch). Copilot Studio erfordert HTTPS.

• Erwägen Sie Vercel-Deployment Protection-Bypass-Header, wenn Sie das Deployment schützen.

Lizenz

MIT