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 расходует кредиты.
Настройка клиентов
{
"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-brasiluvx кеширует версию, поэтому для обновления используйте uvx mcp-fiscal-brasil@latest или uvx --refresh mcp-fiscal-brasil. Также доступны установка через pip и образ Docker ghcr.io/dehor-labs/mcp-fiscal-brasil:latest. Все переменные окружения необязательны.
Подключение к клиентам
Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.
{
"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.
Time
Эталонный сервер для получения текущего времени и перевода между часовыми поясами.
Reactive Resume
Открытый конструктор резюме с удалёнными MCP-инструментами для резюме и откликов.
AIHOT
Новости ИИ на китайском: темы, события и сводки.