
Conta Azul MCP
Conta Azul MCP Conecte o ERP Conta Azul ao Claude, Cursor e agentes de IA.
Что умеет
- Contaazul List Accounts: Lista as empresas Conta Azul vinculadas a este install (company_id, label).
- Contaazul Get Company: Dados da empresa Conta Azul ativa (CNPJ, razão social, regime tributário).
- Contaazul List People: Lista pessoas (clientes, fornecedores, vendedores, transportadores) cadastradas. Filtros via params: tamanho_pagina, pagina, busca (nome/documento), tipo, ativo.
Какие данные видит
Нужен ли аккаунт
Не нужен: сервер работает без входа
Conta Azul MCP
Conecte o ERP Conta Azul ao Claude, Cursor e agentes de IA. Clientes, fornecedores, produtos, serviços, vendas, contratos, contas a pagar/receber, parcelas e NF-e em linguagem natural. Lê e escreve.
- 🧾 ERP Conta Azul completo (vendas, financeiro, cadastros, NF-e)
- ✏️ Leitura e escrita
- 🔑 OAuth 2.0, conexão segura
Ferramentas
Pessoas (clientes/fornecedores), produtos, serviços, vendas, contratos, contas a pagar/receber, parcelas e emissão de NF-e.
Funciona em qualquer cliente MCP. Servidor remoto: https://api.mcp.ai/contaazul
Как подключить
Как подключить Conta Azul MCP к Claude
Адрес сервера, который нужно вставить в настройках Claude:
https://contaazul-mcp--douglas.run.tools
- Откройте Claude (сайт claude.ai или приложение для компьютера).
- Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
- Нажмите Добавить пользовательский коннектор (Add custom connector).
- Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
- В чате нажмите + → Коннекторы и включите новый коннектор.
Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.
Авторизация
После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.
Как подключить Conta Azul MCP к ChatGPT
Адрес сервера, который нужно вставить в настройках ChatGPT:
https://contaazul-mcp--douglas.run.tools
- Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
- Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
- Откройте Настройки → Коннекторы и нажмите Создать (Create).
- Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
- В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
- В новом чате откройте + → Приложения/Коннекторы и включите коннектор.
Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.
Авторизация
При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.
Как подключить Conta Azul MCP к Cursor
Адрес сервера, который нужно вставить в настройках Cursor:
https://contaazul-mcp--douglas.run.tools
Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.
Вручную:
- В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
- Вставьте JSON, скопированный ниже, в открывшийся файл
~/.cursor/mcp.json(для одного проекта:.cursor/mcp.jsonв корне проекта). - Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.
Авторизация
Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.
Список инструментов сервера (41)
Технические названия из tools/list. Нужны только разработчикам.
| contaazul_list_accounts | Lista as empresas Conta Azul vinculadas a este install (company_id, label). |
| contaazul_get_company | Dados da empresa Conta Azul ativa (CNPJ, razão social, regime tributário). |
| contaazul_list_people | Lista pessoas (clientes, fornecedores, vendedores, transportadores) cadastradas. Filtros via params: tamanho_pagina, pagina, busca (nome/documento), tipo, ativo. |
| contaazul_get_person | Detalhe de uma pessoa por id. Bulk support: accepts ids for batched execution. |
| contaazul_person_write_create | Cria ou atualiza uma pessoa. action=create: requer nome e (cpf|cnpj) — passe os campos via `data` (JSON). action=update: requer id e os campos a alterar em `data` (JSON). [Flattened action: create] Bulk support: accepts ids for batched execution. |
| contaazul_person_write_update | Cria ou atualiza uma pessoa. action=create: requer nome e (cpf|cnpj) — passe os campos via `data` (JSON). action=update: requer id e os campos a alterar em `data` (JSON). [Flattened action: update] Bulk support: accepts ids for batched execution. |
| contaazul_person_delete | Remove uma pessoa por id. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution. |
| contaazul_list_products | Lista produtos cadastrados. Filtros: tamanho_pagina, pagina, busca, ativo. |
| contaazul_get_product | Detalhe de produto por id. Bulk support: accepts ids for batched execution. |
| contaazul_product_write_create | Cria ou atualiza produto. action=create: nome + valor_venda obrigatórios em `data`. action=update: id obrigatório. [Flattened action: create] Bulk support: accepts ids for batched execution. |
| contaazul_product_write_update | Cria ou atualiza produto. action=create: nome + valor_venda obrigatórios em `data`. action=update: id obrigatório. [Flattened action: update] Bulk support: accepts ids for batched execution. |
| contaazul_list_services | Lista serviços cadastrados. |
| contaazul_service_write | Cria um serviço. `data` é JSON com nome, valor, etc. |
| contaazul_list_sales | Lista vendas. Filtros: tamanho_pagina, pagina, data_inicio, data_fim (YYYY-MM-DD), cliente_id, status_venda. Bulk support: accepts cliente_ids for batched execution. |
| contaazul_get_sale | Detalhe de uma venda por id. Bulk support: accepts ids for batched execution. |
| contaazul_sale_write_create | Cria ou atualiza venda. action=create posta em /venda; action=update em /vendas/{id}. `data` é o payload completo da venda em JSON. [Flattened action: create] Bulk support: accepts ids for batched execution. |
| contaazul_sale_write_update | Cria ou atualiza venda. action=create posta em /venda; action=update em /vendas/{id}. `data` é o payload completo da venda em JSON. [Flattened action: update] Bulk support: accepts ids for batched execution. |
| contaazul_sale_cancel | Cancela uma venda. Operação destrutiva — confirme antes. Bulk support: accepts ids for batched execution. |
| contaazul_list_contracts | Lista contratos. Filtros: tamanho_pagina, pagina, cliente_id, status. Bulk support: accepts cliente_ids for batched execution. |
| contaazul_get_contract | Detalhe de contrato por id. Bulk support: accepts ids for batched execution. |
| contaazul_contract_write | Cria um contrato. `data` é o payload em JSON. |
| contaazul_contract_cancel | Cancela/remove um contrato. Bulk support: accepts ids for batched execution. |
| contaazul_list_receivables | Lista contas a receber. Filtros: tamanho_pagina, pagina, data_inicio, data_fim, status (PENDENTE, PAGO, ATRASADO), cliente_id. Bulk support: accepts cliente_ids for batched execution. |
| contaazul_receivable_create | Cria uma conta a receber. `data` em JSON. |
| contaazul_list_payables | Lista contas a pagar. Filtros: tamanho_pagina, pagina, data_inicio, data_fim, status, fornecedor_id. Bulk support: accepts fornecedor_ids for batched execution. |
| contaazul_payable_create | Cria uma conta a pagar. `data` em JSON. |
| contaazul_list_installments | Lista as parcelas de UM evento financeiro (passe `id_evento`). A API v2 não tem listagem chapada de todas as parcelas — pra varrer contas a receber/pagar use contaazul_list_receivables / contaazul_list_payables. |
| contaazul_get_installment | Detalhe de uma parcela por id. Bulk support: accepts ids for batched execution. |
| contaazul_settle_installment | Quita (settle) uma parcela. `data` em JSON com parcela_id, conta_financeira_id, valor_pago, data_pagamento. |
| contaazul_unsettle_installment | Desfaz uma quitação por id. Bulk support: accepts ids for batched execution. |
| contaazul_list_financial_accounts | Lista contas financeiras (banco, caixa, cartão). |
| contaazul_list_categories | Lista categorias financeiras (DRE). |
| contaazul_list_cost_centers | Lista centros de custo. |
| contaazul_list_invoices_nfe | Lista notas fiscais emitidas (NF-e). Filtros: tamanho_pagina, pagina, data_emissao_inicio, data_emissao_fim, status. |
| contaazul_get_invoice_nfe | Detalhe de uma NF-e por id. Bulk support: accepts ids for batched execution. |
| show_version | Show the current MCP platform and adapter versions. |
| report_bug | Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction. |
| connect | Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs. |
| toolkit_info | Returns the current toolkit state: installed MCPs, their connection status, and how many catalog tools each exposes. |
| marketplace | [BETA] Global MCP marketplace. action=search finds MCPs outside this toolkit. action=install adds a new MCP. action=uninstall removes one. Currently returns a mock for debug. |
| authenticate | MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token, paste here. Call with { token: "<jwt>" } after the user pastes, or with no args to get the link. |