# mcp-correios

Подключает бразильскую почтовую службу Correios к ИИ-ассистенту. Помогает отслеживать посылки, считать тарифы на доставку и находить адреса по почтовым индексам CEP.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Автор: codespar
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/ecommerce/correios
- Обновлён: 2026-09-27
- HTML: https://affpapa.org/nevibecode/mcp/mcp-correios

## Что делает

Сервер предоставляет 21 инструмент для взаимодействия с API Correios. С его помощью ассистент проверяет статус отправлений по одному или списками до 50 штук, вычисляет стоимость пересылки между регионами и запрашивает расчётные сроки вручения. Также доступен пакетный поиск адресов по базе CEP с лимитом до 20 индексов за один вызов.

В набор входят функции для логистики полного цикла: заказ диапазонов этикеток SIGEP, закрытие партий PLP, вызов курьера для забора посылок и оформление возвратов. Авторизация автоматизирована: сервис сам обменивает базовые учётные данные на сессионные токены доступа.

Для реальной работы обязателен действующий контракт с Correios и аккаунт на портале CWS. Без переменных окружения `CORREIOS_USER` и `CORREIOS_TOKEN` обращения к почтовым эндпоинтам завершатся ошибкой. Проект находится на стадии альфа-версии, поэтому создатели советуют фиксировать конкретную версию пакета в настройках.

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

## Установка

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

**Командой платформы**
```bash
claude mcp add mcp-correios -e CORREIOS_TOKEN=<CORREIOS_TOKEN> -- npx -y @codespar/mcp-correios
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add correios --env CORREIOS_TOKEN=<CORREIOS_TOKEN> -- npx -y @codespar/mcp-correios
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "correios": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-correios"
            ],
            "env": {
                "CORREIOS_TOKEN": "<CORREIOS_TOKEN>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "correios": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-correios"
            ],
            "env": {
                "CORREIOS_TOKEN": "<CORREIOS_TOKEN>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e CORREIOS_TOKEN=<CORREIOS_TOKEN> correios npx -y @codespar/mcp-correios
```
Вместо <…> подставьте свои значения

## Когда брать
- проверить статус доставки бразильской посылки по трек-номеру
- рассчитать тариф и ориентировочный срок доставки между двумя CEP
- найти улицу и город по почтовому индексу Бразилии
- оформить предварительную накладную и закрыть партию отправлений SIGEP
- создать заявку на вывоз посылки курьером или возврат товара

## Примеры запросов агенту
- Проверь статус доставки посылки с трек-номером `AA123456789BR` через Correios
- Посчитай стоимость отправки груза из CEP `01001-000` в CEP `20040-002`
- Найди адрес для бразильского почтового индекса `70040-010`

## Похожие
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16717
- [PostHog MCP Server](https://affpapa.org/nevibecode/mcp/posthog-mcp-server.md) — MCP-сервер · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/nevibecode/mcp/openwork-mcp-gateway.md) — MCP-сервер · ★ 24242
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18727
- [Nhost](https://affpapa.org/nevibecode/mcp/nhost.md) — MCP-сервер · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP-сервер · ★ 7506

Из того же набора: [codespar/mcp-dev-latam](https://affpapa.org/nevibecode/by/codespar/mcp-dev-latam.md) — 124 карточки

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