Microsoft Copilot Studio 向け Vercel MCP サーバー

依存関係ゼロの Model Context Protocol サーバーで、Vercel プラットフォーム向けに構築され、Microsoft Copilot Studio と連携することを目的としています（Copilot Studio は Streamable HTTP トランスポートを必要とし、API キー認証をサポートしています）。

存在理由: Vercel 公式の MCP サーバー (https://mcp.vercel.com) は、動的クライアント登録を伴う OAuth を使用していますが、Copilot Studio の MCP オンボーディングではこれを完了できません。このサーバーはそのギャップを埋めます:Copilot Studio で入力する API キーはお使いの Vercel アクセストークンであり、リクエストごとに Vercel REST API へ転送されます。サーバー自体はステートレスで、何も保存しません。

ツール

デプロイ

オプション A — Vercel にデプロイ（推奨、約1分）

または CLI の場合:

vercel deploy --prod

MCP エンドポイントは次のようになります: https://<your-deployment>.vercel.app/mcp

オプション B — セルフホスト（Node.js 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 で、エージェントを開き → ツール → ツールを追加 → Model Context Protocol (MCP) の順に選択します。

3. 次の項目を入力します:

   • 名前: Vercel

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

   • サーバー URL: https://<your-deployment>.vercel.app/mcp

   • 認証: API キー

     • ヘッダー名 / 場所: x-api-key（ヘッダー）

     • 値: お使いの Vercel アクセストークン

4. 追加 をクリックすると、Copilot Studio が MCP ハンドシェイクを実行し、13 個すべてのツールを一覧表示します。

5. 接続を作成 し、接続マネージャーで有効にして、プレビューペインでテストします。例:

   • "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 環境変数にフォールバックします（その場合は 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)

• トランスポート: MCP Streamable HTTP、ステートレスモード（プロトコルバージョン 2024-11-05 → 2025-06-18）。セッション不要、SSE も不要 — サーバーレスに最適。

• 認証: パススルー。サーバーはトークンを保存しません。すべてのリクエストに呼び出し元自身の Vercel トークンが含まれます。

• 依存関係ゼロ: プレーンな 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 を必要とします。

• デプロイメントを保護する場合は、Vercel の Deployment Protection バイパスヘッダーを検討してください。

ライセンス

MIT