Apidog

オールインワン協働API開発プラットフォーム

API設計

APIドキュメント

APIデバッグ

APIモック

API自動テスト

VercelでMCPサーバーを実行する方法

中村 拓也

中村 拓也

Updated on 4月 9, 2025

急速に進化するソフトウェア開発の風景の中で、モデルコンテキストプロトコル(MCP)サーバーはAPI開発のゲームチェンジャーとして登場しました。これらの専門サーバーは、AIアシスタントと構造化データソースをつなぎ、複雑なAPI仕様との自然言語インタラクションを可能にします。

MCPサーバーは、AIツールの知識提供者として機能し、API仕様に直接アクセスし、理解し、利用することを可能にします。この能力は、開発者がAPIを扱う方法を次のように変革します:

  • ドキュメントとコード間のコンテキスト切り替えを排除
  • 仕様への直接アクセスによって実装エラーを削減
  • AI支援のコード生成による開発の加速
  • API実装の一貫性を保証

Vercelにデプロイされると、MCPサーバーはグローバルな可用性、自動スケーリング、簡素化されたデプロイプロセスの追加の利点を得ます。このクラウドベースのアプローチにより、どこからでもAIツールにAPI仕様へのアクセスを提供し、真にモダンな開発環境を作り出します。

💡
VercelにMCPサーバーをデプロイすることで優れたクラウド機能が提供されますが、Apidog MCP Serverと組み合わせることで、完全な開発エコシステムが作られます。Apidog MCP ServerはAIアシスタントにAPI仕様への直接アクセスを提供し、生成されたコードがAPI設計と完全に一致することを保証します。同時に、Vercelがクラウドデプロイを処理します。この強力な組み合わせにより、API設計と実装のギャップが解消され、開発時間とエラーが大幅に削減されます。
ボタン

強化されたAPI開発のためのVercelベースのMCPサーバーの設定

Vercel に MCP サーバーをデプロイするには、最適なパフォーマンスと API 開発ワークフローとの統合を保証するための慎重な設定が必要です。このセクションでは、サーバーを設定するための包括的なガイドを提供します。

Vercel MCP デプロイの前提条件

デプロイプロセスを開始する前に、以下を確認してください:

  • Vercel アカウント (プロダクション使用には Pro または Enterprise を推奨)
  • Node.js 環境 (バージョン18以上)
  • TypeScript と API の基本的な理解
  • 状態管理のための Redis データベース (Vercel デプロイメントに必要)
  • AIツールに提供したいAPI仕様

ステップバイステップの Vercel MCP サーバー設定

プロジェクト構造を初期化する

新しいプロジェクトディレクトリを作成して初期化します:

mkdir vercel-mcp-server
cd vercel-mcp-server
npm init -y
npm install @modelcontextprotocol/sdk @vercel/redis express

サーバー実装を作成する

あなたの MCP サーバーの実装を含む api/server.ts ファイルを作成します:

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp";
import { z } from "zod";

// MCP サーバーインスタンスを作成
const server = new McpServer({
 name: "API-Development-Server",
 version: "1.0.0"
});

// API仕様リソースを追加
server.resource(
 "api-spec",
 "api-spec://main",
 async (uri) => ({
   contents: [{
     uri: uri.href,
     text: "API仕様の内容をここに"
   }]
 })
);

// エンドポイント生成ツールを追加
server.tool(
 "generate-endpoint",
 { 
   path: z.string(),
   method: z.enum(["GET", "POST", "PUT", "DELETE"]),
   description: z.string()
 },
 async ({ path, method, description }) => ({
   content: [{
     type: "text",
     text: `生成された ${method} エンドポイント ${path} の説明: ${description}`
   }]
 })
);

export default server;

Vercelの設定を構成する

プロジェクトルートに vercel.json ファイルを作成します:

{
 "version": 2,
 "builds": [
   {
     "src": "api/server.ts",
     "use": "@vercel/node",
     "config": { 
       "maxDuration": 800,
       "memory": 3008
     }
   }
 ],
 "routes": [
   { "src": "/api/(.*)", "dest": "/api/server.ts" }
 ]
}

Redis統合を設定する

Vercelダッシュボードを通じてRedis統合を追加します:

  • プロジェクト設定に移動
  • "統合"タブを選択
  • Vercel Redis統合を追加
  • REDIS_URL 環境変数をメモする

Vercelにデプロイする

MCPサーバーをVercelにデプロイします:

vercel --prod

