MCP для Почты России

pochta-russia-mcp

MCP-сервер Почты России: трекинг посылок по номеру, расчет стоимости и сроков доставки, поиск отделений и нормализация адреса

MCP-серверРоссийский стек

theyahia/pochta-russia-mcpАвтор:theYahia

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/pochta-russia-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Выполните в терминале

claude mcp add --transport stdio --env 'POCHTA_TOKEN=<ваш POCHTA_TOKEN>' --env 'POCHTA_LOGIN=<ваш POCHTA_LOGIN>' --env 'POCHTA_PASSWORD=<ваш POCHTA_PASSWORD>' pochta -- npx -y @theyahia/pochta-russia-mcp

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "pochta": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/pochta-russia-mcp"
      ],
      "env": {
        "POCHTA_TOKEN": "<ваш POCHTA_TOKEN>",
        "POCHTA_LOGIN": "<ваш POCHTA_LOGIN>",
        "POCHTA_PASSWORD": "<ваш POCHTA_PASSWORD>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

POCHTA_TOKENсекрет, обязательная
POCHTA_LOGINсекрет, обязательная
POCHTA_PASSWORDсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "pochta": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/pochta-russia-mcp"
      ],
      "env": {
        "POCHTA_TOKEN": "<ваш POCHTA_TOKEN>",
        "POCHTA_LOGIN": "<ваш POCHTA_LOGIN>",
        "POCHTA_PASSWORD": "<ваш POCHTA_PASSWORD>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

POCHTA_TOKENсекрет, обязательная
POCHTA_LOGINсекрет, обязательная
POCHTA_PASSWORDсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"pochta","type":"stdio","command":"npx","args":["-y","@theyahia/pochta-russia-mcp"],"env":{"POCHTA_TOKEN":"<ваш POCHTA_TOKEN>","POCHTA_LOGIN":"<ваш POCHTA_LOGIN>","POCHTA_PASSWORD":"<ваш POCHTA_PASSWORD>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "pochta": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/pochta-russia-mcp"
      ],
      "env": {
        "POCHTA_TOKEN": "<ваш POCHTA_TOKEN>",
        "POCHTA_LOGIN": "<ваш POCHTA_LOGIN>",
        "POCHTA_PASSWORD": "<ваш POCHTA_PASSWORD>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

POCHTA_TOKENсекрет, обязательная
POCHTA_LOGINсекрет, обязательная
POCHTA_PASSWORDсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add pochta --env 'POCHTA_TOKEN=<ваш POCHTA_TOKEN>' --env 'POCHTA_LOGIN=<ваш POCHTA_LOGIN>' --env 'POCHTA_PASSWORD=<ваш POCHTA_PASSWORD>' -- npx -y @theyahia/pochta-russia-mcp

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.pochta]
command = "npx"
args = ["-y", "@theyahia/pochta-russia-mcp"]
env = { POCHTA_TOKEN = "<ваш POCHTA_TOKEN>", POCHTA_LOGIN = "<ваш POCHTA_LOGIN>", POCHTA_PASSWORD = "<ваш POCHTA_PASSWORD>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

POCHTA_TOKENсекрет, обязательная
POCHTA_LOGINсекрет, обязательная
POCHTA_PASSWORDсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "pochta": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/pochta-russia-mcp"
      ],
      "env": {
        "POCHTA_TOKEN": "<ваш POCHTA_TOKEN>",
        "POCHTA_LOGIN": "<ваш POCHTA_LOGIN>",
        "POCHTA_PASSWORD": "<ваш POCHTA_PASSWORD>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

POCHTA_TOKENсекрет, обязательная
POCHTA_LOGINсекрет, обязательная
POCHTA_PASSWORDсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "pochta": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/pochta-russia-mcp"
      ],
      "env": {
        "POCHTA_TOKEN": "<ваш POCHTA_TOKEN>",
        "POCHTA_LOGIN": "<ваш POCHTA_LOGIN>",
        "POCHTA_PASSWORD": "<ваш POCHTA_PASSWORD>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

POCHTA_TOKENсекрет, обязательная
POCHTA_LOGINсекрет, обязательная
POCHTA_PASSWORDсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "pochta": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/pochta-russia-mcp"
      ],
      "env": {
        "POCHTA_TOKEN": "<ваш POCHTA_TOKEN>",
        "POCHTA_LOGIN": "<ваш POCHTA_LOGIN>",
        "POCHTA_PASSWORD": "<ваш POCHTA_PASSWORD>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

POCHTA_TOKENсекрет, обязательная
POCHTA_LOGINсекрет, обязательная
POCHTA_PASSWORDсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "pochta": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/pochta-russia-mcp"
      ],
      "env": {
        "POCHTA_TOKEN": "<ваш POCHTA_TOKEN>",
        "POCHTA_LOGIN": "<ваш POCHTA_LOGIN>",
        "POCHTA_PASSWORD": "<ваш POCHTA_PASSWORD>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

POCHTA_TOKENсекрет, обязательная
POCHTA_LOGINсекрет, обязательная
POCHTA_PASSWORDсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "pochta": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@theyahia/pochta-russia-mcp"
      ],
      "environment": {
        "POCHTA_TOKEN": "<ваш POCHTA_TOKEN>",
        "POCHTA_LOGIN": "<ваш POCHTA_LOGIN>",
        "POCHTA_PASSWORD": "<ваш POCHTA_PASSWORD>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

POCHTA_TOKENсекрет, обязательная
POCHTA_LOGINсекрет, обязательная
POCHTA_PASSWORDсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "pochta": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/pochta-russia-mcp"
      ],
      "env": {
        "POCHTA_TOKEN": "<ваш POCHTA_TOKEN>",
        "POCHTA_LOGIN": "<ваш POCHTA_LOGIN>",
        "POCHTA_PASSWORD": "<ваш POCHTA_PASSWORD>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

POCHTA_TOKENсекрет, обязательная
POCHTA_LOGINсекрет, обязательная
POCHTA_PASSWORDсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "pochta": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/pochta-russia-mcp"
      ],
      "env": {
        "POCHTA_TOKEN": "<ваш POCHTA_TOKEN>",
        "POCHTA_LOGIN": "<ваш POCHTA_LOGIN>",
        "POCHTA_PASSWORD": "<ваш POCHTA_PASSWORD>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

POCHTA_TOKENсекрет, обязательная
POCHTA_LOGINсекрет, обязательная
POCHTA_PASSWORDсекрет, обязательная

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит 26cae85.

Текст для агента

Получи POCHTA_TOKEN, POCHTA_LOGIN и POCHTA_PASSWORD в личном кабинете otpravka.pochta.ru, затем добавь сервер командой claude mcp add pochta -e POCHTA_TOKEN=... -e POCHTA_LOGIN=... -e POCHTA_PASSWORD=... -- npx -y @theyahia/pochta-russia-mcp.

Другие способы из описания автора

claude mcp add pochta -e POCHTA_TOKEN=<ACCESS_TOKEN> -e POCHTA_LOGIN=<LOGIN> -e POCHTA_PASSWORD=<PASSWORD> -- npx -y @theyahia/pochta-russia-mcp

Команда из README для Claude Code.

Проверка безопасности

Как мы проверяем

Низкий рискНизкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.

Только читает статус, стоимость, отделения и индексы, не оформляет и не меняет отправления

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер на TypeScript дает 6 инструментов поверх API Почты России: track для отслеживания по трек-номеру через SOAP-трекинг, calculate и delivery_time для расчета стоимости и сроков доставки, get_offices для поиска отделений, zip_lookup для справки по индексу и normalize_address для нормализации адреса. Публикуется в npm как @theyahia/pochta-russia-mcp и запускается через npx по stdio или как Streamable HTTP сервер с отдельным портом. Авторизация REST-методов otpravka-api требует access-токен приложения и логин с паролем личного кабинета вместе, трекинг работает только по логину и паролю через отдельный SOAP-API.

Для кого. Для интернет-магазинов и отправителей, которые считают доставку Почтой России и следят за посылками из чата с агентом.

Подходит, если

Нужно узнать статус посылки по трек-номеру без сайта с капчей
Нужно посчитать стоимость и срок доставки между двумя индексами
Нужно найти ближайшее отделение или нормализовать адрес получателя

Не подходит, если

Нужно создавать и оформлять отправления, а не только считать и отслеживать: таких инструментов в сервере нет
Нет доступа к личному кабинету отправителя на otpravka.pochta.ru: без него токен и пароль не получить

Пример запроса к агенту

Где сейчас посылка с трек-номером 12345678901234 и сколько еще идти до Новосибирска

MCP

Транспорт: stdio, http
Авторизация: API-ключ

Переменные окружения

POCHTA_TOKEN обязательная, секрет: Access-токен приложения для REST-методов otpravka-api
POCHTA_LOGIN обязательная, секрет: Логин личного кабинета отправителя
POCHTA_PASSWORD обязательная, секрет: Пароль личного кабинета отправителя

Ограничения

Нужны три параметра одновременно: POCHTA_TOKEN, POCHTA_LOGIN и POCHTA_PASSWORD, получить их можно только через личный кабинет отправителя. Версия 2.0.0 меняет контракт авторизации, старая связка POCHTA_TOKEN и POCHTA_KEY больше не работает сама по себе. Тот же функционал в урезанном виде входит в монорепозиторий автора wwmcp вместе с десятками других российских сервисов, это отдельный однопакетный вариант той же кодовой базы.

Как отключить. Удалите сервер pochta из настроек MCP-клиента, например claude mcp remove pochta.

Частые вопросы

Хватит ли только логина и пароля без токена?

Для трекинга (SOAP-API) да, для расчета стоимости, поиска отделений и нормализации адреса нужен еще POCHTA_TOKEN.

Что изменилось в версии 2.0.0?

Раньше заголовки авторизации формировались неверно, из-за чего REST-методы не проходили проверку. Теперь используется набор POCHTA_TOKEN плюс POCHTA_LOGIN и POCHTA_PASSWORD, а старый POCHTA_KEY остался опциональным для обратной совместимости.

MCP-серверы

n8n-MCP

Выбор редакции

MCP-сервер со справкой по нодам и шаблонам n8n: агент подбирает ноды, проверяет конфигурацию и при наличии API создает воркфлоу в вашем n8n

MCP-серверВысокий риск23 тыс.

Zapier MCP

Официальный

Официальный плагин Zapier MCP: агент получает доступ к действиям в тысячах приложений через подключенный аккаунт Zapier

ПлагинВысокий риск421

Awesome Claude Skills от Composio

Awesome Claude Skills

Каталог скиллов и плагинов для Claude и других агентов, плюс собственные скиллы автоматизации 78 SaaS-сервисов через Composio

СкиллВысокий риск75,8 тыс.

CLI-Anything

Плагин и каталог CLI для агентов: генерирует командный интерфейс к GUI-программам вроде GIMP и Blender и ставит готовые через CLI-Hub

ПлагинВысокий риск51 тыс.

Коротко о README

README перечисляет 6 инструментов таблицей с указанием, какие переменные нужны каждому, объясняет разницу между REST-авторизацией otpravka-api через два заголовка и отдельным SOAP-трекингом, описывает breaking change версии 2.0.0, показывает конфиги для Claude Desktop, Cursor, Windsurf и Claude Code, режим Streamable HTTP с health-check и три готовых скилла Claude Code: /track, /calculate, /parcel.

Установка

Проверка безопасности

Что делает

Подходит, если

Не подходит, если

Пример запроса к агенту

MCP

Переменные окружения

Ограничения

Частые вопросы

Похожие

n8n-MCP

Zapier MCP

Awesome Claude Skills от Composio

CLI-Anything

Коротко о README