# fiscal

Подключает агента к бразильской фискальной инфраструктуре: NF-e, NFC-e, NFS-e, CT-e, MDF-e и DC-e уходят в SEFAZ прямо из чата.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: BrasilNFe
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/BrasilNFe/brasilnfe-mcp
- Обновлён: 2026-06-12
- HTML: https://affpapa.org/nevibecode/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`, чтобы раньше освободить квоту.

## Требования
- Удалённый сервер: `https://api.brasilnfe.com.br/services/Mcp`

## Установка

### Claude Code (родная платформа)

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http fiscal https://api.brasilnfe.com.br/services/Mcp
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add fiscal --url https://api.brasilnfe.com.br/services/Mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "fiscal": {
            "url": "https://api.brasilnfe.com.br/services/Mcp"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "fiscal": {
            "type": "http",
            "url": "https://api.brasilnfe.com.br/services/Mcp"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http fiscal https://api.brasilnfe.com.br/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.

## Похожие
- [MCP Fiscal Brasil](https://affpapa.org/nevibecode/mcp/mcp-fiscal-brasil.md) — MCP-сервер · ★ 375
- [mcp-nuvem-fiscal](https://affpapa.org/nevibecode/mcp/mcp-nuvem-fiscal.md) — MCP-сервер · ★ 274
- [mcp-nfe-io](https://affpapa.org/nevibecode/mcp/mcp-nfe-io.md) — MCP-сервер · ★ 274
- [popbill](https://affpapa.org/nevibecode/skills/popbill.md) — скилл · 4400 установок
- [Conta Azul MCP](https://affpapa.org/nevibecode/mcp/conta-azul-mcp.md) — MCP-сервер · ★ 12
- [QuickBooks Automation](https://affpapa.org/nevibecode/skills/quickbooks-automation.md) — скилл · 4700 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md