MCP サーバー

Nexevo は Model Context Protocol（MCP）サーバーを提供しているため、MCP クライアント——Claude Desktop、Cursor、その他の MCP 対応ホスト——がワークスペースのツールの安全なサブセットを呼び出せます。あなた自身のナレッジの検索も含まれます。

エンドポイント

単一の JSON-RPC 2.0 エンドポイント（MCP revision 2025-03-26、streamable HTTP）：

POSThttps://nexevo.ai/v1/mcp

MCP サーバーは、管理者が Settings で有効化するまで応答せず、それまでは 404 を返します。これは意図的な稼働スイッチ（Tools API と同様）で、公開サーフェスであるためです。

認証

REST API と同じワークスペース API キーを Authorization ヘッダーに設定して使用します。このキーは接続を 1 つのワークスペースに紐づけます——クライアントが見られるのはそのワークスペースのツールとデータだけです。

http

Authorization: Bearer sk-ws-...

公開されるもの

MCP 経由で利用できるのは、エージェントのツールセットのうち安全で、読み取り／計算専用のサブセットのみです（tools/list を呼ぶとワークスペースの正確な一覧を確認できます）：

Web リサーチ——web_search、url_reader、advanced_scrape、document_read、ocr_extract。
オープンデータ——arxiv_search、sec_edgar、world_bank、oecd、financial_data、currency_convert、weather、rss_read。
あなたのワークスペースのナレッジ——長期記憶とアップロードされたナレッジに対する rag_search、および spreadsheet_analyze。
計算——calculator、convert、current_time、base64、random_choice。

生成（画像／動画／音声）、カスタマーサービスの操作、メール、ブラウザ／デスクトップ、コネクタ、SQL は MCP 経由では公開されません——そのため接続したクライアントは読み取って推論することはできても、多額の消費や変更は行えません。

メソッド

標準的な MCP：initialize、notifications/initialized 通知、tools/list、tools/call、ping。

curl で試す

利用可能なツールを一覧表示：

bash

curl https://nexevo.ai/v1/mcp \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

そのうち 1 つを呼び出す——ワークスペースのナレッジを検索：

bash

curl https://nexevo.ai/v1/mcp \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"rag_search","arguments":{"query":"our refund policy"}}}'

MCP クライアントの接続

カスタムヘッダー付きのリモート streamable-HTTP サーバーをサポートする MCP ホストでは、エンドポイントを指定してキーを渡します。形式はクライアントによって異なりますが、すべてのクライアントが必要とする 2 つは URL と Authorization ヘッダーです：

json

{
  "mcpServers": {
    "nexevo": {
      "url": "https://nexevo.ai/v1/mcp",
      "headers": { "Authorization": "Bearer sk-ws-..." }
    }
  }
}

MCP 経由のツール呼び出しは、エージェントが使用するのと同じ 1 回あたりのレートで課金されます（ほとんどの読み取り専用ツールは無料）。レスポンスはサニタイズされます——MCP クライアントが生の内部エラーを見ることはありません。