mcp-focus-nfe — MCP-сервер для Claude Code
Подключает API Focus NFe к ассистенту для выпуска и отслеживания бразильских фискальных документов: NFe, NFSe, NFCe, CTe и MDFe.
claude mcp add mcp-focus-nfe -e FOCUS_NFE_TOKEN=<FOCUS_NFE_TOKEN> -- npx -y @codespar/mcp-focus-nfeЧто делает mcp-focus-nfe
Сервер даёт агенту 19 инструментов для работы с фискальными документами Бразилии через Focus NFe. С ним модель умеет генерировать товарные накладные NFe, розничные чеки NFCe, инвойсы за услуги NFSe, транспортные накладные CTe и манифесты MDFe. Доступны операции проверки статуса, аннулирования документов и выгрузки ссылок на PDF-версию DANFE.
Поддерживаются и транспортные сценарии. Сервер умеет закрывать рейсы MDFe после завершения перевозки, регистрировать вебхуки на события и отправлять корректировочные письма CCe. Авторизация происходит через HTTP Basic Auth, где логином выступает API-токен клиента.
Без переменной FOCUS_NFE_TOKEN сервер работать не будет. Для отладки без юридических последствий есть тестовый контур homologacao.focusnfe.com.br, который активируется переменной FOCUS_NFE_SANDBOX="true".
Какие задачи решает
- Выпускать электронные инвойсы NFe, NFSe и NFCe напрямую из чата
- Аннулировать ошибочно отправленные накладные в допустимый законом срок
- Получать ссылки на скачивание бланков DANFE в формате PDF
- Оформлять документы перевозки CTe и закрывать манифесты MDFe
- Управлять регистрацией вебхуков для получения оповещений о статусе документов
Примеры запросов агенту
- Проверь статус документа NFe с идентификатором
ref-9842и пришли ссылку на DANFE - Выпусти тестовый инвойс NFSe для клиента через песочницу
- Отмени накладную NFe с номером
ref-104, если 24 часа с момента создания ещё не прошли
Как установить mcp-focus-nfe
Командой платформы
claude mcp add mcp-focus-nfe -e FOCUS_NFE_TOKEN=<FOCUS_NFE_TOKEN> -- npx -y @codespar/mcp-focus-nfeВместо <…> подставьте свои значения
Командой платформы
codex mcp add focus-nfe --env FOCUS_NFE_TOKEN=<FOCUS_NFE_TOKEN> -- npx -y @codespar/mcp-focus-nfeВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"focus-nfe": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-focus-nfe"
],
"env": {
"FOCUS_NFE_TOKEN": "<FOCUS_NFE_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"focus-nfe": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-focus-nfe"
],
"env": {
"FOCUS_NFE_TOKEN": "<FOCUS_NFE_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e FOCUS_NFE_TOKEN=<FOCUS_NFE_TOKEN> focus-nfe npx -y @codespar/mcp-focus-nfeВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-focus-nfe
Как установить mcp-focus-nfe в Claude Code?
Выполните в терминале команду claude mcp add mcp-focus-nfe -e FOCUS_NFE_TOKEN=<FOCUS_NFE_TOKEN> -- npx -y @codespar/mcp-focus-nfe, указав свой ключ от Focus NFe.
Что делает mcp-focus-nfe?
Открывает доступ к 19 инструментам Focus NFe для создания, проверки статуса и отмены бразильских фискальных документов и транспортных накладных.
Как протестировать работу без отправки реальных налоговых отчётов?
Задайте переменную среды FOCUS_NFE_SANDBOX="true". Сервер переключит запросы на тестовый адрес homologacao.focusnfe.com.br.
