Rivo
IntegraçõesIntermediário

MCP com chave de API: Claude Code, n8n e Make

03 Nov, 2026 8 min leitura

MCP com chave de API: Claude Code, n8n e Make

Usa o Claude na web, no desktop ou no celular? Você não precisa de chave. Use o conector Rivo para o Claude, com login e em modo somente leitura.

O Rivo suporta o Model Context Protocol (MCP), um protocolo que permite que clientes de IA usem ferramentas externas de forma padronizada.

Na prática, isso permite que o Claude Code consulte e opere dados financeiros do Rivo a partir do terminal, por exemplo:

"Quais contas a pagar vencem esta semana?" "Me dê um resumo financeiro de janeiro." "Crie uma conta a pagar de R$ 800 para o fornecedor X com vencimento em 30/04."

Este guia cobre o uso com chave de API, necessário para ferramentas de automação e para criar ou baixar contas: Claude Code via CLI ou arquivo .mcp.json, n8n, Make e clientes HTTP.

O que você vai configurar

O Rivo expõe um servidor MCP remoto em:

https://rivofinance.com.br/api/mcp

O Claude Code se conecta a esse endpoint usando uma chave no header:

Authorization: Bearer SUA_CHAVE

Passo 1 - Gere sua chave MCP

Acesse Configurações > Integrações dentro do Rivo.

  1. Digite um nome para identificar a chave, por exemplo Claude Code pessoal
  2. Escolha Somente leitura ou Leitura e escrita
  3. Clique em Gerar chave
  4. Copie a chave imediatamente

A chave só é exibida uma vez. Trate como senha: não publique, não envie em prints e não coloque em repositórios.

Cada chave fica vinculada à empresa atual. Se você gerencia mais de uma empresa, gere a chave dentro da empresa correta.

Passo 2 - Adicione o servidor no Claude Code

Depois de gerar a chave, a própria tela de integrações mostra um comando pronto no formato:

claude mcp add-json rivo '{"type":"http","url":"https://rivofinance.com.br/api/mcp","headers":{"Authorization":"Bearer SUA_CHAVE"}}'

Copie o comando, cole no terminal e execute.

Se quiser registrar para todos os seus projetos, use o escopo de usuário:

claude mcp add-json rivo '{"type":"http","url":"https://rivofinance.com.br/api/mcp","headers":{"Authorization":"Bearer SUA_CHAVE"}}' --scope user

Para confirmar:

claude mcp list

Dentro do Claude Code, você também pode usar:

/mcp

Alternativa - Usar .mcp.json

Se preferir versionar a configuração do servidor no projeto, crie um arquivo .mcp.json na raiz do projeto:

{
  "mcpServers": {
    "rivo": {
      "type": "http",
      "url": "https://rivofinance.com.br/api/mcp",
      "headers": {
        "Authorization": "Bearer SUA_CHAVE"
      }
    }
  }
}

Atenção: se o arquivo for commitado, não coloque a chave real nele. Use variável de ambiente quando for compartilhar com equipe.

Exemplo com variável:

{
  "mcpServers": {
    "rivo": {
      "type": "http",
      "url": "https://rivofinance.com.br/api/mcp",
      "headers": {
        "Authorization": "Bearer ${RIVO_MCP_API_KEY}"
      }
    }
  }
}

Passo 3 - Teste no Claude Code

Abra ou reinicie o Claude Code no projeto e pergunte:

"Liste as tools disponíveis do Rivo."

Depois teste uma consulta real:

"Mostre as contas a pagar pendentes."

O Claude deve chamar automaticamente a tool correta do Rivo.

Uso em n8n, Make ou clientes HTTP

Ferramentas HTTP também podem chamar o endpoint MCP diretamente.

CampoValor
MethodPOST
URLhttps://rivofinance.com.br/api/mcp
HeaderAuthorization: Bearer SUA_CHAVE
Content-Typeapplication/json
Acceptapplication/json, text/event-stream

Exemplo: listar tools

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {}
}

Exemplo: chamar uma tool

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "resumo_financeiro",
    "arguments": {
      "data_inicio": "2026-01-01",
      "data_fim": "2026-01-31"
    }
  }
}

Tools disponíveis

O Rivo expõe 19 tools: 12 de consulta, disponíveis em qualquer chave, e 7 de escrita, disponíveis apenas em chaves com Leitura e escrita. Cada usuário só recebe as tools dos módulos que pode acessar, e as de escrita também dependem da permissão de edição no módulo.

Consulta

Transações e resumo

  • buscar_transacoes - lista transações financeiras por status, tipo, período e limite
  • resumo_financeiro - retorna saldo bancário, receitas, despesas, resultado, pendências e projeção de caixa

Contas

  • buscar_contas_pagar - lista contas a pagar por status, vencimento, fornecedor e limite
  • buscar_contas_receber - lista contas a receber por status, vencimento, cliente e limite

Relatórios

  • relatorio_dre - gera o Demonstrativo de Resultado do Exercício para um período
  • relatorio_aging - agrupa contas a pagar ou receber por faixas de atraso
  • relatorio_fluxo_caixa - combina realizado do período com projeção de caixa

Conciliação e cadastros

  • listar_pendentes_conciliacao - lista lançamentos pendentes de conciliação
  • detalhar_lancamento - mostra os detalhes de um lançamento
  • buscar_plano_contas - consulta o plano de contas
  • buscar_parceiros - consulta fornecedores e clientes

Contratos

  • buscar_contratos - lista contratos comerciais por status ou cliente

Escrita

  • criar_conta_pagar - cria uma nova conta a pagar
  • baixar_conta_pagar - registra o pagamento de uma conta a pagar
  • atualizar_vencimento_pagar - altera o vencimento de uma conta a pagar em aberto
  • criar_conta_receber - cria uma nova conta a receber
  • baixar_conta_receber - registra o recebimento de uma conta a receber
  • atualizar_vencimento_receber - altera o vencimento de uma conta a receber em aberto
  • criar_contrato_rascunho - cria um contrato em rascunho

As baixas seguem a regra da tela: sem valor, quitam o saldo; com valor menor que o saldo, a conta fica parcial. Títulos sincronizados com o Sienge não podem ser baixados nem ter o vencimento alterado. Tudo entra no histórico de atividades.

Segurança

  • Cada chave pertence a uma empresa específica
  • Você pode revogar qualquer chave em Configurações > Integrações
  • Crie uma chave separada para cada uso, por exemplo Claude Code, n8n produção, Make
  • Revogue chaves antigas ou suspeitas

Nunca compartilhe sua chave publicamente. Se suspeitar de uso indevido, revogue e gere uma nova.

Solução de problemas

Erro 401

A chave não foi enviada. Confira se o header está assim:

Authorization: Bearer SUA_CHAVE

Erro 403

A chave está incorreta, foi revogada, está inativa ou atingiu limite de uso. Gere uma nova chave em Configurações > Integrações.

Claude Code não mostra as tools

Rode:

claude mcp list

E dentro do Claude Code:

/mcp

Se o servidor aparecer mas listar menos ferramentas do que o esperado, reinicie o Claude Code para forçar uma nova leitura do tools/list.

Quero testar a base do projeto localmente

No ambiente de desenvolvimento do Rivo, rode:

pnpm run mcp:smoke

Esse comando valida se o servidor MCP lista as tools tanto via stdio quanto via HTTP.

Leve essa inteligência para sua empresa

Pare de perder tempo com planilhas. O Rivo automatiza sua gestão financeira para você focar em crescer.