MCP server

Nexevo expone un servidor Model Context Protocol (MCP), de modo que un cliente MCP (Claude Desktop, Cursor o cualquier host compatible con MCP) puede invocar un subconjunto seguro de las herramientas de tu workspace, incluida la búsqueda sobre tu propio conocimiento.

Endpoint

Un único endpoint JSON-RPC 2.0 (revisión MCP 2025-03-26, HTTP streamable):

POSThttps://nexevo.ai/v1/mcp

Un administrador debe habilitar el servidor MCP en Settings antes de que responda: hasta entonces devuelve 404. Es un interruptor de go-live deliberado (idéntico a la Tools API), al tratarse de una superficie pública.

Autenticación

Usa la misma API key del workspace que la API REST, en la cabecera Authorization. La clave vincula la conexión a un workspace: un cliente solo ve las herramientas y los datos de ese workspace.

http

Authorization: Bearer sk-ws-...

Qué se expone

Sobre MCP solo está disponible un subconjunto seguro, de solo lectura / solo cómputo del set de herramientas del agent (llama a tools/list para ver la lista exacta de tu workspace):

Investigación web — web_search, url_reader, advanced_scrape, document_read, ocr_extract.
Datos abiertos — arxiv_search, sec_edgar, world_bank, oecd, financial_data, currency_convert, weather, rss_read.
El conocimiento de tu workspace — rag_search sobre su memoria a largo plazo y el conocimiento subido, más spreadsheet_analyze.
Cómputo — calculator, convert, current_time, base64, random_choice.

La generación (imágenes / vídeo / voz), las acciones de atención al cliente, el email, el navegador / escritorio, los connectors y el SQL no se exponen por MCP: un cliente conectado puede leer y razonar, pero no gastar mucho ni cambiar nada.

Métodos

MCP estándar: initialize, la notificación notifications/initialized, tools/list, tools/call y ping.

Pruébalo con curl

Lista las herramientas disponibles:

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"}'

Llama a una — busca en tu conocimiento del 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"}}}'

Conectar un cliente MCP

En cualquier host MCP que admita un servidor remoto HTTP streamable con cabeceras personalizadas, apúntalo al endpoint y pasa tu clave. La forma varía según el cliente, pero las dos cosas que todo cliente necesita son la URL y la cabecera Authorization:

json

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

Las llamadas a herramientas por MCP se facturan a la misma tarifa por llamada que usa el agent (la mayoría de las herramientas de solo lectura son gratuitas). Las respuestas se sanean: un cliente MCP nunca ve errores internos en crudo.