デプロイが完了したら、サーバーのURL(例:https://your-mcp-server.vercel.app)をメモしてください。

包括的なAPI開発のためのVercelとApidog MCP Serverの統合

真に強力なAPI開発環境を作成するために、VercelにデプロイされたMCPサーバーをApidog MCP Serverと統合することは、両方の利点を提供します。この組み合わせにより、AIツールは、クラウドベースのMCPツールとApidogで管理される詳細なAPI仕様の両方にアクセスできます。

Apidog MCP サーバーの設定

Apidog MCP サーバーをインストールする

npm install -g apidog-mcp-server

Apidogプロジェクト情報を取得する

  • Apidogアカウントにログインする
  • プロジェクト設定に移動する
  • プロジェクトIDをコピーする
ApidogでプロジェクトIDをコピーする
  • アカウント設定 → APIアクセス トークンからAPIアクセス トークンを生成する
APIアクセス トークンを生成する

統合MCP設定を構成する

IDEのMCP設定を更新し、両方のサーバーを含めます:

{
 "mcpServers": {
   "vercel-mcp": {
     "command": "curl",
     "args": [
       "https://your-mcp-server.vercel.app/api/server"
     ]
   },
   "apidog-mcp": {
     "command": "cmd",
     "args": [
       "/c",
       "npx",
       "-y",
       "apidog-mcp-server@latest",
       "--project=<your-project-id>"
     ],
     "env": {
       "APIDOG_ACCESS_TOKEN": "<your-access-token>"
     }
   }
 }
}

この設定により、AIアシスタントは、VercelにデプロイされたMCPサーバーとApidogのAPI仕様の両方にアクセスできるようになります。

VercelとApidog統合によるAI支援のAPI開発の活用

VercelにデプロイされたMCPサーバーとApidog MCP Serverの組み合わせは、API開発を変革する強力なワークフローを生み出します。両方のMCPサーバーが設定されることで、開発者は:

AIの支援を受けたAPI駆動型アプリケーションの構築

設計フェーズ

"Apidog MCPを使用して、私たちのユーザーモデルのスキーマを見せてください"

AIはApidogから直接APIスキーマを取得して表示します。

実装フェーズ

"Vercel MCPを使用して、Apidog仕様に基づいてUserエンドポイントのコントローラを生成してください"

AIはAPI設計に完璧に一致する実装コードを生成できます。

テストフェーズ

"Apidog仕様に基づいてUser APIエンドポイントのテストケースを作成してください"

AIは仕様に対して実装を検証する包括的なテストを生成できます。

Vercel MCP デプロイメントにおける一般的な問題のトラブルシューティング

VercelにMCPサーバーをデプロイする際に、次のような一般的な問題に直面する可能性があります:

Redis接続エラー

  • 環境変数でREDIS_URLが正しく設定されていることを確認してください
  • VercelダッシュボードでRedisインスタンスの状態を確認してください
  • コードでの適切なRedis接続設定を確認してください

関数タイムアウトの問題

  • vercel.jsonmaxDurationを増加させる(Pro / Enterpriseプランが必要)
  • ツールの実装を最適化して迅速な実行を実現
  • 複雑な操作を小さなチューニング可能なツールに分けることを検討してください

Apidogとの統合問題

  • Apidogアクセス トークンが有効で適切な権限を持っていることを確認してください
  • プロジェクトIDが正しくアクセス可能であることを確認してください
  • 統合する前にApidog MCP Serverを独立してテストしてください

結論:VercelとApidog MCP統合によるAPI開発の変革

VercelにデプロイされたMCPサーバーとApidog MCP Serverの統合は、API開発手法の重要な進展を示しています。AIアシスタントがクラウドベースのツールと詳細なAPI仕様の両方にアクセスできる統一された環境を構築することで、この組み合わせはモダンなAPI開発の持続的な課題に対処します。

この統合アプローチは、開発ライフサイクル全体で具体的な利点を提供します。開発者はドキュメントと実装の間で切り替える時間が減り、価値を生み出す時間が増えます。コード生成はAPI仕様との完全な整合性を維持し、設計と実装の間でよく発生するズレを排除します。

API駆動型アプリケーションを構築する組織にとって、この組み合わせはAPIの構築と維持の方法を変革します。Vercelのクラウドベースの特性により、MCPツールは常に利用可能であり、ApidogはAPI仕様との重要な接続を維持します。これにより、全体でその部分の合計を超える開発環境が構築されます。

VercelにデプロイされたMCPサーバーとApidog MCP Serverの統合を受け入れることで、開発チームは現代的なAPI開発の最前線に自らを定位し、より良く、一貫したAPIを短時間で提供できる準備を整えます。