mcp-nfse-nacional — MCP-сервер для Claude Code
MCP-сервер ищет NFSe на национальном портале, показывает детали и скачивает PDF. Нужен для работы с электронными счетами через ИИ-агента.
claude mcp add --env CERT_PASSWORD=<CERT_PASSWORD> --env CERT_FILE=<CERT_FILE> --env NODE_OPTIONS=<NODE_OPTIONS> --env MCP_PORT=<MCP_PORT> --env STORAGE_PATH=<STORAGE_PATH> --transport stdio mcp-nfse-nacional -- npx -y mcp-nfse-nacionalЧто делает mcp-nfse-nacional
mcp-nfse-nacional подключает агента к национальному порталу NFSe. Сервер ищет выданные счета за период, возвращает дату, получателя, сумму, статус и ключ. По ключу он получает полные данные, сохраняет XML и скачивает PDF DANFSe.
В сервере есть три MCP-инструмента: nfse_buscar, nfse_detalhes и nfse_pdf. Аутентификация выполняется при первом вызове, а после истечения сессии сервер повторяет вход. Запуск через npx поддерживает транспорт stdio и streamable-http; файлы по умолчанию попадают в ./storage.
Для работы нужны файл цифрового сертификата .pfx или .p12 и его пароль в CERT_FILE и CERT_PASSWORD. В режиме streamable-http у сервера нет собственной аутентификации, поэтому его нельзя открывать в публичную сеть без защиты reverse proxy.
Какие задачи решает
- найти выданные NFSe за период
- получить полные данные счета по ключу
- сохранить XML NFSe локально
- скачать PDF DANFSe
- подключить работу с NFSe к ИИ-агенту
Примеры запросов агенту
- Найди выданные NFSe за период между
YYYY-MM-DDиYYYY-MM-DD. - Получи подробности NFSe по её ключу и сохрани XML локально.
- Скачай PDF DANFSe для NFSe с указанным ключом.
Как установить mcp-nfse-nacional
Командой платформы
claude mcp add --env CERT_PASSWORD=<CERT_PASSWORD> --env CERT_FILE=<CERT_FILE> --env NODE_OPTIONS=<NODE_OPTIONS> --env MCP_PORT=<MCP_PORT> --env STORAGE_PATH=<STORAGE_PATH> --transport stdio mcp-nfse-nacional -- npx -y mcp-nfse-nacionalВместо <…> подставьте свои значения
Командой платформы
codex mcp add mcp-nfse-nacional --env CERT_PASSWORD=<CERT_PASSWORD> --env CERT_FILE=<CERT_FILE> --env NODE_OPTIONS=<NODE_OPTIONS> --env MCP_PORT=<MCP_PORT> --env STORAGE_PATH=<STORAGE_PATH> -- npx -y mcp-nfse-nacionalВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp-nfse-nacional": {
"command": "npx",
"args": [
"-y",
"mcp-nfse-nacional"
],
"env": {
"CERT_PASSWORD": "<CERT_PASSWORD>",
"CERT_FILE": "<CERT_FILE>",
"NODE_OPTIONS": "<NODE_OPTIONS>",
"MCP_PORT": "<MCP_PORT>",
"STORAGE_PATH": "<STORAGE_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp-nfse-nacional": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-nfse-nacional"
],
"env": {
"CERT_PASSWORD": "<CERT_PASSWORD>",
"CERT_FILE": "<CERT_FILE>",
"NODE_OPTIONS": "<NODE_OPTIONS>",
"MCP_PORT": "<MCP_PORT>",
"STORAGE_PATH": "<STORAGE_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e CERT_PASSWORD=<CERT_PASSWORD> -e CERT_FILE=<CERT_FILE> -e NODE_OPTIONS=<NODE_OPTIONS> -e MCP_PORT=<MCP_PORT> -e STORAGE_PATH=<STORAGE_PATH> mcp-nfse-nacional npx -y mcp-nfse-nacionalВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-nfse-nacional
Как установить mcp-nfse-nacional в Claude Code?
Выполните claude mcp add mcp-nfse-nacional -e CERT_PASSWORD=<CERT_PASSWORD> -e CERT_FILE=<CERT_FILE> -- npx -y mcp-nfse-nacional.
Что делает mcp-nfse-nacional?
Он ищет выданные NFSe по датам, получает данные счета по ключу, сохраняет XML и скачивает PDF DANFSe через MCP-инструменты.
Что нужно для работы сервера?
Нужны цифровой сертификат .pfx или .p12, его пароль и значения CERT_FILE и CERT_PASSWORD. Для HTTP-режима сервер нужно закрыть от публичного доступа или поставить перед ним аутентифицированный reverse proxy.
