O MCP da Conta Azul conecta a sua conta ao Claude. Depois de conectar, você conversa com o Claude em linguagem natural, e ele consulta e registra informações na sua Conta Azul: contas a pagar e a receber, vendas, clientes, produtos, notas fiscais e contratos.
- Uma conta na Conta Azul, com acesso à empresa que você quer conectar.
- Uma conta no Claude: claude.ai, Claude Desktop, aplicativo de celular, Cowork ou Claude Code.
- Nos planos Team e Enterprise do Claude, o owner da organização pode precisar habilitar o conector antes. Depois disso, cada pessoa conecta a própria conta Conta Azul.
- No Claude, abra Configurações → Conectores, procure os conectores disponíveis e busque Conta Azul.
- Clique em Conectar.
Não precisa de liberação nem de cadastro no Portal do Desenvolvedor.
Entre no Claude Code com a mesma conta do Claude em que você conectou a Conta Azul. Os conectores do claude.ai aparecem no Claude Code: rode /mcp e confira se o Conta Azul está na lista.
- Ao clicar em Conectar, o Claude abre a tela de login da Conta Azul.
- Faça login com a conta Conta Azul da empresa que você quer conectar.
- Na tela Permissão de acesso para uma ferramenta de IA, confira a linha Depois de autorizar, você volta para claude.ai. Se aparecer outro endereço, clique em Negar acesso.
- Clique em Autorizar acesso. O Claude volta para a conversa e já pode usar as ferramentas da Conta Azul.
A conexão vale para a empresa que você autorizou e para a sua conta do Claude em todos os lugares (claude.ai, Desktop, celular, Cowork e Claude Code), sem novo login. O acesso é renovado automaticamente.
Para usar outra empresa, conecte de novo com o login dessa empresa.
O conector traz ferramentas de consulta (buscas e listagens) e ferramentas de gravação (criar vendas, pessoas, produtos, eventos financeiros, baixas, cobranças etc.). Nenhuma ferramenta exclui registros. Recomendamos deixar as ferramentas de gravação em Requer aprovação nas configurações do conector, para o Claude pedir confirmação antes de alterar dados.
Desconectar no Claude. Em Configurações → Conectores, desconecte ou remova o conector da Conta Azul. O Claude deixa de usar a conexão, mas a autorização continua registrada na Conta Azul até ser revogada.
Revogar na Conta Azul. A revogação encerra a autorização da ferramenta de IA naquela empresa. Você pode pedir a revogação:
- pelo chat do Portal do Desenvolvedor ou pelo e-mail api@contaazul.com (recomendado);
- pelos canais de atendimento da Conta Azul.
No pedido, informe o CNPJ da empresa e que a conexão foi feita pelo Claude.
Depois da revogação:
- o Claude não consegue mais renovar o acesso;
- o acesso já liberado continua válido por até 1 hora;
- para voltar a usar, é preciso conectar de novo e autorizar o acesso outra vez (passo 2).
Se você desenvolve uma integração, atende várias empresas ou quer usar o MCP fora do diretório do Claude (outro cliente MCP, um agente próprio ou o Claude Code sem conta do Claude), use um app próprio:
- No Portal do Desenvolvedor, crie uma aplicação de produção com a URL de redirecionamento do seu cliente MCP. Para o claude.ai, use
https://claude.ai/api/mcp/auth_callback. - Peça a liberação do app para o MCP pelo chat do Portal ou por api@contaazul.com, informando o client ID. A liberação leva até 5 minutos para valer.
- No claude.ai, adicione um conector personalizado com a URL
https://api-v2.contaazul.com/mcpe, em Configurações avançadas, informe o client ID e o client secret do app.
Só com a URL, sem client ID e client secret, a conexão não funciona: o MCP da Conta Azul só aceita apps cadastrados.
| O que aparece | Causa provável | O que fazer |
|---|---|---|
| Este app não está liberado para usar o MCP da Conta Azul | Você conectou por um conector personalizado ou outro cliente, sem um app liberado | No Claude, use o conector do diretório. Para outros clientes, veja Para desenvolvedores e parceiros |
| Erro ao conectar um conector personalizado só com a URL | O MCP só aceita apps cadastrados | Use o conector do diretório ou informe o client ID e o client secret do seu app em Configurações avançadas |
| App liberado, mas o erro continua ou alterna | A liberação leva até 5 minutos | Aguarde e tente de novo |
| O Claude diz só que houve um problema de conexão | Às vezes o Claude não mostra a mensagem de erro | Tente conectar de novo. Se continuar, fale com api@contaazul.com |
| O conector não aparece para adicionar | Plano Team ou Enterprise do Claude | Peça ao owner da organização para habilitar o conector |
| O Conta Azul não aparece no Claude Code | Você entrou com outra conta, ou existe outro servidor com a mesma URL | Entre com a conta do Claude em que conectou. Remova servidores duplicados com claude mcp remove <nome> |
Para entender o que o MCP faz com os seus dados, o que ele não pode fazer e como a sua conta é protegida, veja o material O que é MCP. O mesmo link aparece na tela de autorização da Conta Azul.
O uso do MCP da Conta Azul segue os Termos de Uso do Portal do Desenvolvedor e a Política de Privacidade da Conta Azul.
Dúvidas, liberações de app e pedidos de revogação: chat do Portal do Desenvolvedor ou api@contaazul.com.