MCP Fiscal Brasil

MCP Fiscal Brasil — MCP-сервер сообщества (автор — DeHor-Labs). Бразильские налоговые инструменты: CNPJ, NF-e, ICMS, Simples Nacional и NCM без ключа API. Ставится через uvx или через Docker. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
DeHor-Labs
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
python

Уровень риска: high

manifestar_nfe отправляет события в SEFAZ (по умолчанию producao); сертификат A1 и пароль локально; опциональный платный провайдер cpfcnpj.com.br расходует кредиты.

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"fiscal-brasil\": {\n      \"command\": \"uvx\",\n      \"args\": [\"mcp-fiscal-brasil\"]\n    }\n  }\n}",
    "file": ".cursor/mcp.json",
    "lang": "json",
    "notes": "Дословно из README; или .mcp.json в корне проекта",
    "verified": "docs"
}

Что умеет

mcp-fiscal-brasil подключает ИИ-ассистентов, ERP, CRM и внутренние автоматизации к налоговой системе Бразилии: CNPJ и CPF, Simples Nacional и MEI, электронные накладные NF-e и NFS-e, отчётность SPED, eSocial, справки и проверку контрагентов. Авторы заявляют поддержку налоговой реформы 2026 (IBS/CBS). По умолчанию аккаунт, ключ и настройка не нужны: используются бесплатные источники (BrasilAPI, ReceitaWS, Portal NFe) и офлайн-проверки.

Инструменты по README:

  • агентные сценарии: analyze_cnpj_compliance (сводный отчёт о налоговом соответствии CNPJ), risk_score_supplier (оценка контрагента 0–100 с рекомендацией), consultar_empresas_lote (пакетная проверка CNPJ), compare_tax_regimes (сравнение режимов MEI, Simples, Lucro Presumido и Lucro Real), validate_nfe_full, summarize_sped;
  • CNPJ и CPF: данные компании (наименование, учредители, CNAE, адрес), статус в Simples Nacional, проверка контрольной цифры CPF;
  • NF-e: проверка и разбор ключа доступа, запрос накладной по 44-значному ключу, разбор XML, генерация DANFE в PDF, проверка подписи XMLDSig;
  • с сертификатом A1: статус веб-сервиса SEFAZ, загрузка документов (NFeDistribuicaoDFe), манифестация получателя (manifestar_nfe);
  • SPED и eSocial: анализ файлов EFD, ECD и ECF, фильтр записей, каталог и базовая проверка событий;
  • справочные: ссылки на порталы NFS-e и справок (CND, CRF) — оформлять их нужно вручную.

Кому подойдёт

  • Бухгалтерам и финансовым отделам компаний в Бразилии: проверка контрагентов, накладных и отчётности через ассистента.
  • Разработчикам ERP и учётных систем: проект также работает как Python SDK, CLI и REST API.

Похожие серверы — в категории финансы.

Установка

Нужен uv. Сервер запускается без постоянной установки:

uvx mcp-fiscal-brasil

uvx кеширует версию, поэтому для обновления используйте uvx mcp-fiscal-brasil@latest или uvx --refresh mcp-fiscal-brasil. Также доступны установка через pip и образ Docker ghcr.io/dehor-labs/mcp-fiscal-brasil:latest. Все переменные окружения необязательны.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude_desktop_config.json
{
  "mcpServers": {
    "fiscal-brasil": {
      "command": "uvx",
      "args": ["mcp-fiscal-brasil"]
    }
  }
}

Файл Claude Desktop находится в ~/Library/Application Support/Claude/ (macOS) или %APPDATA%\Claude\ (Windows). Для Cursor подойдёт и .mcp.json в корне проекта. Для VS Code с Continue README приводит блок continue.mcpServers для settings.json.

Проверка

Перезапустите клиент и попросите ассистента проверить контрольную цифру CPF или ключа NF-e: эти инструменты работают офлайн. Затем запросите данные любого CNPJ.

Примеры задач

Проверь контрагента с CNPJ 00.000.000/0001-91: соответствие, режим Simples и оценку риска.
Сделай краткую сводку по этому файлу SPED EFD: период, компания, найденные несоответствия.

Риски

  • Юридически значимые действия. manifestar_nfe отправляет в SEFAZ событие манифестации получателя по NF-e, а с сертификатом A1 сервер загружает документы по вашему CNPJ. По умолчанию используется производственная среда (NFE_AMBIENTE=producao); для проверок задайте homologacao.
  • Сертификат A1. Сертификат и пароль не отправляются на внешние серверы, mTLS и подпись выполняются локально. Храните пароль NFE_CERTIFICADO_SENHA в менеджере секретов, а не в версионируемом .env.
  • Платный провайдер (по желанию). При заданном CPFCNPJ_TOKEN запросы CNPJ, NF-e и NFC-e сначала идут в cpfcnpj.com.br и расходуют кредиты по пакетам этого сервиса. Без токена работают только бесплатные источники. Токен передаётся в пути URL, поэтому разрешён только https://.
  • Персональные данные. Ответы по CNPJ содержат сведения об учредителях; соблюдайте требования к обработке таких данных.

Частые вопросы

Нужен ли API-ключ?

Нет. Основные инструменты работают без ключей. Сертификат A1 нужен только для запросов к SEFAZ, токен cpfcnpj.com.br — только для платного источника.

Можно ли получить справку CND автоматически?

Нет. Инструменты справок возвращают ссылку на портал и инструкцию: оформить справку нужно вручную.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

Everything

Эталонный тестовый сервер, который демонстрирует все возможности протокола MCP.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Time

Эталонный сервер для получения текущего времени и перевода между часовыми поясами.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Reactive Resume

Открытый конструктор резюме с удалёнными MCP-инструментами для резюме и откликов.

Риск: medium Лицензия: MIT ★ 45 567

AIHOT

Новости ИИ на китайском: темы, события и сводки.

Риск: medium Лицензия: MIT ★ 9 672

Источники