Alvore Finance MCP Server for Claude and ChatGPT
By Alvore Consultoria
Overview
O Alvore Finance conecta o Claude à plataforma da Alvore Consultoria, onde empresas (PJ) e pessoas (PF) acompanham o próprio financeiro com dados do Open Finance e do ERP. Para quem é: consultores da Alvore, titulares de empresas clientes e clientes pessoa física com conta na plataforma. Cada um enxerga só o que a própria conta já vê no app. O que dá para ler: - Empresas: DRE, indicadores, visão geral do mês, orçamento, fluxo de caixa e transações bancárias categorizadas; plano de contas e regras de categorização; dados do ERP conectado (títulos em aberto, produtos, ficha técnica, estoque). - Pessoa física: visão geral do mês, orçamento familiar, transações e o veredito "posso fazer esta compra?" pelo método da Alvore. - Projetos: briefings e artefatos HTML da consultoria. O que dá para escrever (só com os escopos concedidos na tela de consentimento): - Projetos, artefatos HTML e novas versões. O que a consultoria escreve só chega ao cliente depois de um clique humano na plataforma. - Classificação de transações e ajustes do plano de contas, com simulação antes e desfazer depois. - Cadastro de produtos, fichas técnicas e movimentos de estoque (livro só de acréscimo, correção por estorno). - Propostas de ação no ERP, executadas somente após aprovação humana. O conector não movimenta dinheiro: nenhuma ferramenta inicia pagamento, transferência ou compra. A autenticação é OAuth 2.1 com consentimento por escopo, e as leituras de dado financeiro ficam registradas em trilha de auditoria.
How to connect
- Claude: Open the Alvore Finance listing in the Claude connectors directory and choose Connect. Claude listing Alvore Finance exposes 45 tools here.
- ChatGPT: Open the Alvore Finance listing in the ChatGPT app directory and choose Connect. ChatGPT listing Alvore Finance exposes 81 tools here.
Tools
alterar_plano_contas
ChatGPToperacao: "papel_grupo" troca o papel DRE de um grupo (grupoId, papel — string do enum ou null para "Automático"). operacao: "mover_categoria" move uma categoria para outro grupo (categoriaId, novoGrupoId). operacao: "papel_subcategoria" troca o budgetRole de uma subcategoria (subcategoriaId, budgetRole). operacao: "mover_subcategoria" move uma única subcategoria (com todas as suas transações) para outra categoria (subcategoriaId, novaCategoriaId) — é como levar só "PIS e COFINS" para "Deduções" sem arrastar o resto de "Impostos". Toda chamada devolve o efeito na DRE dos últimos 12 meses (transações e soma por mês que mudam de papel), calculado sobre o estado anterior à alteração. simular: true calcula e devolve o mesmo efeito sem gravar nada, como prévia do impacto da alteração.alterar_regra
ChatGPTregra.id e regra.enabled.aplicar_patch
ChatGPTold tem de ocorrer exatamente uma vez no HTML-base (trecho que se repete é recusado como ambíguo). Tudo-ou-nada: se alguma falhar, nada é gravado e a resposta diz qual (índice 0-based) e quantas ocorrências achou (0 = não existe, 2+ = ambíguo). A base é a versão de trabalho da consultoria: o último rascunho pendente escrito pela consultoria, se houver, senão a corrente. Proposta do cliente (autorTipo "CLIENTE") não entra como base: ela fica no histórico até um humano publicá-la ou não. O HTML de qualquer versão, inclusive a versão-base, sai de ler_artefato com version; versaoBase na resposta confirma qual versão foi usada. Payload total (old + new) até 1 MB. Em artefato em RASCUNHO a nova versão vira a corrente. Em artefato PUBLICADO ela é gravada como rascunho pendente (rascunhoPendente: true na resposta): o cliente continua vendo a versão atual até um humano publicar a nova no histórico da plataforma. É assim que um artefato já publicado recebe correção sem gerar um segundo artefato. A resposta traz linkNoApp (endereço do artefato na plataforma) e proximoPasso (frase curta de status do que foi gravado, pronta para o usuário). A referência de formato do HTML (identidade visual Alvore, ponte de estado e os modelos checklist, acompanhamento e painel; com o módulo Produtos ligado, também os modelos das telas de lugar) está em ler_guia_artefato.atualizar_contexto_projeto
ChatGPTcontexto de listar_projetos. String vazia apaga o contexto.avaliar_compra_pf
ChatGPTprimeiroMes for anterior ao mês corrente, ou a última parcela passar do horizonte de 36 meses contado a partir do mês corrente, a resposta marca horizonteInsuficiente e cabe = false.classificar_transacao
ChatGPTescopo, propaga a mesma classificação para as outras transações do estabelecimento. escopo: "transacao" grava só esta linha e a trava (a propagação por estabelecimento e a reclassificação em lote passam a pulá-la). escopo: "estabelecimento" aprende uma regra pela identidade da contraparte e reclassifica retroativamente as outras transações do mesmo estabelecimento (exceto as travadas e as de sinal incompatível com a subcategoria). A subcategoria vai em subcategoriaId ou em subcategoriaNome, exatamente um dos dois; os dois juntos, ou nenhum, respondem 400. transacaoId vem de ler_transacoes (modo "linhas", campo id). simular: true não grava nada — devolve a transação-alvo (subcategoria atual → nova, se já está travada) e, em escopo "estabelecimento", uma prévia de quantas outras transações seriam reclassificadas (afetadas), quebra por mês, quantas seriam puladas por trava ou por sinal (puladasPorTrava, puladasPorSinal) e uma amostra de até 20 linhas; serve para medir o alcance de uma propagação por estabelecimento antes de gravá-la. A execução real (sem simular) devolve loteId, o identificador que desfazer_classificacao aceita para reverter esta chamada.criar_artefato
ChatGPTlugar, o artefato é a tela de um lugar do menu de um módulo (ex.: Produtos › Ficha técnica): ele nasce RASCUNHO no projeto de sistema dos módulos, chega como prévia na página do lugar e só passa a valer quando o administrador da empresa ou a consultoria toca em "Usar esta tela" na plataforma. O HTML é um documento completo e autocontido (até 5.000 KB); ele roda em iframe sandbox sem rede. A resposta traz linkNoApp (endereço do artefato na plataforma) e proximoPasso (frase curta de status do que foi gravado, pronta para o usuário). A referência de formato do HTML (identidade visual Alvore, ponte de estado e os modelos checklist, acompanhamento e painel; com o módulo Produtos ligado, também os modelos das telas de lugar) está em ler_guia_artefato.criar_projeto
ChatGPTdesfazer_classificacao
ChatGPTloteId devolvido por classificar_transacao ou por ler_historico_classificacao): reverte cada transação para o estado anterior e, se o lote tinha aprendido/tocado uma regra, desfaz essa ação também ("CREATED" desativa; "UPDATED"/"DISABLED" restaura o estado anterior). Transação alterada depois deste lote, ou que não existe mais, é listada em conflitos (com motivo) e não é revertida; com conflitos não vazio a reversão é parcial, e o lote fica marcado como desfeito mesmo assim (as transações em conflito não voltam mais por este lote). O campo regra vem "desativada", "restaurada", "conflito" (a regra mudou depois do lote e ficou como está) ou null (o lote não tocou regra). simular: true só conta revertidas/conflitos/regra, sem gravar nada. Lote já desfeito responde 409, então a mesma chamada repetida não desfaz duas vezes. Também respondem 409 o lote do par com a caixinha (origem CAIXA) e o desfazer dele, que só a tela Caixa do app reverte, o lote da categoria do título ERP conciliado (origem ERP) e o desfazer dele, que só a própria conciliação reverte, e o lote que tocou a transação de banco de um par ativo com a caixinha, enquanto o par estiver ativo.encerrar_run
ChatGPTiniciar_run com status 'done' ou 'failed' e um resumo de uma frase do que foi feito, exibido no cockpit. A contagem de tokens do modelo e o custo são opcionais e informados por quem chama; o servidor não os mede. Um run já encerrado devolve o estado gravado, sem sobrescrever. Um run aberto com um token OAuth renovado depois pode ser encerrado com o token renovado da mesma conexão (mesmo dono, mesmo aplicativo e mesmo alvo) quando o agente e a empresa informados são os do run.estornar_movimento_estoque
ChatGPTexcluir_plano_contas
ChatGPTnivel: "grupo", grupoId), uma categoria (nivel: "categoria", categoriaId) ou uma subcategoria (nivel: "subcategoria", subcategoriaId), ids de ler_plano_contas. A exclusão é em cascata: o grupo leva as categorias dele e a categoria leva as subcategorias dela. As transações classificadas no que sai voltam a não classificadas (pendentes, fora da DRE até serem classificadas de novo); as regras de categorização e o de-para ERP que apontavam para essas subcategorias são removidos (os títulos do ERP voltam a "a Identificar"). Não há desfazer. Subcategoria com lançamento na caixinha de dinheiro físico é recusada (409): o livro da caixinha só se corrige por estorno. A resposta traz quantos grupos, categorias, subcategorias, transações, regras e de-para ERP foram afetados; simular: true devolve as mesmas contagens sem excluir nada.importar_plano_contas
ChatGPTcodigoExterno (código da classe no ERP, único por empresa) em cada subcategoria. A subcategoria é identificada pelo codigoExterno (sem código, adota a de mesmo nome na categoria); categoria e grupo, pelo nome ou por categoriaId/grupoId para renomear. A ordem das linhas é a ordem da árvore. Entrada: csv (texto com separador ;, colunas grupo, papel, categoria, codigo, subcategoria, sinal, budgetRole, atividade — o cabeçalho casa por prefixo) OU linhas. dePara move as transações de uma subcategoria antiga (subcategoriaId de ler_plano_contas) para a nova (codigoExterno), com histórico desfazível em desfazer_classificacao (o desfazer devolve as transações; regras TENANT e de-para ERP levados junto ficam na conta nova), e leva junto regras TENANT e de-para ERP; transação cujo sinal o destino não aceita, ou casada com a caixinha, fica onde está e é contada. Subcategoria antiga que esvazia é INATIVADA, nunca apagada, e as regras TENANT dela são desligadas; inativarAusentes: true inativa também as ausentes do arquivo sem histórico (com histórico seguem ativas, listadas em mantidasComHistorico). Arquivo com qualquer erro é recusado inteiro, com a lista de erros. Receita financeira (budgetRole *_INCOME) em grupo DESPESA_FINANC é coerente: o "(±) Resultado Financeiro" da DRE soma com sinal. Toda chamada devolve criados, renomeados, inativados e o efeito na DRE dos últimos 12 meses (por mês e por papel), calculado sobre o estado anterior; simular: true devolve o mesmo resultado sem gravar.iniciar_run
ChatGPTencerrar_run), as leituras auditadas, as propostas, os projetos e as versões de artefato feitos com o mesmo token ficam ligados, no cockpit, ao run aberto mais recente desse token. Abrir um run encerra como 'failed' o run ainda aberto do mesmo token e do mesmo agente. Repetir o mesmo clientRequestId devolve o run já criado (replay: true), e o campo status indica se ele ainda está aberto; um run encerrado não é reaberto, e um clientRequestId diferente abre outro run.lancar_movimento_estoque
ChatGPTprodutoId ou codigo, exatamente um); produto arquivado é recusado (422). ENTRADA, SAIDA e SALDO_INICIAL recebem quantidade positiva e o tipo define o sinal. AJUSTE recebe a diferença contada, com sinal e diferente de zero. SALDO_INICIAL só é aceito quando o produto não tem nenhum movimento naquele local. data em YYYY-MM-DD, não posterior a hoje (BRT). O livro é só de acréscimo: esta tool não edita nem apaga movimentos, e a correção de um lançamento é o estorno dele seguido de um novo lançamento. Saldo negativo é aceito e sinalizado em alertas. extras guarda campos livres do lançamento (fornecedor, destino, motivo) e o estorno não os copia.ler_artefato
ChatGPTversion — inclusive o rascunhoPendente de listar_artefatos). Funciona para rascunho e publicado.ler_caixinhas_pf
ChatGPTler_capacidade
ChatGPTler_categorias_pf
ChatGPTler_compromissos_pf
ChatGPTler_conexoes_pf
ChatGPTler_configuracao_servicos
ChatGPTbase: SESSAO, PACOTE, PROJETO ou HORAS), formas de contrato oferecidas no formulário do CRM, regraFaltaPadrao dos contratos novos (CONTA ou NAO_CONTA), duracaoPadraoMin de atendimento sem duração definida, avisoPacoteRestante (pacote acabando quando restar até esse número), diasParado e diasVencendo dos filtros de contrato. version é a versão da configuração; 0 indica empresa sem configuração salva (vale o padrão). propostaPendente traz a sugestão de configuração ainda não conferida na tela, ou null. O catálogo e a equipe estão em ler_servicos e ler_equipe.ler_contexto_empresa
ChatGPTregrasHumanas: até 20 regras de categorização do tenant (padrão → nome da subcategoria), sem filtro de aprovação nem de ativação, o que inclui propostas do agente ainda não revisadas e regras desativadas; para o titular da empresa esse campo não é devolvido. Indicada quando a análise precisa da identidade, do plano de contas, dos fornecedores recorrentes ou das regras de categorização da empresa.ler_contratos_servico
ChatGPTcontratoId, devolve um contrato com itens, saldo e as 20 entregas mais recentes; sem ele, uma página por cursor, do mais recente ao mais antigo. No RECORRENTE o saldo é o do mês corrente (dia de Brasília).ler_dados_bling
ChatGPTsourceId, data, titulo, valor e dados. recurso aceita 'canais_venda', 'vendedores', 'formas_pagamento', 'situacoes', 'pedidos_compra', 'notas_fiscais', 'notas_consumidor', 'notas_servico', 'caixas', 'contas_financeiras', 'propostas', 'contratos', 'ordens_servico', 'produtos_loja', 'anuncios', 'remessas' e 'fornecedores_produto'. Recurso ainda sem dado responde total: 0. Pedidos de venda ficam em ler_pedidos_venda_erp.ler_diagnostico_da_conta
ChatGPTler_dividas_pf
ChatGPTler_equipe
ChatGPTcustoHora só aparece para quem vê custo.ler_estado
ChatGPTler_estoque
ChatGPTdataPosicao). codigo filtra um produto; ausente devolve a base inteira (até limite).ler_estrutura
ChatGPTencontrado: false quando o código não tem nenhuma linha de estrutura no lote — não é o mesmo que "produto sem componentes".ler_eventos
ChatGPTcliente só com dígitos filtra pelo id do cliente no ERP (igualdade exata); outro texto busca no nome do cliente (sem diferenciar maiúsculas nem acentos). periodoDe/periodoAte filtram a data do evento (YYYY-MM-DD, inclusive). status filtra por lista. truncado: true quando há mais eventos do que limite.ler_extrato_sem_lancamento_erp
ChatGPTid (o transactionId de conta_azul:criar_lancamento), data, valor, sentido, tipo ('pagar' ou 'receber'), descrição, contraparte, conta bancária, possivelBaixa (há título em aberto parecido no Conta Azul) e sugestoes de categoria, contato e conta financeira, com sugerido quando a sugestão é única. opcoes lista os ids aceitos na proposta: categorias por tipo, contatos e contas financeiras do Conta Azul. Sai da cópia sincronizada, sem chamar o Conta Azul. desde define o primeiro dia da janela (padrão 90 dias, máximo 365); truncado: true indica transações além do teto de leitura, e semLoteAtivo: true indica que o Conta Azul ainda não sincronizou (sem sugestões nem opções).ler_faturas_cartao_pf
ChatGPTler_ficha_tecnica_alvore
ChatGPTprodutoId ou codigo (exatamente um). ficha: null indica produto sem ficha. Com explodir: true, inclui a necessidade de insumos folha para quantidade (default 1) unidades do produto, até niveis (default 10); explosao: null quando o produto não tem ficha. Cada insumo da explosão traz custoUnitario, custo e origemCusto (padrao = custo padrão do produto; ultima_entrada = última entrada de estoque não estornada; null = sem custo), e a explosão traz custoTotal, custoPorUnidade e insumosSemCusto.ler_financeiro
ChatGPTvisao: "dre" (totais, quebra por classe e por mês, estágios), "indicadores" (DRE mensal + classificação fixo/variável), "visao_geral" (3 números do mês corrente + vencimentos dos próximos 30 dias), "orcamento" (meta × realizado por papel DRE) ou "fluxo_caixa" (DFC: saldo inicial → atividades (operacional/investimento/financiamento, com "a identificar" separado e as transferências internas do grupo já eliminadas) → saldo final, por mês; saldos vêm do saldo informado pelo banco quando há registro (saldoInicialOrigem/saldoFinalOrigem = "banco"; "calculado" = deduzido das transações), e o que as transações não explicam aparece no balde nao_explicado; e atividadesPorSubcategoria, a atividade configurada (ou padrão, quando a subcategoria nunca foi editada) de cada subcategoria que apareceu no período — é assim que o plano de contas expõe a atividade de fluxo de caixa no MCP. Consolidado do grupo (todas as contas da empresa, inclusive a de caixa de dinheiro físico quando houver), sem recorte por CNPJ. Todo valor monetário de fluxo_caixa é em centavos inteiros). meses: lista "YYYY-MM" (1 a 12); ausente = mês corrente. visao_geral é sempre do mês corrente (o mês pedido só é conferido, e observacao aparece quando difere). orcamento é mono-mês e usa o mês mais antigo da lista. dre, indicadores e fluxo_caixa aceitam vários meses; em dre e indicadores, se nenhum mês pedido tiver dado, a resposta traz todos os meses disponíveis (mesesSolicitados × selectedMonths mostra a diferença).ler_guia_artefato
ChatGPTlugar de criar_artefato); com o CRM ligado, os dados do CRM e o modelo contrato; com o módulo Serviços ligado, os dados de Serviços e os modelos contratos_servico, catalogo_servicos e equipe_servicos, que são também as telas dos lugares do menu Serviços. Serve para montar o HTML enviado a criar_artefato, nova_versao ou aplicar_patch. Sem tipo, devolve a referência geral e a lista de modelos. Não devolve o conteúdo de artefatos existentes (esse é o papel de ler_artefato).ler_historico_classificacao
ChatGPTactorUserId), subcategoria nova (subcategoryIdNova), regra aprendida e a ação nela (ruleId, ruleAction, se houve) e se já foi desfeito. Com transacaoId, lista só as mudanças daquela transação, uma por lote que a tocou. loteId é o identificador aceito por desfazer_classificacao. desfazivel é false para lote já desfeito, para lote do par com a caixinha (origem CAIXA) e o desfazer dele, que só a tela Caixa do app desfaz, e para lote da categoria do título ERP conciliado (origem ERP) e o desfazer dele, que só a própria conciliação desfaz; lote com desfazivel: true que tocou a transação de banco de um par ativo com a caixinha ainda responde 409 em desfazer_classificacao.ler_historico_pf
ChatGPTler_liberdade_financeira_pf
ChatGPTler_modelos_contrato
ChatGPTformato traz a sintaxe do texto, os limites e a lista fixa de variáveis aceitas. Com modeloId ou propostaId, inclui o texto daquele item. Modelo arquivado não aparece.ler_movimentos_estoque
ChatGPTcursor. Aceita filtro por produto (produtoId ou codigo) e por período (de/ate, YYYY-MM-DD). estornado: true indica que já existe um estorno apontando para o movimento.ler_opcoes_baixa_erp
ChatGPTcontasCorrentes e formasPagamento, ids de contaCorrenteId/formaPagamentoId; integracaoBancaria: true indica a conta que o ERP usa para remessa bancária) e 'omie' (devolve só contasCorrentes, cujo id é o contaCorrenteId de omie:baixar_conta_pagar e omie:incluir_conta_pagar; inativa: true é recusada na execução).ler_orcamento_pf
ChatGPTmes: "YYYY-MM"; ausente = mês corrente.ler_ordens_compra
ChatGPTid: lista paginada por cursor, do mais recente ao mais antigo, com filtro por status, fornecedor (parte do nome) e busca (número do pedido, fornecedor ou código/descrição de produto de algum item); cada pedido traz totalItens e valorEstimado (soma de quantidade × preço combinado dos itens com preço, ou null). Com id: o pedido com itens (produto, quantidade na unidade do produto e custoUnitario combinado) e a version usada na edição.ler_ordens_producao
ChatGPTid: lista paginada por cursor, da mais recente à mais antiga, com filtro por status e produtoId. Com id: o detalhe de uma ordem, com movimentos (as linhas do livro de estoque ligadas a ela) e, quando PLANEJADA, consumoPrevisto: as matérias-primas que iniciar vai baixar (a ficha gravada na ordem, descendo pelas fichas vigentes dos semiacabados, sem os itens que não controlam estoque), cada uma com quantidade, saldo atual somado de todos os locais e falta (o que passa do saldo). Fora de PLANEJADA, consumoPrevisto vem vazio e o consumo real está em movimentos.ler_parcelas_pf
ChatGPTler_patrimonio_pf
ChatGPTler_pedidos_venda_erp
ChatGPTtotal de pedidos, somas por situação e por loja, e cada pedido com número, data, cliente, situação, loja, total, itens, parcelas e frete. Itens e parcelas chegam em rodadas: temDetalhe: false indica pedido ainda sem eles, e semDetalhe conta esses pedidos no período. As somas incluem todas as situações, inclusive cancelados. Situação e vendedor vêm com id e nome (situacaoNome, vendedorNome, nulos quando o cadastro ainda não sincronizou); a loja vem só como id. Sem período, usa o mês corrente.ler_plano_contas
ChatGPTgrupoId, categoriaId, novoGrupoId, subcategoriaId, novaCategoriaId) e o subcategoriaId aceito por classificar_transacao.ler_produtos
ChatGPTcodigo filtra por igualdade exata; busca casa código ou descrição (os dois podem coexistir).ler_produtos_alvore
ChatGPTcursor. busca casa código ou descrição; tipo filtra pelo tipo do cadastro nativo. Com incluirErp: true, e só quando a empresa tem a trilha de estoque do ERP liberada, a primeira página (sem cursor e sem tipo) inclui também os produtos da cópia do ERP ainda não importados, com origem: "erp"; os nativos vêm com origem: "nativo". O campo erpIncluido da resposta indica se a junção ocorreu.ler_propostas
ChatGPTtotal e até limite itens; cada item traz ultimaExecucao ({id, status, errorMessage}, ou null se a proposta nunca foi executada). Serve para acompanhar o andamento de propostas já criadas.ler_regras
ChatGPTorigin: "GLOBAL") e as regras aprendidas da própria empresa (origin: "TENANT"). Regras desativadas não aparecem nesta lista. Regra por documento (CPF/CNPJ) não expõe o documento: o rótulo é o nome da contraparte ou um texto genérico. Nas demais regras, o rótulo é a descrição limpa de uma transação representativa ou, na falta dela, o próprio padrão de texto.ler_saldo_estoque_alvore
ChatGPTemData, devolve o saldo atual; com emData (YYYY-MM-DD), a soma do livro até aquele dia. Aceita filtro por produtoIds ou por busca (código/descrição) e por local. O saldo pode ser negativo, quando uma saída foi lançada antes da entrada correspondente. Cada linha traz estoqueMinimo do produto (null = sem mínimo), controlaEstoque e abaixoDoMinimo (true quando o produto controla estoque, tem mínimo e o saldo somado de todos os locais é menor que ele).ler_servicos
ChatGPTcursor; busca casa parte do código ou do nome. Com servicoId, devolve um serviço com o roteiro vigente (etapas e insumos), as horas previstas e, para quem vê custo, custo das horas, custo dos insumos e margem.ler_sugestao_compra
ChatGPTestoqueMinimo. Para cada um, projetado = saldo (todos os locais) − necessidadeOps (o que as ordens de produção PLANEJADAS vão baixar dele ao iniciar, descendo pelas fichas até as matérias-primas) + emPedidos (itens de pedidos de compra em RASCUNHO ou ENVIADA). Só aparece quem fica abaixo do mínimo; sugerido é a diferença, arredondada para cima no múltiplo de fatorEmbalagem quando o produto tem fator (com sugeridoEmbalagens). fornecedor é o primeiro fornecedor preferido do produto. Itens ordenados por fornecedor e descrição; fornecedores resume quantos itens há por fornecedor.ler_tarefas_pf
ChatGPTler_titulos_em_aberto_erp
ChatGPTtitleSourceId, parcelaId, vencimento, valor, valor em aberto, status, contraparte e descrição; total conta todas as parcelas em aberto. titleSourceId/parcelaId são os identificadores aceitos numa proposta de baixa. kind padrão: 'payable' (a pagar). No Omie só há contas a pagar, e o título é a própria parcela (parcelaId = titleSourceId).ler_transacoes
ChatGPTmes. modo: "agregado" (default) devolve quantidade e total por categoria/papel mais os totais do mês, sem nenhuma linha. modo: "linhas" devolve linhas individuais (data desc, empate por id); nesse modo limite (1 a 200) é obrigatório e a paginação é por offset (default 0). A resposta traz total (após filtros), offset, devolvidas, truncado e proximoOffset (null quando não há mais linhas). Cada linha traz id (identificador da transação), subcategoriaId (id numérico da subcategoria, ou null) e travada (se a linha está travada contra reclassificação). O campo de documento (CPF/CNPJ) da contraparte não é devolvido, e CPF/CNPJ pontuado é removido da descrição. Filtros opcionais (valem nos dois modos, aplicados sobre o mês lido): conta (contém, sem acento/caixa, no nome da conta), subcategoriaId, categoria (nome exato da subcategoria, sem acento/caixa), semCategoria (só linhas sem subcategoria) e travada.ler_transacoes_pf
ChatGPTmes "YYYY-MM"; ausente = mês corrente) ou num intervalo de até 366 dias (de e ate "YYYY-MM-DD", no lugar de mes), com filtros opcionais por texto, categoria, valor e sentido. modo: "agregado" (default) devolve quantidade e total por categoria/papel e os totais do período (os mesmos da tela do app, sem filtro; com filtro, a soma das linhas que casaram), sem linhas individuais. modo: "linhas" devolve linhas individuais em ordem de data decrescente, pagina por offset e exige limite (1 a 200); a resposta informa quantas linhas existem e se houve corte. O campo de documento da contraparte (CPF/CNPJ) não é devolvido nem pesquisado. Nos textos, CPF completo (11 dígitos, com ou sem pontuação) é removido; CNPJ e documentos parcialmente mascarados pelo banco podem aparecer na descrição ou no nome da contraparte.ler_visao_geral_pf
ChatGPTlistar_artefatos
ChatGPTrascunhoPendente ({version, nota, createdAt, autorTipo}, ou null) — a versão gravada por nova_versao/aplicar_patch num artefato publicado que ainda espera o clique humano; autorTipo: "CLIENTE" indica proposta enviada pelo titular da empresa, não rascunho da consultoria. lugar ({id: "<MODULO>/<lugar>", estado: previa | em_uso | guardada}, ou null para artefato avulso) marca a tela de um lugar do menu de um módulo. O parâmetro opcional projectId restringe a lista a um projeto.listar_clientes
ChatGPTlistar_conexoes_erp
ChatGPTlistar_empresas
ChatGPTlistar_projetos
ChatGPTorigem ("CONSULTORIA" ou "CLIENTE", o espaço que o próprio cliente criou) e contexto: o briefing do engajamento em texto livre, escrito pela consultoria (objetivo, combinados com o cliente, o que evitar).nova_versao
ChatGPTlugar, quando informado, confere que o artefato é a tela daquele lugar. Esta tool recebe o documento inteiro; aplicar_patch grava uma versão enviando só os trechos alterados, sem reenviar um HTML grande. A resposta traz linkNoApp (endereço do artefato na plataforma) e proximoPasso (frase curta de status do que foi gravado, pronta para o usuário). A referência de formato do HTML (identidade visual Alvore, ponte de estado e os modelos checklist, acompanhamento e painel; com o módulo Produtos ligado, também os modelos das telas de lugar) está em ler_guia_artefato.propor_acao_erp
ChatGPTkind e titleSourceId juntos (400 se vier só um), mais parcelaId quando o ERP separa parcela, com os valores listados por ler_titulos_em_aberto_erp; no payload, beneficiario, valor, data (AAAA-MM-DD), conta (texto), contaCorrenteId e formaPagamentoId. Esses dois últimos são ids numéricos cadastrados no ERP, os mesmos listados por ler_opcoes_baixa_erp, e não são conferidos contra o ERP quando a proposta é criada. buffetmax:criar_orcamento propõe um orçamento novo para um cliente já cadastrado no BuffetMax: targetRef = idCliente e payload {idCliente, clienteNome?, dataEvento 'YYYY-MM-DD' (não retroativa), horarioInicio 'HH:MM', duracaoMinutos?, evento, convidados {adultos, criancas}, idLocal?, idTipoEvento?, idVendedor?, idPacotes? [ids], itens? [{idItem, idGrupo, qtd}], escolhasPacote? [idItem], obsExterna?, valorTotal (R$)} — é preciso ao menos idPacotes ou itens; ids são strings só de dígitos; chave desconhecida é recusada. conta_azul:criar_lancamento registra no Conta Azul, já quitado na conta financeira, um movimento do extrato bancário da empresa que não tem título lá: payload {transactionId, categoriaId?, contatoId?, contaFinanceiraId?}, os três ids sendo UUIDs do Conta Azul, e nenhuma outra chave é aceita. O valor, a data, o sentido (a pagar ou a receber) e a descrição do lançamento vêm da transação, não do payload, e o alvo da proposta é a própria transação (targetRef = tx:<transactionId>, sem kind/titleSourceId). Id ausente é preenchido pela sugestão do servidor quando ela é única; contraparte sem cadastro no Conta Azul, escolha ambígua ou id fora da cópia sincronizada são recusados (422) com a lista de candidatos (id e nome) na mensagem; uma transação tem no máximo uma proposta ativa (409). Sem desfazer pelo conector nem pelo cockpit depois de executadas: lote_mobile:baixa, buffetmax:criar_orcamento, omie:incluir_estrutura, omie:incluir_produto e omie:ajuste_estoque. A resposta traz proposalId e status, e a proposta criada aparece na listagem de ler_propostas.propor_configuracao_produtos
ChatGPTlugares, a lista inteira; estoque fica sempre e ordem_producao liga ficha_tecnica junto), prévias de tela de lugar que passam a valer (telas: artefato criado com criar_artefato e o parâmetro lugar, ainda em prévia; aba entra como aba nova no fim, substituir guarda as telas em uso do lugar) e nomes novos de telas de lugar (renomear). Com a proposta gravada, nada do que está em uso muda: ela fica pendente até um administrador conferir em Produtos › Configurar, mudança por mudança, e usar ou descartar. Cada empresa tem uma proposta pendente por vez; gravar outra substitui a anterior. Lugar desconhecido, artefato que não é prévia de lugar de Produtos desta empresa ou formato inválido não grava nada e responde 422 com os campos a corrigir. Só quem administra a empresa grava a proposta.propor_configuracao_servicos
ChatGPTbase e modelo, no formato de ler_configuracao_servicos, só os campos que mudam), serviços do catálogo (por codigo: código novo cria, existente edita os campos enviados) e pessoas da equipe (por id, ou pelo nome quando ele já existe na equipe; senão, pessoa nova). Com a proposta gravada, nada do que está em uso muda: ela fica pendente até um administrador conferir na tela, mudança por mudança, e usar ou descartar. Cada empresa tem uma proposta pendente por vez; gravar outra substitui a anterior. ativo: false tira do catálogo ou da equipe (nada é apagado). Custo, roteiro e ausências não fazem parte da proposta. Formato inválido não grava nada e responde 422 com os campos a corrigir. salvar_servico e salvar_profissional continuam gravando direto, sem proposta. Só quem administra a empresa grava a proposta.propor_modelo_contrato
ChatGPTmodeloId, a sugestão é uma nova versão desse modelo; sem ele, um modelo novo. Uma sugestão pendente por modelo (ou por nome, no modelo novo); gravar de novo substitui a anterior. Até 10 pendentes por empresa. O texto segue o formato de ler_modelos_contrato; variável fora da lista, chaves abertas ou variável de bloco fora de linha própria respondem 422 com linha, coluna e as variáveis válidas do grupo, e nada é gravado. Emitir documento, registrar aditivo, anexar e estornar não existem no conector. Só quem administra a empresa grava a sugestão.salvar_contrato_servico
ChatGPTid: cria em RASCUNHO (clienteId, forma, itens, inicio e clientRequestId obrigatórios; PROJETO exige fim). Com id + version (de ler_contratos_servico ou do atual de um 409): edita um contrato em RASCUNHO ou ATIVO; cliente e forma não mudam; itens substitui a lista inteira; version diferente da gravada responde 409 com o contrato atual. Com id + acao + clientRequestId: ativar, pausar, retomar, concluir ou cancelar; transição fora do caminho responde 409.salvar_ficha_tecnica
ChatGPTprodutoId ou codigo, exatamente um) e a torna a vigente. A versão anterior deixa de ser vigente e fica no histórico, sem ser apagada (este conector lê só a vigente). Cada item traz componenteId ou componenteCodigo (exatamente um) e quantidade > 0. Recusa componente repetido, o próprio produto como componente e ciclo entre fichas.salvar_ordem_compra
ChatGPTid: cria em RASCUNHO (fornecedorNome e itens obrigatórios, clientRequestId obrigatório); a numeração é sequencial por empresa; produto arquivado ou repetido no mesmo pedido é recusado (422). Com id + version (de ler_ordens_compra ou do atual de um 409): edita um pedido em RASCUNHO; cada campo enviado substitui o anterior e itens substitui a lista inteira; null em dataPrevista ou observacao limpa o campo. Pedido fora de RASCUNHO ou version diferente da gravada: nada é gravado e a resposta é 409 com o pedido atual. Na edição a proteção contra gravação em dobro é a version.salvar_ordem_producao
ChatGPTprodutoId ou codigo, exatamente um) com ficha técnica vigente; produto sem ficha ou arquivado é recusado (422). A ordem guarda a versão da ficha vigente neste momento, e uma ficha salva depois não muda o que ela consome. Criar não movimenta o estoque: a baixa acontece ao iniciar, por transicionar_ordem_producao. A numeração é sequencial por empresa. Não há edição nem exclusão de ordem; uma ordem errada é cancelada.salvar_produto
ChatGPTid: cria (codigo e descricao obrigatórios). Com id + version (de ler_produtos_alvore ou do atual de um 409): atualiza só os campos enviados. Cada campo enviado substitui o valor anterior, exceto extras, que é mesclado por chave. Se a version enviada não for a gravada, inclusive quando a mesma atualização é repetida, nada é gravado e a resposta é 409 com o produto atual, que traz a version vigente. estoqueMinimo é o mínimo na unidade do produto (na atualização, null remove o mínimo) e controlaEstoque: false marca o item sem saldo controlado, que fica fora de abaixoDoMinimo. Na atualização, a proteção contra gravação em dobro é a version, e clientRequestId não é usado. ativo: false arquiva e true reativa. Nenhum produto é apagado: a remoção é o arquivamento, reversível.salvar_profissional
ChatGPTid: cria (clientRequestId obrigatório). Com id + version (de ler_equipe ou do atual de um 409): edita; version diferente da gravada responde 409 com o profissional atual e nada é gravado. grade e ausencias enviadas substituem as listas inteiras.salvar_servico
ChatGPTid: cria (clientRequestId obrigatório). Com id + version (de ler_servicos ou do atual de um 409): edita; version diferente da gravada responde 409 com o serviço atual e nada é gravado. entrega diz como o serviço é consumido: SESSAO, ETAPAS ou HORAS. roteiro enviado grava uma versão nova do roteiro (etapas com horas previstas e insumos do estoque); a anterior fica no histórico.vincular_cobranca_servico
ChatGPTrepetido: true). Contrato com mais de um serviço exige servicoId. Título de outro cliente, título cancelado e entrega estornada ou cancelada respondem 422. Só quem administra a empresa (consultoria ou ADMIN) liga cobrança.alterar_plano_contas
Claudealterar_regra
Claudeaplicar_patch
Claudeatualizar_contexto_projeto
Claudeavaliar_compra_pf
Claudeclassificar_transacao
Claudecriar_artefato
Claudecriar_projeto
Claudedesfazer_classificacao
Claudeencerrar_run
Claudeestornar_movimento_estoque
Claudeiniciar_run
Claudelancar_movimento_estoque
Claudeler_artefato
Claudeler_contexto_empresa
Claudeler_estado
Claudeler_estoque
Claudeler_estrutura
Claudeler_eventos
Claudeler_ficha_tecnica_alvore
Claudeler_financeiro
Claudeler_guia_artefato
Claudeler_historico_classificacao
Claudeler_movimentos_estoque
Claudeler_opcoes_baixa_erp
Claudeler_orcamento_pf
Claudeler_plano_contas
Claudeler_produtos
Claudeler_produtos_alvore
Claudeler_propostas
Claudeler_regras
Claudeler_saldo_estoque_alvore
Claudeler_titulos_em_aberto_erp
Claudeler_transacoes
Claudeler_transacoes_pf
Claudeler_visao_geral_pf
Claudelistar_artefatos
Claudelistar_clientes
Claudelistar_conexoes_erp
Claudelistar_empresas
Claudelistar_projetos
Claudenova_versao
Claudepropor_acao_erp
Claudesalvar_ficha_tecnica
Claudesalvar_produto
ClaudeLinks
Similar Apps
Listed on MCP App Store
Add this badge to your site or README. It links to this page.
HTML
<a href="https://mcp-app-store.keenethics-labs.com/app/alvore-finance"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>
Markdown
[](https://mcp-app-store.keenethics-labs.com/app/alvore-finance)






