MCP — Model Context Protocol

MCPとは何か

Model Context Protocolは、LLMアプリケーションを外部データソースおよびツールに接続するためにAnthropicが策定したオープン標準です。AIクライアント（Claude Desktop、カスタムアプリ）はMCPサーバーから利用可能なツールの一覧を取得し、ユーザーとの会話に基づいてどのツールを呼び出すかを自律的に判断します。

Veritra MCPサーバーはHTTPトランスポートとして動作します。ローカルプロセスは不要で、JSON-RPCリクエストを受け付けるPOSTエンドポイントが1つあるだけです。

エンドポイントと認証

AuthorizationヘッダーにマネジメントAPIキー（mrw_…）を使用してください。ヘッダー X-MRW-Client: mcp は、呼び出しがMCPクライアントからであることを示します（内部でオーディエンストラッキングおよびエンタイトルメントチェックに使用）。

Authorization: Bearer mrw_7fa7785c3d6e…
X-MRW-Client: mcp
Content-Type: application/json

キーはオンボーディング後のダッシュボードで確認できます。同じキーがRESTおよびMCPの両方で使用可能です。別途セットアップは不要です。

JSON-RPCエンベロープ

すべてのリクエストおよびレスポンスはJSON-RPC 2.0仕様に準拠します。ディスカバリーには tools/list、ツール呼び出しには tools/call を使用します。

リクエスト

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tenders_search",
    "arguments": { "qText": "rekonstrukce mostu", "limit": 10 }
  }
}

レスポンス

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{ "type": "text", "text": "{ … JSON payload … }" }]
  }
}

エラー発生時、レスポンスの result の代わりに error オブジェクトが含まれます：

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": { "code": -32602, "message": "Invalid params: qText is required" }
}

ディスカバリー（tools/list）

クライアントは利用可能なツールの一覧を取得します。サーバーはパラメーター用のJSONスキーマを含むMCP標準のツール定義を返します。

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

レスポンスには { name, description, inputSchema } オブジェクトの配列 tools[] が含まれます。AIクライアントは inputSchema を引数の検証に使用します。

ツールカタログ

現在4カテゴリー（tenders：search/detail/filters、leads：filters、accounts、subscriptions、meta）に9つのツールが存在します。

tenders_search

全ポータルにわたる入札案件のライブ検索。上位N件の入札案件を詳細情報（タイトル、金額、締切日、発注機関など）付きで返します。

tenders_get_detail

ドキュメントおよびプリファレンスフラグを含む1件の入札案件の詳細。

tenders_list_industries

フィルタリング用の業種タグ一覧（con_buildings、it_development など）を返します。エージェントはIDをそのまま記述する代わりに、LLMがユーザーフレンドリーなメニューを表示できるようにします。

tenders_list_regions

指定国（デフォルト：CZ）のNUTSリージョン一覧を返します。

leads_list_filters

ユーザーが保存したLEADSフィルターの一覧。

MCP／REST経由で作成されたフィルターはメール、プッシュ通知、Webフックでも使用されます。エージェントが設定すると、ユーザーは通常のチャネルで通知を受け取ります。

leads_create_filter

新しいLEADSフィルターを作成します。条件に一致する案件が発生すると、Webフックおよびメールダイジェストがトリガーされます。

account_create_webhook

イベント受信用の HTTPS Webhook エンドポイントを登録します（leads.match.created など）。エンドポイント ID と HMAC 検証用シークレットが返されます。シークレットは一度しか表示されません — 必ずご自身の ENV に保存してください。

1アカウントあたり最大 5エンドポイント。シークレットのローテーションには /api/v2/account/webhooks/:id/rotate-secret をご利用ください。

subscriptions_list_plans

サービスおよび料金の公開カタログ（LEADS、PRICING、PROCUREMENT）。認証不要。

meta_list_services

Tenderaの全サービスのステータス（稼働状況、非推奨フラグ）。

curl の例

プラハで100万チェコ・コルナ以上の建設入札トップ5を検索する：

curl -X POST https://veritra.io/api/mcp \
  -H "Authorization: Bearer mrw_…" \
  -H "X-MRW-Client: mcp" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "tenders_search",
      "arguments": {
        "industryTags": ["con_buildings"],
        "regions": ["CZ010"],
        "minValue": 1000000,
        "limit": 5
      }
    }
  }'

Claude Desktop でのセットアップ

macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json（または同等のファイル）に追加してください：

{
  "mcpServers": {
    "veritra": {
      "url": "https://veritra.io/api/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer mrw_…",
        "X-MRW-Client": "mcp"
      }
    }
  }
}

Claude Desktop を再起動すると、UI に接続済み MCP サーバーのアイコンが表示されます。会話を開いて、例えば「プラハで100万以上の現在の建設入札は何ですか？」と質問すると、Claude が自動的に tenders_search を呼び出します。

その他の MCP クライアント

MCP サーバーは HTTP トランスポートとして動作し、HTTP 経由の JSON-RPC 2.0 をサポートする任意のクライアントと互換性があります。代表的なクライアントの例を以下に示します。

Cursor / Continue / Cline / Zed

Cursor IDEにはMCPサポートが組み込まれています。~/.cursor/mcp.jsonを編集してください：

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "veritra": {
      "url": "https://veritra.io/api/mcp",
      "headers": {
        "Authorization": "Bearer mrw_mgmt_…",
        "X-MRW-Client": "mcp"
      }
    }
  }
}

Continue.dev

オープンソースのVS Code拡張機能です。config.jsonに追加してください：

// ~/.continue/config.json (snippet)
"mcpServers": [
  {
    "name": "veritra",
    "transport": { "type": "http", "url": "https://veritra.io/api/mcp" },
    "requestOptions": {
      "headers": {
        "Authorization": "Bearer mrw_mgmt_…",
        "X-MRW-Client": "mcp"
      }
    }
  }
]

汎用HTTP MCPクライアント / ChatGPTプラグイン / カスタムLLM

クライアントがネイティブMCPをサポートしていない場合は、JSON-RPC 2.0経由でAPIと直接通信してください。AuthorizationヘッダーとX-MRW-Clientヘッダーがアカウントを識別します。Discovery（tools/list）が最初の呼び出しです。

POST https://veritra.io/api/mcp HTTP/1.1
Authorization: Bearer mrw_mgmt_<your_key>
X-MRW-Client: mcp
Content-Type: application/json

{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }

レート制限

MCP の呼び出しは同一の管理 API 制限（読み取り 60回/分、書き込み 10回/分、1日 5000回）の対象となります。超過した場合は HTTP 429 が返されます（JSON-RPC エラーコード -32000）。