Conector MCP — Alvore Finance

O que é

Ligado o conector, você pergunta o seu financeiro direto no assistente que já usa — sem abrir a plataforma, sem exportar planilha. O consultor publica artefatos pelo mesmo caminho. Você continua vendo só o que já vê hoje: o conector não amplia o seu acesso.

Endereço do conector, o mesmo em todos os programas:

https://app.alvore.com.br/api/mcp

Qual caminho é o seu

São dois caminhos. A diferença é de onde vem a autorização, não de dificuldade.

No Gemini, o conector fica fora do menu de conectores: é em Configurações, Apps conectados, Custom apps for Spark. Exige conta pessoal do Google e o histórico de atividade ligado.

Caminho 1 — conector por URL (Claude, ChatGPT, Gemini)

Não gere token nenhum. O programa abre o login da Alvore e você autoriza na tela.

1. Abra as Configurações do aplicativo e vá em Conectores.
2. Escolha adicionar conector personalizado — é a opção de colar um endereço. O nome exato do botão muda de versão para versão.
3. Cole https://app.alvore.com.br/api/mcp.
4. Deixe Client ID e Client Secret em branco. O cadastro é automático.
5. O programa abre a tela da Alvore. Entre com a sua conta de sempre.
6. Confira os acessos listados e confirme.

No ChatGPT é mais curto: o Alvore Finance está no diretório de aplicativos. Abra a página do app no ChatGPT, clique em Conectar e siga do passo 5. Não precisa de modo desenvolvedor nem de colar endereço. Em conta Enterprise ou Edu, o administrador precisa liberar o app antes.

No Gemini o passo 1 muda: Configurações, Apps conectados, Custom apps for Spark. Do passo 3 em diante é igual.

Caminho 2 — arquivo de configuração (Cursor, Claude Code, Gemini CLI)

Aqui você gera um token e cola num arquivo.

1. Abra a tela de tokens: /empresa/conector se você é o titular da empresa, /consultor/configuracoes?tab=conector se você é consultor. Clique Gerar token.
2. Marque o que o programa vai poder ler (a lista está na seção seguinte).
3. Copie o token. Ele aparece uma vez só — guardamos apenas uma impressão digital dele, não o token.
4. Clique Copiar config do Cursor e cole o bloco no arquivo de configuração do seu programa.
5. Reinicie o programa.

O bloco tem esta forma:

{
  "mcpServers": {
    "alvore": {
      "url": "https://app.alvore.com.br/api/mcp",
      "headers": { "Authorization": "Bearer alv_pat_..." }
    }
  }
}

Não preencha Client ID neste caminho. Token e Client ID juntos quebram a conexão: o programa tenta o login e ignora o token.

Prefere pedir ao próprio assistente

Cole o texto abaixo no seu assistente, com o token no lugar indicado. Funciona só no Caminho 2 — no Claude e no ChatGPT a conexão é por clique na tela, e nenhum texto colado no chat instala conector.

Configure o servidor MCP "alvore" no meu arquivo de configuração local.
URL: https://app.alvore.com.br/api/mcp
Autenticação: header Authorization: Bearer <COLE_SEU_TOKEN_AQUI>
Não configure Client ID nem OAuth — este servidor usa token direto.
Depois, reinicie e liste as ferramentas disponíveis para confirmar.

O que o conector enxerga

O token diz quem você é; o que pode ser lido vem dos acessos marcados. Cada um é independente — negar o financeiro não derruba a publicação de artefato.

Token de empresa aceita só projetos:read e financeiro:read. pf:read é separado de propósito: reusar o acesso da empresa daria acesso a dado de pessoa física, retroativamente, a todo token já emitido.

Segurança, auditoria e revogação

• Toda leitura financeira é registrada em ConsultorApiAccessLog antes de o dado sair.
• Caminho 1 (login pelo programa): o acesso expira em 8 horas e o programa o renova sozinho.
• Caminho 2 (token gerado por você): vale 90 dias por padrão.
• Para encerrar: apague o token na tela onde o gerou, ou desconecte o conector dentro do programa.

Quando dá errado