# novaposhta

Подключает Nova Poshta API к ИИ-ассистентам для отслеживания отправлений, поиска адресов и работы с накладными.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Автор: shopanaio
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/shopanaio/carrier-api/tree/HEAD/packages/novaposhta-mcp-server
- Обновлён: 2026-10-21
- HTML: https://affpapa.org/nevibecode/mcp/novaposhta

## Что делает

MCP-сервер добавляет в ИИ-ассистент инструменты Nova Poshta: отслеживание одной или нескольких отправлений, просмотр движения и списка документов, поиск городов, улиц и отделений. Он также умеет считать стоимость и управлять накладными, а через справочные инструменты отдаёт типы грузов и услуг.

Сервер запускается через `npx` в режиме `stdio`; настройки задаются переменными `NOVA_POSHTA_API_KEY`, `NOVA_POSHTA_SYSTEM` и `LOG_LEVEL`. Ключ API нужен для операций с накладными, управления адресами, контрагентами и контактными лицами. Отслеживание, поиск адресов и справочники работают без ключа.

Без `NOVA_POSHTA_API_KEY` операции создания, изменения и удаления накладных не выполнятся. После изменения конфигурации MCP-клиент нужно перезапустить или перезагрузить.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `NOVA_POSHTA_API_KEY`, `NOVA_POSHTA_SYSTEM`, `LOG_LEVEL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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
```
Вместо <…> подставьте свои значения

## Когда брать
- отследить одну или несколько посылок Nova Poshta
- найти города, улицы и отделения
- рассчитать стоимость доставки
- создать или изменить накладную
- получить справочные данные о доставке

## Примеры запросов агенту
- Отследи отправление Nova Poshta по номеру 20450123456789 и покажи его статус.
- Найди отделения Nova Poshta в Kyiv.
- Рассчитай стоимость доставки из Kyiv во Lviv для посылки весом 5kg.

## Похожие
- [mcp-melhor-envio](https://affpapa.org/nevibecode/mcp/mcp-melhor-envio.md) — MCP-сервер · ★ 274
- [c-tracking](https://affpapa.org/nevibecode/skills/c-tracking.md) — скилл · ★ 173
- [mcp-skydropx](https://affpapa.org/nevibecode/mcp/mcp-skydropx.md) — MCP-сервер · ★ 274
- [ae-data-integration-helper](https://affpapa.org/nevibecode/skills/ae-data-integration-helper.md) — скилл · 791 установка
- [ae-generate-tracking-code](https://affpapa.org/nevibecode/skills/ae-generate-tracking-code.md) — скилл · 789 установок
- [Vessel Traffic MCP](https://affpapa.org/nevibecode/mcp/vessel-traffic-mcp.md) — MCP-сервер · ★ 8

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