MCP server

Nexevo 提供 Model Context Protocol（MCP）server，因此 MCP 用戶端——Claude Desktop、Cursor 或任何支援 MCP 的宿主——可呼叫你 workspace 工具的安全子集，包含搜尋你自己的知識。

端點

單一 JSON-RPC 2.0 端點（MCP revision 2025-03-26，streamable HTTP）：

POSThttps://nexevo.ai/v1/mcp

MCP server 必須先由管理員在 Settings 中啟用才會回應——在那之前會回傳 404。這是一個刻意的上線開關（與 Tools API 相同），因為它屬於公開介面。

驗證

使用與 REST API 相同的工作區 API key，放在 Authorization 標頭中。該 key 會將連線綁定至單一 workspace——用戶端只會看到該 workspace 的工具與資料。

http

Authorization: Bearer sk-ws-...

公開的內容

MCP 上只提供 agent 工具集中安全、唯讀／僅計算的子集（呼叫 tools/list 可查看你 workspace 的確切清單）：

網頁研究——web_search、url_reader、advanced_scrape、document_read、ocr_extract。
開放資料——arxiv_search、sec_edgar、world_bank、oecd、financial_data、currency_convert、weather、rss_read。
你的 workspace 知識——對其長期記憶與上傳知識進行 rag_search，以及 spreadsheet_analyze。
計算——calculator、convert、current_time、base64、random_choice。

生成（圖片／影片／語音）、客服動作、電子郵件、瀏覽器／桌面、connectors 與 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"}'

呼叫其中一個——搜尋你的 workspace 知識：

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 server 與自訂標頭的 MCP 宿主中，將它指向該端點並傳入你的 key。格式因用戶端而異，但每個用戶端需要的兩樣東西都是 URL 與 Authorization 標頭：

json

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

透過 MCP 的工具呼叫，計費費率與 agent 使用時相同（多數唯讀工具免費）。回應會經過清理——MCP 用戶端絕不會看到原始的內部錯誤。