Conta Azul MCP — Claude Code MCP server: what it does, how to install
Connects Brazilian ERP Conta Azul to AI assistants to query and update sales, invoices, and financial records over HTTP.
claude mcp add --transport http contaazul-mcp https://api.mcp.ai/contaazulWhat Conta Azul MCP does
This tool connects an assistant to the Brazilian ERP Conta Azul through its v2 API. It exposes 52 tools for reading and writing data, covering customer profiles, contracts, payables, receivables, and NF-e electronic documents. The model can inspect account records and register new sales entries upon request.
The server runs remotely. Everything operates over HTTP at https://api.mcp.ai/contaazul, eliminating local runtime setups with Node.js. Authentication relies on helper tools authenticate and connect, which route the user through a web OAuth 2.0 flow.
Without remote HTTP transport support in your client, the connection will fail.
What it helps with
- monitor overdue payables and incoming receivables
- verify status updates for NF-e invoices
- register new customer profiles in the ERP
- log settlement entries for pending installments
Example prompts for the agent
- Show me all overdue receivables for this month in Conta Azul
- Check the processing state of the latest NF-e document
- Add a new vendor record to the ERP system
How to install Conta Azul MCP
Platform CLI: remote server
claude mcp add --transport http contaazul-mcp https://api.mcp.ai/contaazulPlatform CLI: remote server
codex mcp add conta-azul-mcp --url https://api.mcp.ai/contaazulConfig file
{
"mcpServers": {
"conta-azul-mcp": {
"url": "https://api.mcp.ai/contaazul"
}
}
}Config file
{
"servers": {
"conta-azul-mcp": {
"type": "http",
"url": "https://api.mcp.ai/contaazul"
}
}
}Platform CLI: remote server
gemini mcp add -t http conta-azul-mcp https://api.mcp.ai/contaazulStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Conta Azul MCP
How to install Conta Azul MCP in Claude Code?
Run claude mcp add --transport http contaazul-mcp https://api.mcp.ai/contaazul.
What does Conta Azul MCP do?
It connects AI models to Conta Azul ERP to read and modify financial data. You can inspect contacts, invoices, and sales directly through your assistant.
Does Conta Azul MCP need a local Node.js process?
No, it is hosted remotely at https://api.mcp.ai/contaazul. Local execution through npx or stdio is not used.
