Kroger MCP Server

Интегрирует публичный API Kroger с Claude, чтобы списки продуктов из плана питания можно было добавлять прямо в вашу корзину Kroger.

Инструменты

Related MCP server: Tiv Taam MCP Server

Настройка

Шаг 1 — Зарегистрируйте свое приложение на портале разработчиков Kroger

1. Перейдите на https://developer.kroger.com

2. Нажмите Register App

3. Заполните:

   • App Name: Meal Plan Assistant (или любое другое)

   • Redirect URI: http://localhost:8080/callback

   • Scopes: product.compact, cart.basic:write, profile.compact

4. Скопируйте свои Client ID и Client Secret

Шаг 2 — Установите зависимости

cd kroger_mcp
python3 -m venv venv
source venv/bin/activate        # Windows: venv\Scripts\activate
pip install -r requirements.txt

Шаг 3 — Установите переменные окружения

export KROGER_CLIENT_ID=your_client_id_here
export KROGER_CLIENT_SECRET=your_client_secret_here
export KROGER_REDIRECT_URI=http://localhost:8080/callback

Добавьте их в профиль вашей оболочки (~/.zshrc или ~/.bashrc), чтобы они сохранялись.

Шаг 4 — Подключитесь к Claude

Добавьте в конфигурацию Claude MCP (обычно ~/Library/Application Support/Claude/claude_desktop_config.json на Mac):

{
  "mcpServers": {
    "kroger": {
      "command": "/path/to/kroger_mcp/venv/bin/python",
      "args": ["/path/to/kroger_mcp/server.py"],
      "env": {
        "KROGER_CLIENT_ID": "your_client_id",
        "KROGER_CLIENT_SECRET": "your_client_secret",
        "KROGER_REDIRECT_URI": "http://localhost:8080/callback"
      }
    }
  }
}

После сохранения перезапустите Claude Desktop.

Первое использование — OAuth-авторизация

Когда вы впервые попросите Claude добавить товары в корзину:

1. В браузере откроется страница входа Kroger

2. Войдите в свою учетную запись Kroger

3. Вставьте URL перенаправления обратно в терминал

4. Готово — токены сохранены в ~/.kroger_mcp_tokens.json

После этого Claude сможет добавлять товары в корзину автоматически, используя сохраненный токен обновления.

Пример использования

После подключения вы можете сказать Claude:

"Найди ближайший ко мне магазин Kroger и добавь список продуктов на эту неделю в мою корзину"

Claude выполнит следующее:

1. Вызовет kroger_find_store с вашим почтовым индексом

2. Вызовет kroger_add_grocery_list со всеми товарами

3. Сообщит, что было добавлено, что пропущено и возникли ли какие-либо проблемы

Примечания по безопасности

• Ваш Client ID и Secret — ваши, они зарегистрированы под вашей учетной записью

• Токены хранятся локально в ~/.kroger_mcp_tokens.json (права доступа: 600)

• Сторонний код не используется — только прямые вызовы официального API Kroger

• kroger_clear_auth удаляет все сохраненные токены при необходимости

Устранение неполадок

"Missing environment variables" — Установите KROGER_CLIENT_ID и KROGER_CLIENT_SECRET

"Authorization expired" — Повторите операцию; сервер обновит авторизацию автоматически

"No matching product found" — Попробуйте более короткий поисковый запрос (например, "spinach" вместо "Private Selection Baby Spinach")

Ограничения скорости (HTTP 429) — Kroger ограничивает количество запросов; подождите 30 секунд и повторите попытку