Conectar o Claude ao Hub Contador

O Hub Contador expõe um servidor MCP (Model Context Protocol), o padrão aberto que assistentes de IA usam para acessar ferramentas de outros sistemas. Com o conector, você pergunta ao Claude coisas como "quantas NFS-e a Padaria Central emitiu em outubro?", "manda o boleto em aberto da empresa X" ou "aceite as sugestões da conciliação acima de 90% de confiança", e ele consulta o Hub em seu nome.

Tudo o que o Claude enxerga é limitado ao seu usuário, à sua contabilidade e às permissões que você conceder. Ações que alteram dados nunca acontecem sem a sua confirmação.

• Uma conta no Hub Contador em uma contabilidade com o recurso "Liberar MCP para esta contabilidade" ativado (um gestor liga isso em Configurações de IA).
• Um plano pago do Claude (Pro, Max, Team ou Enterprise) para usar conectores no claude.ai e no Claude Desktop.
• Para Claude Code, Cursor e outros clientes MCP por linha de comando, uma chave de acesso gerada no Hub.

Pelo diretório de conectores (quando o Hub Contador estiver listado): abra Configurações, Conectores, procure "Hub Contador" e clique em Conectar. Você será levado à tela de autorização do Hub.

Como conector personalizado (funciona hoje):

1. No Claude, abra Configurações e depois Conectores.
2. Clique em Adicionar conector personalizado.
3. Em URL do servidor, cole https://api.hubcontador.com.br/api/mcp e salve.
4. Clique em Conectar. O Claude abre a tela de autorização do Hub Contador no navegador.
5. Entre com o seu usuário do Hub, se ainda não estiver logado, escolha as permissões e clique em Autorizar.
6. Volte ao Claude. O conector aparece como conectado e as ferramentas do Hub ficam disponíveis na conversa.

A autenticação usa OAuth 2.1 com PKCE. O Claude nunca recebe a sua senha do Hub, e o Hub nunca recebe a sua senha do Claude.

1. No Hub, abra Configurações de IA e localize o card Conectar IA externa (MCP).
2. Em Chaves de acesso, dê um nome (ex.: "Claude Code"), escolha as permissões e clique em Gerar chave.
3. Copie a chave. Ela é exibida uma única vez.

No Claude Code:

claude mcp add --transport http hubcontador https://api.hubcontador.com.br/api/mcp \
  --header "Authorization: Bearer hcmcp_SUA_CHAVE"

Em clientes que leem um arquivo de configuração (Cursor, Claude Desktop manual, .mcp.json):

{
  "mcpServers": {
    "hubcontador": {
      "type": "http",
      "url": "https://api.hubcontador.com.br/api/mcp",
      "headers": { "Authorization": "Bearer hcmcp_SUA_CHAVE" }
    }
  }
}

A chave herda o seu perfil e as suas empresas. Ela deixa de funcionar se for revogada, se expirar, se o seu usuário for desativado ou se a contabilidade desligar o recurso.

Na autorização ou ao gerar a chave, você escolhe o que o assistente pode ver e fazer. Marque só o necessário. Um escopo nunca amplia o que o seu perfil já permite no Hub: um usuário do portal do cliente, por exemplo, só consegue leituras da própria empresa.

O Claude também recebe receitas prontas (prompts) como conciliar mês, cobrar inadimplentes, licenças a vencer e enviar orçamento, que encadeiam várias ferramentas num passo a passo.

Leituras são executadas na hora. Ações que alteram dados seguem sempre dois passos:

1. O Claude chama a ferramenta da ação. O Hub não grava nada: valida os dados, monta um resumo legível (ex.: "Classificar 12 lançamentos, total de R$ 3.450,00, na conta 4.1.02 Energia") e devolve um token de uso único válido por cerca de 5 minutos.
2. O Claude mostra o resumo e pede a sua aprovação. Só depois chama confirm_action com o token, e aí a ação acontece.

Cada ação executada fica registrada em auditoria com usuário, data, origem e resultado. Ações como rejeitar lançamentos são marcadas como destrutivas para o Claude pedir uma confirmação extra.

• Isolamento total por contabilidade e por perfil: o assistente nunca vê outra contabilidade nem mais do que você.
• As ferramentas devolvem o mínimo necessário: nomes, status, valores, datas e links. CNPJ e CPF saem mascarados. Nenhum arquivo, senha ou dado bancário completo é devolvido.
• Tokens e chaves são armazenados apenas como hash, expiram e podem ser revogados a qualquer momento.
• Limites diários de chamadas por credencial protegem contra uso abusivo.
• Os dados devolvidos ao Claude passam a ser tratados pela Anthropic conforme o seu plano e a política dela. Veja a nossa Política de Privacidade.

• No Hub: Configurações de IA, card Conectar IA externa, em Aplicativos conectados (OAuth) ou Chaves de acesso (API key), clique em desconectar ou revogar.
• No Claude: Configurações, Conectores, remova o Hub Contador.
• Gestores podem desligar o recurso para toda a contabilidade, o que revoga todas as conexões de uma vez.

O Claude consegue apagar dados? Não. Não há ferramentas de exclusão. As ações disponíveis criam, concluem, classificam, rejeitam (reversível na tela) ou anotam, sempre com confirmação.

Posso dar acesso só de leitura? Sim. Marque apenas os escopos de leitura (ai:read, reconciliation:read, billing:read etc.). Nenhuma ferramenta de ação aparecerá.

Conectei antes e não vejo as ferramentas novas. Permissões novas (como ver conciliação) não entram em conexões antigas. Desconecte e conecte de novo, ou gere outra chave marcando o escopo.

Funciona para clientes do portal? Sim, em modo leitura e restrito à própria empresa, desde que a contabilidade tenha liberado o recurso.

Dúvidas ou problemas na conexão: escreva para miguel@attualizetech.com.br informando a contabilidade, o cliente usado (claude.ai, Desktop, Claude Code) e a mensagem exibida.