Conta Azul MCP

A Anthropic unificou a instalação de MCPs emclaude.ai/customize/connectors.O mesmo link serve pra Claude Web e Claude Desktop(basta estar logado na sua conta):

Esse link abre o modal "Adicionar conector personalizado" já comnome(Conta Azul MCP) eURL(https://api.mcp.ai/contaazul) pré-preenchidos. CliqueAdicionar, faça login via magic-link na primeira chamada, autorize sua empresa Conta Azul.

- Nome:Conta Azul MCP
- URL:https://api.mcp.ai/contaazul

ChatGPT, Manus, OpenClaw e mais 40+ clientes

Conta Azul MCP funciona em qualquer cliente MCP que suporteMCP over HTTP. A URL do servidor é sempre a mesma:

Prompt pronto pra agents autônomos (OpenClaw, Hermes, etc.)

Alguns agents autônomos tratam MCP como processo local (stdio/npx) ou param na etapa de "registrar no config" sem nunca chamar as tools. Cole o prompt abaixo pra forçar o consumo correto comoMCP remoto HTTPe rodar o fluxo de autenticação de ponta a ponta:

Use o Conta Azul MCP (ERP financeiro brasileiro, API v2 da Conta Azul) como um servidor MCP externo remoto via HTTP. Não trate esse MCP como local, não use stdio, não execute npx, node, subprocesso para "subir" servidor, e não assuma que apenas registrar a URL em config é suficiente. O endpoint é https://api.mcp.ai/contaazul e deve ser consumido por MCP remoto via HTTP/streamable-http. A prioridade é: (1) se o ambiente tiver suporte nativo a cliente MCP remoto HTTP, use-o; (2) se não tiver, procure um cliente MCP HTTP externo já disponível no próprio ambiente/servidor e use-o para conectar ao endpoint e chamar as tools; (3) só declare limitação depois de tentar ambos os caminhos. O objetivo é realmente consumir o MCP remoto, não apenas cadastrá-lo. Primeiro, se o ambiente usar registro/config de MCP, registre o servidor com nome como contaazul-mcp, URL https://api.mcp.ai/contaazul e transporte streamable-http; em seguida, teste conectividade real ao endpoint remoto. Antes de qualquer autenticação, liste as ferramentas disponíveis no servidor remoto; como o Conta Azul MCP é soft-gate, a descoberta inicial (mesmo deslogado) deve retornar TODAS as ferramentas do ERP — contaazul_list_accounts, contaazul_get_company, contaazul_list_people, contaazul_list_sales, contaazul_list_receivables, contaazul_list_payables, contaazul_list_invoices_nfe e demais contaazul_ — além de show_version, report_bug, connect e authenticate. Se a listagem funcionar, prossiga obrigatoriamente com o fluxo. O fluxo correto é: 1. chamar a tool authenticate sem argumentos (ou chamar qualquer tool contaazul_ deslogado, que retornará o link de autenticação); 2. se retornar um link de login, mostrar esse link ao usuário e instruí-lo a abrir, autenticar no mcp.ai e enviar o token retornado; 3. quando o usuário enviar o token, chamar authenticate novamente com { "token": "<jwt_enviado_pelo_usuario>" }; 4. após autenticação confirmada, chamar connect; 5. se connect retornar um link de autorização da Conta Azul (OAuth 2.0), mostrar ao usuário para abrir, logar na conta Conta Azul dele e autorizar o acesso à empresa; 6. depois da conexão, usar as tools de consulta contaazul_list_accounts, contaazul_get_company, contaazul_list_sales, contaazul_list_people, contaazul_list_receivables, contaazul_list_payables e contaazul_list_invoices_nfe para ler os dados do ERP. O Conta Azul MCP também tem ferramentas de escrita (criar/atualizar pessoas, produtos, vendas, contratos, contas a pagar/receber, quitar parcelas) — só use escrita quando o usuário pedir explicitamente, e confirme antes de operações destrutivas (cancelar venda/contrato, excluir pessoa). O assistente deve ser operacional: não parar na etapa de config se houver um modo de realmente chamar tools no ambiente; não pedir instalação de SDK sem necessidade; não dizer que "não é possível" sem antes verificar suporte nativo MCP remoto e, na falta dele, a existência de cliente MCP HTTP externo já presente no ambiente. Se o ambiente exigir reinício, reload de serviço ou reaplicação de configuração para usar o MCP, avise o usuário antes, com mensagem clara como: "Vou reiniciar para aplicar a configuração do Conta Azul MCP — volto em instantes." Depois confirme que voltou. Se não precisar reiniciar, não mencione reinício. Ao receber um link de autenticação de authenticate, responda objetivamente com algo como: "Abra este link, faça login no mcp.ai e me envie o token que aparecer: <link>". Em resumo: trate o Conta Azul MCP como MCP remoto HTTP, tente conexão real, liste tools, execute authenticate, peça o token ao usuário, execute authenticate com token, depois execute connect, peça a autorização OAuth na Conta Azul e então use as tools contaazul_* para consultar (e, quando o usuário pedir, gerenciar) os dados do ERP.

Depois de autorizar sua empresa, faça perguntas e dê comandos como:

Liste as 20 últimas vendas e o total faturado nos últimos 30 dias Quais contas a pagar vencem essa semana? Quais contas a receber estão vencidas hoje? Cadastra o cliente João Silva (CPF 123.456.789-00, e-mail joao@ex.com) Cria um produto "Setup Inicial" com valor de venda R$ 499 Registra uma venda do produto Mensalidade Premium para o cliente X Resume meu fluxo de caixa do mês (entradas vs saídas) Quita a parcela de R$ 250 que venceu hoje na conta do Itaú Lista as NF-e emitidas em maio

✍️Lê e escreve: além de consultar, a IA podecriar e alterar dadosna sua Conta Azul — cadastros, vendas, contratos, contas a pagar/receber e quitações. As escritas só acontecem quandovocê pede. Recomendamos revisar a ação proposta antes de confirmar (especialmente cancelamentos e exclusões, que são destrutivos).

Pessoas (clientes / fornecedores / vendedores / transportadores)

Financeiro (contas a receber / pagar / parcelas / quitação)