costco — MCP-сервер для Claude Code: что делает и как установить
Подключает историю покупок из сети Costco к вашему ИИ-ассистенту. Позволяет запрашивать чеки из оффлайн-складов и онлайн-заказы без выгрузки файлов вручную.
claude mcp add costco -- uvx costco-mcp-serverЧто делает costco
Сервер связывается с внутренним GraphQL API Costco напрямую через протокол HTTP/2. Для работы не нужен браузер. Данные приходят в виде чеков с позициями и скидками. Каталог товаров кешируется локально в SQLite по пути ~/.costco-mcp/products.db.
Авторизация построена на refresh-токенах Azure AD B2C со сроком действия около 90 дней. Токен берут из хранилища браузера вручную или запускают скрипт costco-auth-browser. Профиль можно переключать. Сервер поддерживает раздельные конфигурации для личного или семейного аккаунта.
Инструмент опирается на неофициальные эндпоинты сети. Любые изменения на серверах магазина сломают интеграцию. Токены лежат на диске в открытом виде в папке ~/.costco-mcp/, поэтому безопасность зависит от прав на домашнюю папку.
Какие задачи решает
- получить детализацию покупок из физических складов по штрихкоду чека
- выгрузить список онлайн-заказов за выбранный диапазон дат
- узнать наименования товаров и отделы по внутренним артикулам
- вести раздельный учёт расходов для нескольких аккаунтов
Примеры запросов агенту
- Покажи все чеки из магазина Costco за прошлый месяц по аккаунту personal
- Найди в истории онлайн-заказов позиции со словом coffee
- Разбери чек со штрихкодом 123456789 и покажи итоговую сумму скидок
Как установить costco
Командой платформы
claude mcp add costco -- uvx costco-mcp-serveruvx запускает команду с именем пакета; если в README она другая — uvx --from costco-mcp-server <команда>
Командой платформы
codex mcp add costco -- uvx costco-mcp-serveruvx запускает команду с именем пакета; если в README она другая — uvx --from costco-mcp-server <команда>
Файл настроек
{
"mcpServers": {
"costco": {
"command": "uvx",
"args": [
"costco-mcp-server"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from costco-mcp-server <команда>
Файл настроек
{
"servers": {
"costco": {
"type": "stdio",
"command": "uvx",
"args": [
"costco-mcp-server"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from costco-mcp-server <команда>
Командой платформы
gemini mcp add costco uvx costco-mcp-serveruvx запускает команду с именем пакета; если в README она другая — uvx --from costco-mcp-server <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о costco
Как установить costco в Claude Code?
Выполните команду claude mcp add costco -- uvx costco-mcp-server. Для запуска потребуются утилита uvx и установленный Python.
Откуда сервер берёт данные о покупках?
Он отправляет HTTP/2-запросы к GraphQL-эндпоинтам ecom-api.costco.com. Вся информация забирается напрямую из API магазина, минуя веб-скрапинг.
Безопасно ли хранить токены в системе?
Сервер не запрашивает логин и пароль от аккаунта, но сохраняет refresh-токен в открытом виде внутри папки ~/.costco-mcp/. Доступ к нему ограничивается только стандартными правами вашей операционной системы.
