Сервер Vercel MCP для Microsoft Copilot Studio

Без зависимостей Model Context Protocol сервер для платформы Vercel, созданный специально для работы с Microsoft Copilot Studio (который требует транспорта Streamable HTTP и поддерживает аутентификацию по API-ключу).

Зачем это существует: Официальный MCP-сервер Vercel (https://mcp.vercel.com) использует OAuth с динамической регистрацией клиентов, которую Copilot Studio не может выполнить при подключении MCP. Этот сервер устраняет разрыв: API-ключ, который вы вводите в Copilot Studio, — это ваш токен доступа Vercel, передаваемый с каждым запросом в REST API Vercel. Сам сервер не сохраняет состояние и ничего не хранит.

Инструменты

Развертывание

Вариант A — Развертывание на Vercel (рекомендуется, ~1 минута)

Или с помощью CLI:

vercel deploy --prod

Ваша конечная точка MCP будет: https://<your-deployment>.vercel.app/mcp

Вариант B — Самостоятельное размещение (любой хост с Node 18+)

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

npm install не требуется — зависимостей нет.

Подключение из Copilot Studio

1. Создайте токен доступа Vercel на странице https://vercel.com/account/settings/tokens (ограничьте его командой/проектами, которыми должен управлять агент).

2. В Copilot Studio откройте своего агента → Tools → Add a tool → Model Context Protocol (MCP).

3. Заполните:

   • Name: Vercel

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

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

   • Authentication: API key

     • Header name / location: x-api-key (header)

     • Value: ваш токен доступа Vercel

4. Нажмите Add → Copilot Studio выполнит рукопожатие MCP и отобразит все 13 инструментов.

5. Create connection, включите его в диспетчере подключений, затем протестируйте в области предварительного просмотра, например:

   • "List my Vercel projects"

   • "Show me the build logs for the latest failed deployment of my-site"

   • "Add an env var API_URL=https://api.example.com to my-site for preview only"

Сервер также принимает токен через заголовки Authorization: Bearer <token> или x-vercel-token и возвращается к переменной окружения VERCEL_TOKEN для однопользовательских самостоятельных развертываний (в этом случае выберите No authentication в Copilot Studio — делайте это только если сам URL сервера защищен/приватный).

Архитектура

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, режим без сохранения состояния (версии протокола 2024-11-05 → 2025-06-18). Сессии не требуются, SSE не требуется — идеально для serverless.

• Auth: сквозная аутентификация. Сервер никогда не хранит токены; каждый запрос несет собственный токен Vercel вызывающей стороны.

• Zero dependencies: обычный Node.js ≥18. Ничего устанавливать не нужно, никаких зависимостей.

Разработка и тесты

node test/mcp.test.js

Набор тестов запускает реальный HTTP-сервер, имитирует api.vercel.com и выполняет полное рукопожатие MCP (initialize → initialized → tools/list → tools/call), а также сценарии ошибок (неверный токен, неизвестный инструмент/метод, некорректный JSON, пакетная обработка).

Замечания по безопасности

• Используйте ограниченный токен Vercel, в идеале — в выделенной команде с минимальными правами.

• Значения секретных переменных окружения никогда не возвращаются через list_env_vars.

• Развертывайте только через HTTPS (автоматически на Vercel). Copilot Studio требует HTTPS.

• Рассмотрите заголовки обхода Deployment Protection Vercel, если вы защищаете развертывание.

Лицензия

MIT