Servidor MCP do nexVero ERP

Model Context Protocol — acesso remoto via HTTPS

Credenciais necessárias. Este servidor é restrito a clientes nexVero. Para obter suas credenciais de acesso, envie um e-mail para suporte@nexvero.com.br.

1 Endpoint MCP

Configure seu cliente MCP com a URL abaixo (transporte streamable-http):

URL https://mcperp.nexvero.com.br/mcp

2 Autenticação por chave de API

O acesso ao MCP nexVero usa uma chave de API estruturada por empresa. A chave é enviada no header Authorization: Bearer em toda requisição e carrega internamente o tenant (alias do banco), o id da empresa e o token de acesso — assinados com HMAC-SHA256 para evitar adulteração.

As tools MCP não recebem tenant, id ou token como parâmetros — essas credenciais são extraídas automaticamente da chave pelo servidor. Você só precisa passar os parâmetros de negócio (ex.: data_de, data_ate).

Header Authorization: Bearer <chave>

A chave é uma por empresa e já contém tudo o que o servidor precisa para autenticar e selecionar o banco de dados correto. Sem ela, o servidor responde 401.

# Header HTTP — chave de API da empresa
Authorization: Bearer <chave-de-api>

A validação acontece em duas etapas: a assinatura HMAC é verificada no servidor (middleware) e o token interno é validado no banco Firebird pela procedure MCP$AUTH_EMPRESA.

3 Clientes compatíveis

Servidores MCP remotos (HTTP/SSE) são suportados por:

Claude (Anthropic)

Cursor

Windsurf

Devin

Claude Desktop

OpenCode

4 Exemplo: curl

# Handshake inicial (initialize) — só precisa da chave de API
curl -X POST https://mcperp.nexvero.com.br/mcp \
  -H "Authorization: Bearer <chave-de-api>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"exemplo","version":"1.0"}}}'

A chave de API já contém tenant, id e token embutidos, então não é preciso passar nada extra ao chamar uma tool — apenas os parâmetros de negócio.

5 Como obter credenciais

Envie um e-mail para suporte@nexvero.com.br solicitando as credenciais de acesso ao MCP do nexVero ERP. Inclua o nome da sua empresa e o contexto de uso para agilizarmos o atendimento.

Você receberá 1 informação:

chave-de-api — chave única que já contém tenant, id e token embutidos; envie no header Authorization: Bearer