Servidor MCP

A Nexevo expõe um servidor Model Context Protocol (MCP), então um cliente MCP — Claude Desktop, Cursor, ou qualquer host compatível com MCP — pode chamar um subconjunto seguro das ferramentas do seu workspace, incluindo pesquisar seu próprio conhecimento.

Endpoint

Um único endpoint JSON-RPC 2.0 (revisão MCP 2025-03-26, HTTP streamable):

POSThttps://nexevo.ai/v1/mcp

O servidor MCP precisa ser ativado por um admin em Settings antes de responder — ele devolve 404 até então. É um interruptor de go-live deliberado (idêntico à Tools API), por ser uma superfície pública.

Autenticação

Use a mesma chave de API do workspace que a API REST, no cabeçalho Authorization. A chave vincula a conexão a um workspace — um cliente só vê as ferramentas e dados daquele workspace.

http

Authorization: Bearer sk-ws-...

O que é exposto

Apenas um subconjunto seguro, somente leitura / computação do conjunto de ferramentas do agent está disponível via MCP (chame tools/list para ver a lista exata do seu workspace):

Pesquisa web — web_search, url_reader, advanced_scrape, document_read, ocr_extract.
Dados abertos — arxiv_search, sec_edgar, world_bank, oecd, financial_data, currency_convert, weather, rss_read.
Conhecimento do seu workspace — rag_search sobre sua memória de longo prazo e conhecimento enviado, mais spreadsheet_analyze.
Computação — calculator, convert, current_time, base64, random_choice.

Geração (imagens / vídeo / fala), ações de atendimento ao cliente, e-mail, o navegador / desktop, conectores e SQL não são expostos via MCP — então um cliente conectado pode ler e raciocinar, mas não pode gastar muito nem alterar nada.

Métodos

MCP padrão: initialize, a notificação notifications/initialized, tools/list, tools/call e ping.

Experimente com curl

Liste as ferramentas disponíveis:

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

Chame uma — pesquise o conhecimento do seu 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"}}}'

Conectando um cliente MCP

Em qualquer host MCP que suporte um servidor HTTP-streamable remoto com cabeçalhos personalizados, aponte-o para o endpoint e passe sua chave. O formato varia por cliente, mas as duas coisas que todo cliente precisa são a URL e o cabeçalho Authorization:

json

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

Chamadas de ferramentas via MCP são cobradas na mesma taxa por chamada que o agent usa (a maioria das ferramentas somente leitura é gratuita). As respostas são sanitizadas — um cliente MCP nunca vê erros internos crus.