mcp-nfe-io — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер для интеграции с NFe.io. Помогает выставлять бразильские налоговые инвойсы NF-e и NFS-e, а также проверять компании по кодам CNPJ и почтовым индексам CEP.
claude mcp add --env NFEIO_API_KEY=<NFEIO_API_KEY> --env NFEIO_COMPANY_ID=<NFEIO_COMPANY_ID> --transport stdio nfe-io -- npx -y @codespar/mcp-nfe-ioЧто делает mcp-nfe-io
Сервер даёт агенту 22 инструмента для работы со шлюзом NFe.io. С их помощью ассистент оформляет фискальные документы на товары и сервисные услуги, скачивает файлы XML и PDF, регистрирует исправления CC-e или отправляет квитанции клиентам на почту. Запросы распределяются по трём базовым хостам платформы автоматически в зависимости от выбранного типа документа.
Помимо генерации счетов, сервер выполняет поиск реквизитов компаний по номеру CNPJ и проверяет почтовые индексы CEP. Также поддерживаются операции управления списком юридических лиц и регистрация вебхуков. Для отладки в CI и демонстраций есть специальный офлайн-режим с отдачей заготовленных ответов без реальных запросов через флаг --demo или переменную MCP_DEMO=true.
Без ключа NFEIO_API_KEY в переменных окружения шлюз отклонит любые рабочие запросы. Идентификатор компании NFEIO_COMPANY_ID можно задать один раз при запуске или передавать в параметрах конкретного вызова.
Какие задачи решает
- Выписать электронный счёт NFS-e за оказанные услуги
- Получить ссылку на бланк DANFE в PDF по номеру NF-e
- Узнать реквизиты и статус организации по номеру CNPJ
- Настроить вебхук на события изменения статуса инвойса
Примеры запросов агенту
- Проверь юридические данные фирмы по номеру CNPJ 00.000.000/0001-91 с помощью
consult_cnpj. - Сформируй фискальный счёт через
create_nfseи пришли ссылку на итоговый PDF. - Найди адрес для индекса 01310-100 через инструмент
consult_cep.
Как установить mcp-nfe-io
Командой платформы
claude mcp add --env NFEIO_API_KEY=<NFEIO_API_KEY> --env NFEIO_COMPANY_ID=<NFEIO_COMPANY_ID> --transport stdio nfe-io -- npx -y @codespar/mcp-nfe-ioВместо <…> подставьте свои значения
Командой платформы
codex mcp add nfe-io --env NFEIO_API_KEY=<NFEIO_API_KEY> --env NFEIO_COMPANY_ID=<NFEIO_COMPANY_ID> -- npx -y @codespar/mcp-nfe-ioВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"nfe-io": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-nfe-io"
],
"env": {
"NFEIO_API_KEY": "<NFEIO_API_KEY>",
"NFEIO_COMPANY_ID": "<NFEIO_COMPANY_ID>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"nfe-io": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-nfe-io"
],
"env": {
"NFEIO_API_KEY": "<NFEIO_API_KEY>",
"NFEIO_COMPANY_ID": "<NFEIO_COMPANY_ID>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e NFEIO_API_KEY=<NFEIO_API_KEY> -e NFEIO_COMPANY_ID=<NFEIO_COMPANY_ID> nfe-io npx -y @codespar/mcp-nfe-ioВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-nfe-io
Как установить mcp-nfe-io в Claude Code?
Выполните в терминале команду claude mcp add mcp-nfe-io -e NFEIO_API_KEY=<NFEIO_API_KEY> -- npx -y @codespar/mcp-nfe-io. При необходимости добавьте второй параметр окружения с вашим NFEIO_COMPANY_ID.
Что делает mcp-nfe-io?
Он предоставляет инструменты для взаимодействия с бразильской фискальной системой NFe.io. Агент может создавать, отменять и скачивать счета NF-e и NFS-e, а также проверять номера CNPJ и индексы CEP.
Как запустить сервер в тестовом режиме без списаний?
Передайте флаг --demo в аргументах запуска или задайте переменную окружения MCP_DEMO=true. Сервер переключится на выдачу тестовых данных и не будет обращаться к внешнему API.
