MCP e assistentes de IA

O que é o MCP da Alvore?

O MCP da Alvore é um conector que liga a sua conta Alvore ao assistente de IA que você já usa, onde ele aparece com o nome Alvore Finance. MCP é o padrão aberto que permite a um assistente consultar serviços externos. Com o conector ligado, você pergunta sobre o seu dinheiro na própria conversa, como “quanto gastei com mercado este mês?” ou “sobrou quanto do meu orçamento?”, e o assistente consulta os mesmos números do app, sem planilha e sem sair da conversa. No app da Alvore, o recurso fica no menu “Meu agente”, quando está liberado para a sua conta.

Como conecto a Alvore ao assistente de IA que eu já uso?

Você conecta a Alvore pelo menu “Meu agente” do app, que mostra um botão para cada assistente compatível, com o atalho ou o endereço que cada um pede. Se o seu assistente não estiver ali, ou se preferir fazer à mão, adicione nele um conector personalizado com o endereço https://app.alvore.com.br/api/mcp e deixe em branco o Client ID e a chave secreta, porque o registro é automático. Em seguida, o assistente abre a tela da Alvore: entre com a sua conta de sempre, confira o acesso pedido e clique em Autorizar. Funciona em assistentes que aceitam conector MCP remoto.

O MCP da Alvore é somente leitura?

Sim, na sua conta pessoal o MCP da Alvore só lê dados e não altera nada. O acesso do cliente pessoa física tem uma única permissão, a de leitura, e todas as ferramentas entregues ao assistente são marcadas como somente leitura. Pelo conector não dá para editar categorias, mexer no orçamento, criar lançamentos nem movimentar dinheiro. A Alvore também nunca movimenta o seu dinheiro: a conexão com os bancos via Open Finance, regulada pelo Banco Central, é igualmente somente leitura.

O que o assistente consegue ver da minha conta Alvore?

Pelo MCP, o assistente lê só os dados da sua própria conta Alvore, com os mesmos números do app. Ele pode consultar: a visão geral do mês atual (resultado, teto de gastos variáveis, fluxo e maiores categorias); o orçamento de um mês (planejado, realizado e saldo por categoria); as transações de um mês, em totais por categoria ou linha a linha, com data, valor, descrição, nome de quem pagou ou recebeu, categoria e conta, até 200 por consulta; e se uma compra, à vista ou parcelada, cabe no seu orçamento mês a mês. CPF ou CNPJ de terceiros nunca é enviado.

Dá para conectar a Alvore com um token de acesso, sem o login?

Sim: para ferramentas de IA configuradas por arquivo, como editores de código, a Alvore oferece um token de acesso. Gere o token em “Meu agente” > Gerar token e escolha a validade: 30, 90, 180 ou 365 dias, sendo 90 o recomendado. O token aparece uma única vez e deve ser guardado como uma senha; a Alvore guarda só o hash dele. Ele tem a mesma permissão única de leitura do conector, e você pode revogá-lo na mesma tela a qualquer momento, com efeito imediato.

A conexão do assistente com a Alvore expira?

Sim, todo acesso ao MCP da Alvore tem prazo. Quem conecta pelo login da Alvore recebe um acesso de 8 horas, que o assistente renova sozinho; se ele ficar 90 dias sem renovar, é preciso autorizar de novo. Quem gera um token em “Meu agente” escolhe a validade na hora (30, 90, 180 ou 365 dias; 90 é o recomendado), e depois disso o token para de funcionar. Nos dois casos, dá para revogar antes, a qualquer momento.

Como revogo o acesso do assistente à minha conta Alvore?

Você revoga o acesso pelo próprio app da Alvore, no menu “Meu agente”, e o corte é imediato. Na seção “Conexões autorizadas” ficam os assistentes que você autorizou pelo login: clique em Revogar em cada conexão que ainda mostrar o botão. Na seção de tokens de acesso, clique em Revogar no token que quiser desligar. A revogação não pode ser desfeita: para voltar, o assistente precisa ser autorizado de novo ou você gera um token novo. Também dá para remover o conector nas configurações do próprio assistente.

A Alvore registra o que o assistente acessou?

Sim, a Alvore registra cada leitura feita pelo MCP antes de entregar o dado ao assistente. O registro guarda qual consulta foi feita, com quais parâmetros (como o mês pedido), quando e de qual conta, mas não guarda os números devolvidos. Se o registro não puder ser gravado, a leitura é recusada. No app, em “Meu agente”, você vê as conexões autorizadas, com data, permissão, validade e situação, e o último uso de cada token que gerou.

Para ir além

Outros temas da central de ajuda