Servidor MCP de Kroger

Integra la API pública de Kroger con Claude para que las listas de la compra de planes de comidas puedan añadirse directamente a tu carrito de Kroger.

Herramientas

Related MCP server: Tiv Taam MCP Server

Configuración

Paso 1 — Registra tu aplicación en el Portal de Desarrolladores de Kroger

1. Ve a https://developer.kroger.com

2. Haz clic en Register App

3. Rellena:

   • Nombre de la aplicación: Meal Plan Assistant (o cualquier otro)

   • URI de redirección: http://localhost:8080/callback

   • Alcances (Scopes): product.compact, cart.basic:write, profile.compact

4. Copia tu Client ID y Client Secret

Paso 2 — Instala las dependencias

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

Paso 3 — Configura las variables de entorno

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

Añádelas a tu perfil de shell (~/.zshrc o ~/.bashrc) para que persistan.

Paso 4 — Conecta con Claude

Añádelo a tu configuración de MCP de Claude (normalmente ~/Library/Application Support/Claude/claude_desktop_config.json en 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"
      }
    }
  }
}

Reinicia Claude Desktop después de guardar.

Primer uso — Inicio de sesión OAuth

La primera vez que le pidas a Claude que añada artículos a tu carrito:

1. Tu navegador se abrirá en la página de inicio de sesión de Kroger

2. Inicia sesión con tu cuenta de Kroger

3. Pega la URL de redirección de vuelta en el terminal

4. Listo — los tokens se guardan en ~/.kroger_mcp_tokens.json

Después de eso, Claude puede añadir artículos a tu carrito silenciosamente usando el token de actualización almacenado.

Ejemplo de flujo

Una vez conectado, puedes decirle a Claude:

"Encuentra mi tienda Kroger más cercana y añade la lista de la compra de esta semana a mi carrito"

Claude hará lo siguiente:

1. Llamará a kroger_find_store con tu código postal

2. Llamará a kroger_add_grocery_list con todos los artículos

3. Informará de lo que se añadió, lo que se omitió y cualquier problema

Notas de seguridad

• Tu Client ID y Secret son tuyos — registrados bajo tu cuenta

• Los tokens se almacenan localmente en ~/.kroger_mcp_tokens.json (permisos: 600)

• No hay código de terceros involucrado — llamadas directas a la API oficial de Kroger

• kroger_clear_auth elimina todos los tokens almacenados si es necesario

Solución de problemas

"Missing environment variables" — Configura KROGER_CLIENT_ID y KROGER_CLIENT_SECRET

"Authorization expired" — Vuelve a intentar la operación; el servidor se actualizará automáticamente

"No matching product found" — Prueba con un término de búsqueda más corto (p. ej., "espinacas" en lugar de "Private Selection Baby Spinach")

Límites de tasa (HTTP 429) — Kroger limita las solicitudes; espera 30 segundos y vuelve a intentarlo