fiscal — MCP-сервер для Claude Code: выпуск фискальных документов Бразилии
Подключает агента к бразильской фискальной инфраструктуре: NF-e, NFC-e, NFS-e, CT-e, MDF-e и DC-e уходят в SEFAZ прямо из чата.
claude mcp add --transport http fiscal https://api.brasilnfe.com.br/services/McpЧто делает fiscal
Сервер отдаёт агенту больше 30 инструментов в восьми категориях: выпуск NF-e и NFC-e, NFS-e, CT-e, MDF-e, DC-e, NF-EnerCom, события вроде отмены или письма-исправления, запросы к SEFAZ и CRUD по клиентам, товарам и правилам налогообложения. Плюс пять ресурсов со схемой brasilnfe:// для XML, DANFE и полученных за период документов и пять готовых промптов — например, emitir_nfe_simples и diagnostico_emissao. Агент сам находит нужный инструмент, собирает payload по схеме и переводит ответы SEFAZ на понятный язык.
Транспорт — Streamable HTTP, спецификация MCP 2025-06-18, эндпоинт https://api.brasilnfe.com.br/services/Mcp. Авторизация по Bearer-токену, лимит по умолчанию — 60 запросов в минуту на токен. Токен берут в панели после регистрации; режим homologação бесплатный, документы уходят в тестовую среду и в рабочую SEFAZ не попадают.
Отмена и аннулирование нумерации необратимы, поэтому сначала прогоняйте сценарий в homologação (tipoAmbiente: 2). Перед созданием клиента или товара имеет смысл вызвать *_consultar — иначе легко наплодить дубли. Долгие сессии лучше закрывать через DELETE /services/Mcp, чтобы раньше освободить квоту.
Какие задачи решает
- выпустить NFC-e для покупателя с CPF прямо из диалога с агентом
- проверить статус сервиса SEFAZ по нужному штату
- отменить уже авторизованную NF-e с обоснованием
- выгрузить XML и DANFE по ключу документа
- посчитать налоги до выпуска и подобрать правило налогообложения
Примеры запросов агенту
- Покажи статус SEFAZ для SP.
- Проверь CNPJ 39.658.743/0001-99 в базе.
- Выпусти NFC-e на R$ 89,90 для покупателя с CPF 123.456.789-00.
Как установить fiscal
Командой платформы: удалённый сервер
claude mcp add --transport http fiscal https://api.brasilnfe.com.br/services/McpКомандой платформы: удалённый сервер
codex mcp add fiscal --url https://api.brasilnfe.com.br/services/McpФайл настроек
{
"mcpServers": {
"fiscal": {
"url": "https://api.brasilnfe.com.br/services/Mcp"
}
}
}Файл настроек
{
"servers": {
"fiscal": {
"type": "http",
"url": "https://api.brasilnfe.com.br/services/Mcp"
}
}
}Командой платформы: удалённый сервер
gemini mcp add -t http fiscal https://api.brasilnfe.com.br/services/McpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о fiscal
Как установить fiscal в Claude Code?
Одной командой: claude mcp add --transport http fiscal https://api.brasilnfe.com.br/services/Mcp. После этого подставьте свой Bearer-токен и перезапустите клиент.
Что делает fiscal?
Даёт агенту инструменты для работы с бразильской фискальной системой: выпуск NF-e, NFC-e, NFS-e, CT-e, MDF-e и DC-e, события, запросы к SEFAZ, ведение клиентов и товаров, скачивание XML и PDF.
Что нужно, чтобы сервер заработал?
Bearer-токен из панели Brasil NFe и клиент с поддержкой MCP. Тестовый режим homologação бесплатный, документы туда уходят без риска для рабочей SEFAZ.
