mcp-correios — MCP-сервер для Claude Code: обзор и установка
Подключает бразильскую почтовую службу Correios к ИИ-ассистенту. Помогает отслеживать посылки, считать тарифы на доставку и находить адреса по почтовым индексам CEP.
claude mcp add mcp-correios -e CORREIOS_TOKEN=<CORREIOS_TOKEN> -- npx -y @codespar/mcp-correiosЧто делает mcp-correios
Сервер предоставляет 21 инструмент для взаимодействия с API Correios. С его помощью ассистент проверяет статус отправлений по одному или списками до 50 штук, вычисляет стоимость пересылки между регионами и запрашивает расчётные сроки вручения. Также доступен пакетный поиск адресов по базе CEP с лимитом до 20 индексов за один вызов.
В набор входят функции для логистики полного цикла: заказ диапазонов этикеток SIGEP, закрытие партий PLP, вызов курьера для забора посылок и оформление возвратов. Авторизация автоматизирована: сервис сам обменивает базовые учётные данные на сессионные токены доступа.
Для реальной работы обязателен действующий контракт с Correios и аккаунт на портале CWS. Без переменных окружения CORREIOS_USER и CORREIOS_TOKEN обращения к почтовым эндпоинтам завершатся ошибкой. Проект находится на стадии альфа-версии, поэтому создатели советуют фиксировать конкретную версию пакета в настройках.
Какие задачи решает
- проверить статус доставки бразильской посылки по трек-номеру
- рассчитать тариф и ориентировочный срок доставки между двумя CEP
- найти улицу и город по почтовому индексу Бразилии
- оформить предварительную накладную и закрыть партию отправлений SIGEP
- создать заявку на вывоз посылки курьером или возврат товара
Примеры запросов агенту
- Проверь статус доставки посылки с трек-номером
AA123456789BRчерез Correios - Посчитай стоимость отправки груза из CEP
01001-000в CEP20040-002 - Найди адрес для бразильского почтового индекса
70040-010
Как установить mcp-correios
Командой платформы
claude mcp add mcp-correios -e CORREIOS_TOKEN=<CORREIOS_TOKEN> -- npx -y @codespar/mcp-correiosВместо <…> подставьте свои значения
Командой платформы
codex mcp add correios --env CORREIOS_TOKEN=<CORREIOS_TOKEN> -- npx -y @codespar/mcp-correiosВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"correios": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-correios"
],
"env": {
"CORREIOS_TOKEN": "<CORREIOS_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"correios": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-correios"
],
"env": {
"CORREIOS_TOKEN": "<CORREIOS_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e CORREIOS_TOKEN=<CORREIOS_TOKEN> correios npx -y @codespar/mcp-correiosВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-correios
Как установить mcp-correios в Claude Code?
Выполните в терминале команду claude mcp add mcp-correios -e CORREIOS_TOKEN=<CORREIOS_TOKEN> -- npx -y @codespar/mcp-correios. Вместо плейсхолдера передайте ваш рабочий токен.
Что делает mcp-correios?
Инструмент связывает почтовые сервисы Correios с языковой моделью. Он рассчитывает тарифы, находит адреса по CEP, отслеживает посылки и оформляет документы на отправку или возврат грузов.
Какие данные нужны для авторизации в API Correios?
Потребуются логин CORREIOS_USER и токен CORREIOS_TOKEN, полученные в портале Correios CWS. Для их генерации требуется предварительно заключить коммерческий договор с почтой Бразилии.
