Servidor MCP do ERP nexVero

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 em duas camadas

O acesso ao MCP nexVero usa dois tokens independentes, validados em camadas distintas:

Camada 1 Token do servidor (header HTTP)

Protege o endpoint na internet. Enviado em todo requisição no header Authorization: Bearer. É um por servidor, igual para todas as empresas. Sem ele, o servidor responde 401.

# Header HTTP — token do servidor
Authorization: Bearer <token-do-servidor>

Camada 2 Token da empresa (parâmetro de cada tool)

Protege os dados do ERP. Enviado como parâmetro em cada chamada de tool, junto com id e tenant. É um por empresa, validado dentro da procedure MCP$AUTH no Firebird. Sem ele, a tool retorna erro de acesso.

# Parâmetros de cada tool — token da empresa
tenant     = "alias-da-empresa"    # a chave "apelido" da sua empresa na nexVero
id  = 123                   # ID da empresa
token      = "token-da-empresa"

Mesmo com o token do servidor correto, sem o token da empresa válido a chamada é barrada em MCP$AUTH. Os dois são obrigatórios e independentes.

3 Clientes compatíveis

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

Claude (Anthropic)

Cursor

Windsurf

Devin

Claude Desktop

4 Exemplo: curl

# Handshake inicial (initialize) — só precisa do token do servidor
curl -X POST https://mcperp.nexvero.com.br/mcp \
  -H "Authorization: Bearer <token-do-servidor>" \
  -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"}}}'

O token da empresa é enviado apenas ao chamar uma tool (parâmetros tenant, id, token), não no handshake.

5 Como obter credenciais

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

Você receberá 4 informações:

token-do-servidor — para o header Authorization: Bearer
tenant — alias do banco da sua empresa
id — ID da sua empresa no ERP
token-da-empresa — para passar em cada chamada de tool