# Easyship

Easyship подключает ИИ-агента к сервису доставки: он сравнивает тарифы перевозчиков, оформляет отправления, покупает этикетки и отслеживает посылки. Пригодится для работы с международными заказами и логистикой.

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

## Что делает

Easyship даёт агенту доступ к операциям доставки через MCP. Можно сравнивать предложения перевозчиков с учётом стоимости, сроков и расчётных налогов, создавать и отменять отправления, получать транспортные этикетки и документы. Сервер также поддерживает проверку адресов для отправлений по США и за рубеж, планирование курьерского забора и просмотр платёжных документов.

Для аналитики доступны данные об объёмах отправлений, популярных направлениях, использовании перевозчиков и статусах доставки. Подключение работает через удалённый MCP-сервер по HTTP либо через локальный пакет `easyship-mcp`, запускаемый командой `uvx`. Локальный вариант требует Python. Для авторизации нужен API-токен Easyship.

Установка доступна в Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed и Gemini CLI. Удалённое подключение не требует локального запуска пакета. У MCP нет отдельной тестовой среды: покупка этикетки и другие действия, расходующие кредиты, приводят к реальным списаниям, поэтому для первых проверок рекомендуется токен с ограниченными правами.

## Требования
- Нужно: Python и uv (команды через uvx)
- Удалённый сервер: `https://mcp.easyship.com/mcp`
- Переменные окружения: `EASYSHIP_API_ACCESS_TOKEN` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mcp https://mcp.easyship.com/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env EASYSHIP_API_ACCESS_TOKEN=<EASYSHIP_API_ACCESS_TOKEN> --transport stdio easyship -- uvx easyship-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from easyship-mcp <команда>

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add easyship --url https://mcp.easyship.com/mcp
```

2. **Командой платформы**
```bash
codex mcp add easyship --env EASYSHIP_API_ACCESS_TOKEN=<EASYSHIP_API_ACCESS_TOKEN> -- uvx easyship-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from easyship-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "easyship": {
            "url": "https://mcp.easyship.com/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "easyship": {
            "command": "uvx",
            "args": [
                "easyship-mcp"
            ],
            "env": {
                "EASYSHIP_API_ACCESS_TOKEN": "<EASYSHIP_API_ACCESS_TOKEN>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from easyship-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "easyship": {
            "type": "http",
            "url": "https://mcp.easyship.com/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "easyship": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "easyship-mcp"
            ],
            "env": {
                "EASYSHIP_API_ACCESS_TOKEN": "<EASYSHIP_API_ACCESS_TOKEN>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from easyship-mcp <команда>

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http easyship https://mcp.easyship.com/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e EASYSHIP_API_ACCESS_TOKEN=<EASYSHIP_API_ACCESS_TOKEN> easyship uvx easyship-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from easyship-mcp <команда>

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

## Примеры запросов агенту
- Сравни варианты доставки посылки весом 1.5 кг из Гонконга в Нью-Йорк для упаковки размером 30×20×15 см.
- Отследи отправление `ESSG10006001` и проверь его текущий статус.
- Найди ближайшую доступную дату забора курьером для отправления `ESSG10006001`.

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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