mcp-andreani — MCP-сервер для Claude Code: доставка Andreani
Подключает к агенту API аргентинского курьера Andreani: создание отправлений, трекинг, тарифы и этикетки прямо из чата.
claude mcp add mcp-andreani -e ANDREANI_API_KEY=<ANDREANI_API_KEY> -e ANDREANI_USER=<ANDREANI_USER> -e ANDREANI_PASSWORD=<ANDREANI_PASSWORD> -- npx -y @codespar/mcp-andreaniЧто делает mcp-andreani
Сервер даёт агенту 18 инструментов для работы с логистикой Andreani. Создание отправления, проверка статуса по трек-номеру, расчёт тарифов, печать этикетки в PDF, отмена заказа, пункты приёма, заборы курьером и возвраты — всё это вызывается из диалога с Claude или другим клиентом.
Авторизация устроена в два шага: сервер сам логинится по логину и паролю, получает JWT и дальше ходит в API с этим токеном и ключом. Перед запуском нужны три переменные: ANDREANI_API_KEY, ANDREANI_USER и ANDREANI_PASSWORD. Без любой из них сервер не поднимется.
Релиз помечен как alpha: пути запросов взяты из публичной документации и на живом контуре полностью не проверены. Если ставите себе в рабочий проект, фиксируйте точную версию пакета — в ветке 0.x.x-alpha поведение может поменяться между сборками.
Какие задачи решает
- оформить отправление Andreani из чата с агентом
- узнать, где сейчас посылка по трек-номеру
- посчитать стоимость доставки до нужного индекса
- выгрузить этикетку отправления в PDF
- заказать забор посылки курьером и отменить его
Примеры запросов агенту
- Создай отправление Andreani на адрес в Кордове и верни трек-номер
- Проверь историю трекинга для этого трек-номера
- Посчитай тариф доставки до индекса 5000 и покажи доступные услуги
Как установить mcp-andreani
Командой платформы
claude mcp add mcp-andreani -e ANDREANI_API_KEY=<ANDREANI_API_KEY> -e ANDREANI_USER=<ANDREANI_USER> -e ANDREANI_PASSWORD=<ANDREANI_PASSWORD> -- npx -y @codespar/mcp-andreaniВместо <…> подставьте свои значения
Командой платформы
codex mcp add andreani --env ANDREANI_API_KEY=<ANDREANI_API_KEY> --env ANDREANI_USER=<ANDREANI_USER> --env ANDREANI_PASSWORD=<ANDREANI_PASSWORD> -- npx -y @codespar/mcp-andreaniВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"andreani": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-andreani"
],
"env": {
"ANDREANI_API_KEY": "<ANDREANI_API_KEY>",
"ANDREANI_USER": "<ANDREANI_USER>",
"ANDREANI_PASSWORD": "<ANDREANI_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"andreani": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-andreani"
],
"env": {
"ANDREANI_API_KEY": "<ANDREANI_API_KEY>",
"ANDREANI_USER": "<ANDREANI_USER>",
"ANDREANI_PASSWORD": "<ANDREANI_PASSWORD>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e ANDREANI_API_KEY=<ANDREANI_API_KEY> -e ANDREANI_USER=<ANDREANI_USER> -e ANDREANI_PASSWORD=<ANDREANI_PASSWORD> andreani npx -y @codespar/mcp-andreaniВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-andreani
Как установить mcp-andreani в Claude Code?
Одной командой: `claude mcp add mcp-andreani -e ANDREANI_API_KEY=<ANDREANI_API_KEY> -e ANDREANI_USER=<ANDREANI_USER> -e ANDREANI_PASSWORD=<ANDREANI_PASSWORD> -- npx -y @codespar/mcp-andreani`. Подставьте свои значения вместо плейсхолдеров.
Что делает mcp-andreani?
Это MCP-сервер поверх API Andreani. Он даёт агенту инструменты для отправлений, трекинга, тарифов, этикеток, заборов курьером и возвратов.
Что нужно для работы сервера?
Ключ API, логин и пароль Andreani в переменных окружения ANDREANI_API_KEY, ANDREANI_USER, ANDREANI_PASSWORD. Сервер логинится по ним и получает JWT для дальнейших запросов.
