Conectar seu assistente de IA (MCP)

MCP (Model Context Protocol) é a forma padrão de um assistente de IA (o Claude, por exemplo) se conectar a uma ferramenta e usá-la de verdade. A Bernuvia expõe seu marketplace por MCP, então seu assistente não te explica como publicar um template: ele publica, na sua conta e com as suas permissões.

• São as mesmas funções que o site usa, com as mesmas validações, a mesma revisão e a mesma moderação.
• Não precisa programar: você conecta com uma linha e um token que cria e revoga quando quiser.
• Funciona com o Claude e com qualquer cliente que fale MCP.

1. 1Entre em MCP no seu painel e clique em Criar token.
2. 2Dê um nome que diga para que serve (“Claude do meu notebook”, “vendas”) e escolha as permissões. Se sua conta tiver 2FA, ele vai pedir o código.
3. 3Copie o token na hora: por segurança, ele não é exibido de novo. Se perder, revogue e crie outro.
4. 4Guarde em uma variável de ambiente e conecte seu cliente com o bloco correspondente (abaixo há um por cliente).
5. 5Abra uma sessão nova do seu assistente: as ferramentas são anunciadas quando a conversa começa, então não aparecem naquela que já estava aberta.

read -rs BERNUVIA_TOKEN && export BERNUVIA_TOKEN

$BERNUVIA_TOKEN = Read-Host "Bernuvia token"

claude mcp add --transport http bernuvia https://www.bernuvia.com/api/mcp \
  --header "Authorization: Bearer ${BERNUVIA_TOKEN}"

https://www.bernuvia.com/api/mcp
Authorization: Bearer TU_TOKEN

https://www.bernuvia.com/api/mcp
Authorization: Bearer TU_TOKEN

{
  "mcpServers": {
    "bernuvia": {
      "url": "https://www.bernuvia.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${BERNUVIA_TOKEN}"
      }
    }
  }
}

{
  "servers": {
    "bernuvia": {
      "type": "http",
      "url": "https://www.bernuvia.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:BERNUVIA_TOKEN}"
      }
    }
  }
}

Cada token carrega permissões e cada função pede a sua. Você dá só o que quiser que ele faça:

• Somente leitura: catálogo e avaliações, suas compras, favoritos, saldo, notificações, indicações e estatísticas.
• Comprador: carrinho, marcar favoritos, deixar avaliações, reportar falhas, preparar pagamentos, fechar um pedido seu que ainda não foi pago e já não tem cotação resgatável, e abrir, retirar ou encerrar por vencimento uma disputa das suas compras.
• Vendedor: suas vendas e estatísticas, rascunhos, publicar para revisão, códigos de desconto e responder avaliações.

Você pode ter várias conexões ao mesmo tempo sem que uma atrapalhe a outra: uma para vender, outra para comprar, ou uma para cada conta sua. Só é preciso cuidar para que cada uma tenha o seu nome e a sua variável.

• Um nome por propósito, no token e no servidor dentro do seu cliente: `bernuvia-ventas` e `bernuvia-compras` se distinguem num relance.
• Uma variável por token: `BERNUVIA_TOKEN_VENTAS` e `BERNUVIA_TOKEN_COMPRAS`, para nunca colar a chave errada.
• Alcance por pasta ou projeto se o seu cliente permitir: a configuração fica junto do projeto e só carrega quando você trabalha ali. Se só houver configuração global, bastam os nomes diferentes.
• Cada token leva as suas próprias permissões: um de compra não pode vender, e um de venda não gerencia os seus agentes.

Não é uma promessa: o servidor simplesmente não tem funções para isso, então nenhum agente (nem um token roubado) consegue tentar.

• Assinar um pagamento. Ele pode preparar a compra e te dar o link; a assinatura você faz no navegador com a sua wallet. Com as disputas, igual: ele prepara o link para abrir, para retirar, ou para encerrar por vencimento (quando o prazo acabou sem o time resolver, o valor volta integral para você, sem comissão), e você assina.
• Sacar seu dinheiro. Sacar exige a sua assinatura e um código enviado para o seu e-mail.
• Mexer na sua conta. Não muda seu e-mail, nem seu 2FA, nem cria outros tokens.
• Entrar no painel de administração. Um agente opera como você, e só como você.

1. 1Entre em MCP e clique em Revogar no token que te preocupa: ele para de funcionar na hora.
2. 2Se suspeitar que sua conta foi comprometida, ative o 2FA em Segurança: ao ativar, TODOS os seus tokens são revogados de uma vez, além de encerrar as outras sessões.