{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Conectar a Conta Azul ao Claude"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"conectar-a-conta-azul-ao-claude","__idx":0},"children":["Conectar a Conta Azul ao Claude"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"o-que-você-precisa","__idx":1},"children":["O que você precisa"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Uma conta na Conta Azul, com acesso à empresa que você quer conectar."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Uma conta no Claude: claude.ai, Claude Desktop, aplicativo de celular, Cowork ou Claude Code."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"1-adicionar-o-conector-conta-azul-no-claude","__idx":2},"children":["1. Adicionar o conector Conta Azul no Claude"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["No Claude, abra ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Configurações → Conectores"]},", procure os conectores disponíveis e busque ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Conta Azul"]},". "]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Clique em ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Conectar"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Não precisa de liberação nem de cadastro no Portal do Desenvolvedor."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"no-claude-code","__idx":3},"children":["No Claude Code"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/mcp"]}," e confira se o ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Conta Azul"]}," está na lista."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2-conectar-a-sua-conta-conta-azul","__idx":4},"children":["2. Conectar a sua conta Conta Azul"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ao clicar em ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Conectar"]},", o Claude abre a tela de login da Conta Azul."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Faça login com a conta Conta Azul da empresa que você quer conectar."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Na tela ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Permissão de acesso para uma ferramenta de IA"]},", confira a linha ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Depois de autorizar, você volta para claude.ai"]},". Se aparecer outro endereço, clique em ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Negar acesso"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Clique em ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Autorizar acesso"]},". O Claude volta para a conversa e já pode usar as ferramentas da Conta Azul."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para usar outra empresa, conecte de novo com o login dessa empresa."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"permissões-das-ferramentas","__idx":5},"children":["Permissões das ferramentas"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Requer aprovação"]}," nas configurações do conector, para o Claude pedir confirmação antes de alterar dados."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"desconectar-e-revogar-o-acesso","__idx":6},"children":["Desconectar e revogar o acesso"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Desconectar no Claude."]}," Em ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Revogar na Conta Azul."]}," A revogação encerra a autorização da ferramenta de IA naquela empresa. Você pode pedir a revogação:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["pelo chat do ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers-portal.contaazul.com"},"children":["Portal do Desenvolvedor"]}," ou pelo e-mail ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["api@contaazul.com"]}," (recomendado);"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["pelos ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://ajuda.contaazul.com/hc/pt-br/articles/4403549527053-Conhe%C3%A7a-os-canais-de-atendimento-oficiais-da-Conta-Azul"},"children":["canais de atendimento"]}," da Conta Azul."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No pedido, informe o CNPJ da empresa e que a conexão foi feita pelo Claude."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Depois da revogação:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["o Claude não consegue mais renovar o acesso;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["o acesso já liberado continua válido por até 1 hora;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["para voltar a usar, é preciso conectar de novo e autorizar o acesso outra vez (passo 2)."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"para-desenvolvedores-e-parceiros","__idx":7},"children":["Para desenvolvedores e parceiros"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["app próprio"]},":"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["No ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers-portal.contaazul.com"},"children":["Portal do Desenvolvedor"]},", crie uma aplicação de produção com a URL de redirecionamento do seu cliente MCP. Para o claude.ai, use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://claude.ai/api/mcp/auth_callback"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Peça a liberação do app para o MCP pelo chat do Portal ou por ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["api@contaazul.com"]},", informando o client ID. A liberação leva até 5 minutos para valer."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["No claude.ai, adicione um ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["conector personalizado"]}," com a URL ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api-v2.contaazul.com/mcp"]}," e, em ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Configurações avançadas"]},", informe o client ID e o client secret do app."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"problemas-comuns","__idx":8},"children":["Problemas comuns"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"O que aparece"},"children":["O que aparece"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Causa provável"},"children":["Causa provável"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"O que fazer"},"children":["O que fazer"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Este app não está liberado para usar o MCP da Conta Azul"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Você conectou por um conector personalizado ou outro cliente, sem um app liberado"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No Claude, use o conector do diretório. Para outros clientes, veja ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#para-desenvolvedores-e-parceiros"},"children":["Para desenvolvedores e parceiros"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Erro ao conectar um conector personalizado só com a URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O MCP só aceita apps cadastrados"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use o conector do diretório ou informe o client ID e o client secret do seu app em Configurações avançadas"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["App liberado, mas o erro continua ou alterna"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A liberação leva até 5 minutos"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Aguarde e tente de novo"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O Claude diz só que houve um problema de conexão"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Às vezes o Claude não mostra a mensagem de erro"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tente conectar de novo. Se continuar, fale com api@contaazul.com"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O conector não aparece para adicionar"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Plano Team ou Enterprise do Claude"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Peça ao owner da organização para habilitar o conector"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["O Conta Azul não aparece no Claude Code"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Você entrou com outra conta, ou existe outro servidor com a mesma URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Entre com a conta do Claude em que conectou. Remova servidores duplicados com ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claude mcp remove <nome>"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"o-que-é-o-mcp","__idx":9},"children":["O que é o MCP"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://cdn.contaazul.com/assets/versions/current/assets/integrations/o-que-e-mcp-v01.pdf"},"children":["O que é MCP"]},". O mesmo link aparece na tela de autorização da Conta Azul."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"termos-e-privacidade","__idx":10},"children":["Termos e privacidade"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O uso do MCP da Conta Azul segue os ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://cdn.contaazul.com/assets/versions/current/assets/integrations/termos-de-uso-portal-do-desenvolvedor-v1.pdf"},"children":["Termos de Uso do Portal do Desenvolvedor"]}," e a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://contaazul.com/termos/privacidade/"},"children":["Política de Privacidade da Conta Azul"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"suporte","__idx":11},"children":["Suporte"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dúvidas, liberações de app e pedidos de revogação: chat do ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers-portal.contaazul.com"},"children":["Portal do Desenvolvedor"]}," ou ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["api@contaazul.com"]},"."]}]},"headings":[{"value":"Conectar a Conta Azul ao Claude","id":"conectar-a-conta-azul-ao-claude","depth":1},{"value":"O que você precisa","id":"o-que-você-precisa","depth":2},{"value":"1. Adicionar o conector Conta Azul no Claude","id":"1-adicionar-o-conector-conta-azul-no-claude","depth":2},{"value":"No Claude Code","id":"no-claude-code","depth":3},{"value":"2. Conectar a sua conta Conta Azul","id":"2-conectar-a-sua-conta-conta-azul","depth":2},{"value":"Permissões das ferramentas","id":"permissões-das-ferramentas","depth":2},{"value":"Desconectar e revogar o acesso","id":"desconectar-e-revogar-o-acesso","depth":2},{"value":"Para desenvolvedores e parceiros","id":"para-desenvolvedores-e-parceiros","depth":2},{"value":"Problemas comuns","id":"problemas-comuns","depth":2},{"value":"O que é o MCP","id":"o-que-é-o-mcp","depth":2},{"value":"Termos e privacidade","id":"termos-e-privacidade","depth":2},{"value":"Suporte","id":"suporte","depth":2}],"frontmatter":{"seo":{"title":"Conectar a Conta Azul ao Claude"}},"lastModified":"2026-11-09T19:32:23.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guide_mcp","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}