Conector MCP — Alvore Finance

O que é

O conector MCP é a API que o Cursor, o Claude e outros hosts usam para ler o financeiro e publicar artefatos da consultoria Alvore — sem abrir o navegador da plataforma. Você cola só a URL abaixo (ou clica o card na biblioteca). O host abre o login da Alvore (OAuth); não há Client ID para preencher à mão.

URL do conector: https://app.alvore.com.br/api/mcp

Escopos

O token autentica quem você é; o que o host pode ler ou escrever vem dos escopos marcados no consentimento. Cada escopo é independente — negar o financeiro não derruba a publicação de artefato, e o dado de pessoa física não reusa o escopo da empresa.

• projetos:write — publicar artefatos (e ler projeto junto). Default de um token novo de consultor.
• projetos:read — ler projetos e artefatos, sem escrever.
• financeiro:read — ler o financeiro da empresa (DRE, transações agregadas).
• pf:read — ler a carteira de pessoa física do consultor. Escopo separado de propósito: reusar o da empresa daria acesso PF retroativo a todo token já emitido.

Auditoria e revogação

Toda leitura financeira passa por auditoria: gravamos em ConsultorApiAccessLog antes de devolver o dado. Para encerrar o acesso, apague o token correspondente (Configurações do consultor ou a tela Conector da empresa) ou desconecte o host no aplicativo dele.