novaposhta — MCP-сервер для Claude Code: установка
Подключает Nova Poshta API к ИИ-ассистентам для отслеживания отправлений, поиска адресов и работы с накладными.
claude mcp add --env NOVA_POSHTA_API_KEY=<NOVA_POSHTA_API_KEY> --env NOVA_POSHTA_SYSTEM=<NOVA_POSHTA_SYSTEM> --env LOG_LEVEL=<LOG_LEVEL> --transport stdio novaposhta-mcp-server -- npx -y @shopana/novaposhta-mcp-serverЧто делает novaposhta
MCP-сервер добавляет в ИИ-ассистент инструменты Nova Poshta: отслеживание одной или нескольких отправлений, просмотр движения и списка документов, поиск городов, улиц и отделений. Он также умеет считать стоимость и управлять накладными, а через справочные инструменты отдаёт типы грузов и услуг.
Сервер запускается через npx в режиме stdio; настройки задаются переменными NOVA_POSHTA_API_KEY, NOVA_POSHTA_SYSTEM и LOG_LEVEL. Ключ API нужен для операций с накладными, управления адресами, контрагентами и контактными лицами. Отслеживание, поиск адресов и справочники работают без ключа.
Без NOVA_POSHTA_API_KEY операции создания, изменения и удаления накладных не выполнятся. После изменения конфигурации MCP-клиент нужно перезапустить или перезагрузить.
Какие задачи решает
- отследить одну или несколько посылок Nova Poshta
- найти города, улицы и отделения
- рассчитать стоимость доставки
- создать или изменить накладную
- получить справочные данные о доставке
Примеры запросов агенту
- Отследи отправление Nova Poshta по номеру 20450123456789 и покажи его статус.
- Найди отделения Nova Poshta в Kyiv.
- Рассчитай стоимость доставки из Kyiv во Lviv для посылки весом 5kg.
Как установить novaposhta
Командой платформы
claude mcp add --env NOVA_POSHTA_API_KEY=<NOVA_POSHTA_API_KEY> --env NOVA_POSHTA_SYSTEM=<NOVA_POSHTA_SYSTEM> --env LOG_LEVEL=<LOG_LEVEL> --transport stdio novaposhta-mcp-server -- npx -y @shopana/novaposhta-mcp-serverВместо <…> подставьте свои значения
Командой платформы
codex mcp add novaposhta-mcp-server --env NOVA_POSHTA_API_KEY=<NOVA_POSHTA_API_KEY> --env NOVA_POSHTA_SYSTEM=<NOVA_POSHTA_SYSTEM> --env LOG_LEVEL=<LOG_LEVEL> -- npx -y @shopana/novaposhta-mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"novaposhta-mcp-server": {
"command": "npx",
"args": [
"-y",
"@shopana/novaposhta-mcp-server"
],
"env": {
"NOVA_POSHTA_API_KEY": "<NOVA_POSHTA_API_KEY>",
"NOVA_POSHTA_SYSTEM": "<NOVA_POSHTA_SYSTEM>",
"LOG_LEVEL": "<LOG_LEVEL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"novaposhta-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@shopana/novaposhta-mcp-server"
],
"env": {
"NOVA_POSHTA_API_KEY": "<NOVA_POSHTA_API_KEY>",
"NOVA_POSHTA_SYSTEM": "<NOVA_POSHTA_SYSTEM>",
"LOG_LEVEL": "<LOG_LEVEL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e NOVA_POSHTA_API_KEY=<NOVA_POSHTA_API_KEY> -e NOVA_POSHTA_SYSTEM=<NOVA_POSHTA_SYSTEM> -e LOG_LEVEL=<LOG_LEVEL> novaposhta-mcp-server npx -y @shopana/novaposhta-mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о novaposhta
Как установить novaposhta в Claude Code?
Выполните claude mcp add novaposhta -e NOVA_POSHTA_API_KEY=<NOVA_POSHTA_API_KEY> -- npx -y @shopana/novaposhta-mcp-server. Затем перезапустите или перезагрузите MCP-клиент.
Что делает novaposhta?
Сервер даёт ИИ-ассистенту инструменты Nova Poshta для отслеживания отправлений, поиска адресов и отделений, расчёта доставки и работы с накладными.
Какие операции требуют API-ключ Nova Poshta?
Ключ нужен для операций с накладными, управления адресами, контрагентами и контактными лицами. Отслеживание, поиск адресов и справочные инструменты работают без него.
