MCP server

Nexevo 暴露了一个 Model Context Protocol（MCP）server，因此 MCP 客户端——Claude Desktop、Cursor 或任何支持 MCP 的宿主——可以调用你工作区工具的一个安全子集，包括搜索你自己的知识。

端点

一个 JSON-RPC 2.0 端点（MCP revision 2025-11-25，streamable HTTP）：

POSThttps://nexevo.ai/v1/mcp

认证

使用与 REST API 相同的工作区 API 密钥，放在 Authorization 头中。该密钥将连接绑定到某个工作区——客户端只能看到该工作区的工具和数据。

http

Authorization: Bearer sk-ws-...

暴露的能力

通过 MCP 仅提供 agent 工具集中一个安全的、只读 / 纯计算的子集（调用 tools/list 可查看你工作区的具体列表）：

网络检索——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。

每个工具都携带 MCP annotations——安全子集的所有工具均标注 readOnlyHint: true、destructiveHint: false、idempotentHint: true，以便客户端（Claude Desktop、Cursor）正确标注。返回结构化数据的工具（如 rag_search）还声明了 outputSchema，tools/call 会在文本之外附带 structuredContent 字段——偏好机器可读输出的客户端可直接消费。

生成（图像 / 视频 / 语音）、客服动作、邮件、浏览器 / 桌面、连接器和 SQL 不会通过 MCP 暴露——因此接入的客户端可以读取和推理，但无法大量消耗或更改任何东西。

方法

标准 MCP 方法：initialize（含版本协商——在 params 中发送你期望的 protocolVersion；我们支持 2025-11-25、2025-06-18 和 2025-03-26，会回传你的版本或回退到我们的最新版）、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"}'

调用其中一个——搜索你的工作区知识：

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 客户端

在任何支持带自定义请求头的远程流式 HTTP server 的 MCP 宿主中，将地址指向该端点并传入你的密钥。具体形态因客户端而异，但每个客户端都需要两样东西：URL 和 Authorization 头：

json

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

通过 MCP 的工具调用按与 agent 相同的每次调用费率计费（大多数只读工具免费）。响应会被净化——MCP 客户端永远不会看到原始的内部错误。