Conta Azul MCP

Name: Conta Azul MCP
Author: douglac

von douglacVersion 0.1.0i★ –iLäuft in der Cloud

Name in der Registryio.github.douglac/contaazul-mcp

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

Conta Azul ERP MCP — sales, customers, finance and NF-e via OAuth 2.0. Read + write, 35 tools.

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiNoch nicht gemessen★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft in der Cloud
Transport: Streamable HTTP
Kategorie: Buchhaltung, Finanzen & Steuern

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf dem Server des Entwicklers: Was du fragst, läuft über dessen Server.
Die Registry nennt keinen Schlüssel zum Eintragen.

Du brauchst

Läuft in der CloudNichts zu installieren; die Verbindung läuft übers Internet

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Funktioniert in Claude im Web, auf dem Desktop und auf dem Handy:

Öffne Settings → Connectors
Tippe auf Add custom connector
Füge die Adresse unten ein und tippe auf Add
Wenn eine Anmeldung verlangt wird, melde dich beim Dienst des Entwicklers an

https://api.mcp.ai/contaazul

Führe das in deinem Terminal aus

claude mcp add --transport http contaazul https://api.mcp.ai/contaazul

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "contaazul": {
      "url": "https://api.mcp.ai/contaazul"
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "contaazul": {
      "type": "http",
      "url": "https://api.mcp.ai/contaazul"
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

ChatGPT verbindet sich nur mit Servern im Internet:

Öffne ChatGPT im Web → Settings → Connectors (Apps)
Tippe auf Create oder Add (bei manchen Tarifen musst du zuerst Developer mode unter Advanced einschalten)
Füge die Adresse unten ein, gib ihr einen Namen und speichere
Wenn eine Anmeldung verlangt wird, melde dich beim Dienst des Entwicklers an

https://api.mcp.ai/contaazul

Menünamen können sich je nach Tarif und mit der Zeit leicht unterscheiden.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Die Tool-Liste dieses Servers haben wir noch nicht gelesen; wir prüfen die Endpunkte reihum.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 7. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto douglac bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Endpunkt antwortet
Noch nicht geprüft; wir prüfen die Endpunkte reihum
… Noch nicht geprüft
Anmeldung mit OAuth
Noch nicht geprüft; wir prüfen die Endpunkte reihum
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Noch nicht geprüft; wir lesen die Tool-Liste, wenn wir den Endpunkt prüfen

Im Vergleich mit anderen in Buchhaltung, Finanzen & Steuerni

Mehr Sterne als 0 % der anderen 1734 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 10 % der anderen 1734 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 1734 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Conta Azul MCP sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.1.0) kam vor 5 Monaten in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL, also funktionieren auch Apps, die Remote-MCP-Server akzeptieren, zum Beispiel ChatGPT im Entwicklermodus.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Finance Toolkit, SolidInvoice, Korea Tax Calculator

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Finance Toolkit

von JerBouma

500+ transparent financial methods calculated from raw statements, not third-party endpoints.

Computer oder Cloud★ 5.496MITAktualisiert heute

Installieren

SolidInvoice

von SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

Läuft in der Cloud★ 981MITAktualisiert vor 8 Tagen

Installieren

Korea Tax Calculator

von UpstageAI

Korean tax calculation and tax-audit judgment MCP: 96 tools with statutory citations.

Läuft auf deinem Computer★ 97MITAktualisiert gestern

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

Conta Azul MCP

ERP financeiro Conta Azul para Claude, Cursor e agentes de IA

Conecte sua conta Conta Azul ao seu agente de IA. Gerencie clientes e fornecedores, produtos, serviços, vendas, contratos, contas a pagar e receber, parcelas, quitações e NF-e em linguagem natural. Login via OAuth da própria Conta Azul, em 30 segundos — sem digitar token, sem configurar nada.

🏢 ERP completo — pessoas, produtos, vendas, contratos, financeiro e NF-e em um só lugar
💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue
✍️ Lê e escreve — a IA consulta dados e também cria/edita cadastros, vendas, contas e quitações (sempre quando você pede)
📊 52 ferramentas cobrindo a API v2 da Conta Azul
🔑 OAuth 2.0 da Conta Azul — a plataforma fornece a aplicação OAuth, você só clica em Autorizar
🛡️ LGPD-compliant — consentimento explícito, retenção mínima, você no controle

English version · Documentação completa · Skills do Claude Code

Instalar em 1 clique

Claude (Web e Desktop)

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

➕ Abrir no Claude e conectar

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

Manual (se o deeplink não abrir): vá em claude.ai/customize/connectors → clique + → Adicionar conector personalizado → cole:

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

Cursor

➕ Instalar Conta Azul MCP no Cursor

VS Code (Copilot Chat)

➕ Instalar Conta Azul MCP no VS Code

ChatGPT, Manus, OpenClaw e mais 40+ clientes

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

https://api.mcp.ai/contaazul

Veja INSTALL.md pra exemplos de configuração por cliente.

Instruções detalhadas: INSTALL.md — config manual em arquivo (claude_desktop_config.json, .cursor/mcp.json, .vscode/mcp.json), fluxo agent-auth pra clientes sem OAuth, troubleshooting, e instruções pra IA te ajudar a instalar.

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 como MCP remoto HTTP e rodar o fluxo de autenticação de ponta a ponta:

📋 Copiar prompt (PT-BR)

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.

Pergunte sobre o seu negócio

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 pode criar e alterar dados na sua Conta Azul — cadastros, vendas, contratos, contas a pagar/receber e quitações. As escritas só acontecem quando você pede. Recomendamos revisar a ação proposta antes de confirmar (especialmente cancelamentos e exclusões, que são destrutivos).

52 ferramentas disponíveis

Cobrem a API v2 da Conta Azul, organizadas por módulo. Detalhe de cada uma em docs/ferramentas.md.

Empresa & contas

Tool	Descrição
`contaazul_list_accounts`	Lista as empresas Conta Azul vinculadas
`contaazul_get_company`	Dados da empresa ativa (CNPJ, razão social, regime tributário)

Pessoas (clientes / fornecedores / vendedores / transportadores)

Tool	Descrição
`contaazul_list_people`	Lista pessoas (filtros: busca, tipo, ativo)
`contaazul_get_person`	Detalhe de uma ou mais pessoas por id
`contaazul_person_write_create`	Cria uma pessoa
`contaazul_person_write_update`	Atualiza uma pessoa (só os campos enviados)
`contaazul_person_delete`	Remove pessoas (destrutivo)

Produtos & serviços

Tool	Descrição
`contaazul_list_products`	Lista produtos cadastrados
`contaazul_product_write`	Cria um produto
`contaazul_list_services`	Lista serviços cadastrados
`contaazul_service_write`	Cria um serviço

Vendas & orçamentos

Tool	Descrição
`contaazul_list_sales`	Lista vendas (filtros: cliente, vendedor, situação, categoria, produto, número, datas, texto livre)
`contaazul_list_sale_items`	Itens (produtos/serviços, quantidade, valor) de até 50 vendas
`contaazul_get_sale`	Detalhe de uma ou mais vendas por id
`contaazul_sale_write_create`	Cria uma venda
`contaazul_sale_write_update`	Atualiza uma venda
`contaazul_sale_cancel`	Cancela vendas (destrutivo)
`contaazul_list_budgets`	Lista orçamentos
`contaazul_get_budget`	Detalhe de um ou mais orçamentos por id
`contaazul_create_budget`	Cria um orçamento
`contaazul_delete_budgets`	Exclui orçamentos (destrutivo)

Contratos

Tool	Descrição
`contaazul_list_contracts`	Lista contratos por período
`contaazul_get_contract`	Detalhe de um ou mais contratos por id
`contaazul_contract_next_number`	Próximo número de contrato disponível
`contaazul_contract_write`	Cria um contrato
`contaazul_terminate_contract`	Encerra contratos
`contaazul_delete_contract`	Remove contratos (destrutivo)

Financeiro: contas a receber e a pagar

Tool	Descrição
`contaazul_list_receivables`	Lista contas a receber (filtros: vencimento, status)
`contaazul_receivable_create`	Cria uma conta a receber
`contaazul_list_payables`	Lista contas a pagar (filtros: vencimento, status)
`contaazul_payable_create`	Cria uma conta a pagar
`contaazul_list_changed_events`	Eventos financeiros alterados num período (sync incremental)

Financeiro: parcelas e baixas

Tool	Descrição
`contaazul_list_installments`	Parcelas de um evento financeiro
`contaazul_get_installment`	Detalhe de uma ou mais parcelas por id
`contaazul_update_installment`	Atualiza campos de uma parcela
`contaazul_settle_installment`	Registra a baixa (recebimento/pagamento) de uma parcela
`contaazul_list_settlements`	Lista as baixas de uma parcela
`contaazul_get_settlement`	Detalhe de uma baixa por id
`contaazul_update_settlement`	Atualiza uma baixa
`contaazul_delete_settlement`	Estorna uma baixa (destrutivo)

Cobranças

Tool	Descrição
`contaazul_generate_charge`	Gera boleto, Pix ou link de pagamento para parcelas
`contaazul_get_charge`	Detalhe de uma cobrança emitida
`contaazul_cancel_charge`	Cancela uma cobrança emitida

Contas financeiras, categorias e centros de custo

Tool	Descrição
`contaazul_list_financial_accounts`	Lista contas financeiras (banco, caixa, cartão)
`contaazul_get_account_balance`	Saldo atual de uma conta financeira

| contaazul_get_initial_balance | Saldos iniciais das contas por per

Nur der Anfang wird gezeigt; den Rest findest du im Repo

Conta Azul MCP

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Buchhaltung, Finanzen & Steuerni

Häufige Fragen

Alternativen

Finance Toolkit

SolidInvoice

Korea Tax Calculator

README vom Entwickler

Conta Azul MCP

ERP financeiro Conta Azul para Claude, Cursor e agentes de IA

Instalar em 1 clique

Claude (Web e Desktop)

Cursor

VS Code (Copilot Chat)

ChatGPT, Manus, OpenClaw e mais 40+ clientes

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

Pergunte sobre o seu negócio

52 ferramentas disponíveis

Empresa & contas

Pessoas (clientes / fornecedores / vendedores / transportadores)

Produtos & serviços

Vendas & orçamentos

Contratos

Financeiro: contas a receber e a pagar

Financeiro: parcelas e baixas

Cobranças

Contas financeiras, categorias e centros de custo