Skip to main content
Glama
deenesjakoruzh
ogradyliam5

Vercel MCP Server for Microsoft Copilot Studio

by ogradyliam5
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Hybrid

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 へ転送されます。サーバー自体はステートレスで、何も保存しません。

ツール

ツール

説明

get_current_user

接続を確認 / トークンの所有者を特定

list_teams

Vercel チームを一覧表示

list_projects

プロジェクトを一覧表示（ID、フレームワーク、本番 URL）

get_project

プロジェクトの詳細（git リポジトリリンクを含む）

list_deployments

最近のデプロイメント。プロジェクト/状態/ターゲットでフィルタ

get_deployment

デプロイメントの詳細（エラー情報を含む）

get_deployment_build_logs

ビルドログ出力 — ビルド失敗の診断に最適

cancel_deployment

ビルド中/待機中のデプロイメントをキャンセル

promote_deployment

デプロイメントを本番にプロモート（ロールフォワード/ロールバック）

list_project_domains

カスタムドメイン + 検証状態

list_env_vars

環境変数（シークレット値は非表示）

create_env_var

環境変数の作成/アップサート

delete_env_var

環境変数の削除

Related MCP server: Vercel MCP Server

デプロイ

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

Deploy with Vercel

または 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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessResponsive

Resources

Related MCP Connectors

Related MCP Servers