Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Albert Heijn

de olekpuchkaversión 1.10.0i★ 1iSe ejecuta en tu computadoraRepositorio ↗
Nombre en el registroio.github.olekpuchka/albert-heijn-mcp

Cómo instalar

What it does

Unofficial Albert Heijn server: products, bonus deals, recipes, shopping list, orders and receipts.

  • Connects Se ejecuta en tu computadora
  • Account or key No key needed
  • Category Tiendas en línea y pagos

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad22/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso34/100

Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: 42 (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Albert Heijn. Sigue https://mcp.popnx.com/i/olekpuchka-albert-heijn-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 13 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Que la IA lo instale

Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Albert Heijn para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "albert-heijn": { "command": "npx", "args": [ "-y", "albert-heijn-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Albert Heijn aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  3. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "albert-heijn": {
          "command": "npx",
          "args": [
            "-y",
            "albert-heijn-mcp"
          ]
        }
      }
    }
  4. Cierra Claude y vuelve a abrirlo

  5. Pruébalo

    Usa Albert Heijn y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Albert Heijn o muestra una herramienta de Albert Heijn en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Albert Heijn

Albert Heijn se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Albert Heijn

  • Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Instala Node.js en tu computadora primero (una sola vez)
  • Instala Node.js en tu computadora primero (una sola vez)
  • Instala Node.js en tu computadora primero (una sola vez)

B · Otros en Tiendas en línea y pagos que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Albert Heijn para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user albert-heijn -- npx -y albert-heijn-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Albert Heijn aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  3. Pega este comando y pulsa Enter

    claude mcp add --scope user albert-heijn -- npx -y albert-heijn-mcp
  4. Escribe /mcp en Claude Code

    Deberías ver Albert Heijn en la lista como conectado

  5. Pruébalo

    Usa Albert Heijn y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Albert Heijn o muestra una herramienta de Albert Heijn en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Albert Heijn para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "albert-heijn": { "command": "npx", "args": [ "-y", "albert-heijn-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Albert Heijn aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de Cursor en modo Agent

  4. Pruébalo

    Usa Albert Heijn y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Albert Heijn o muestra una herramienta de Albert Heijn en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Albert Heijn para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "albert-heijn": { "type": "stdio", "command": "npx", "args": [ "-y", "albert-heijn-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Albert Heijn aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de VS Code en modo Agent

  4. Pruébalo

    Usa Albert Heijn y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Albert Heijn o muestra una herramienta de Albert Heijn en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Albert Heijn💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user albert-heijn -- npx -y albert-heijn-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "albert-heijn": {
      "command": "npx",
      "args": [
        "-y",
        "albert-heijn-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "albert-heijn": {
      "command": "npx",
      "args": [
        "-y",
        "albert-heijn-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "albert-heijn": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "albert-heijn-mcp"
      ]
    }
  }
}

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
844/sem
Licenciai
Apache-2.0
Conexión
Se ejecuta en tu computadora
Última versióni
1.10.0
Publicado en el registroi
13 nov 2026
Último cambio de códigoi
13 nov 2026
Creador
olekpuchka
Paquetes
npm: albert-heijn-mcp
Sitio web
github.com
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub olekpuchka, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 6 días

  • ✓ Superada

    Tiene licencia

    Usa Apache-2.0

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para albert-heijn-mcp@1.10.0

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/olekpuchka-albert-heijn-mcp.svg)](https://mcp.popnx.com/en/servers/olekpuchka-albert-heijn-mcp)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Tiendas en línea y pagosi

  • Más estrellas que el 89% de los otros 2919 servidores de esta categoría
  • Publicado en el registro más recientemente que el 84% de los otros 2919 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 2919 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Albert Heijn?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 6 días, y la última versión (1.10.0) llegó al registro hace 6 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Stripe MCP, flightclaw, Trade It, Marketplace Ad Pros: Amazon Ads & Seller Central, idealo MCP Server

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Stripe MCP

MCP server integrating with Stripe - tools for customers, products, payments, and more.

de stripeMuy usado★ 2,1 milActualizado hace 13 meses

Se ejecuta en la nube✓ del servicio · stripe.com

flightclaw

Search ~300 airlines and book flights with a checkout link. OAuth sign-in by email code.

de flightclawEn crecimiento★ 86Actualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · flightclaw.com

Trade It

Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.

de trade-it-incInicial★ 62Actualizado hace 34 días

Se ejecuta en la nube✓ del servicio · tradeit.app

idealo MCP Server

Search products, compare prices and discover deals across 6 European markets with your AI assistant.

de idealoInicial★ 28Actualizado hace 6 meses

Se ejecuta en la nube✓ del servicio · mcp.idealo.com
Comparado con otros parecidos
Este
Albert Heijn
Stripe MCPflightclawTrade ItMarketplace Ad Pros: Amazon Ads & Seller Centralidealo MCP Server
Dónde se ejecutaSe instala en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveNoNoNoNoNoNo
Se añade con + en ClaudeNoSíNoNoNoNo
Revisiones básicas3/34/44/45/54/44/4
LicenciaApache-2.0MITMITCC0-1.0MITMIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

albert-heijn-mcp

Your Albert Heijn account, in your AI assistant.

Connect your Albert Heijn account to an AI assistant such as Claude, ChatGPT or Cursor, and do your grocery shopping by just asking. Find products and bonus deals, plan meals from Allerhande recipes, keep your shopping list and delivery order up to date, and look back at what you've bought.

Technically, it's a Model Context Protocol (MCP) server for Albert Heijn 🇳🇱. MCP is the standard way AI apps connect to other services, so it works with any app that supports MCP.

[!NOTE]

An unofficial project, not affiliated with or endorsed by Albert Heijn. It uses the same API as the AH mobile app, which may change without notice.


Contents

For everyone

  • What you can ask
  • Getting started: connect your app, then log in
  • Troubleshooting

Technical details

  • Running it on a server for ChatGPT and Claude.ai
  • Configuration
  • Tools and limitations
  • Development

What you can ask

Ask in Dutch, English or any language your assistant speaks:

*"Wat is er deze week in de bonus van wat ik meestal koop?"*

Plan meals

*"Find a vegetarian Allerhande recipe under 30 minutes for two, and put the ingredients on my shopping list. I already have olive oil and salt."*

*"Scale the panlasagne recipe to six people and tell me how much salmon I need."*

*"Plan three weeknight dinners around what's on bonus this week."*

*"Put everything for the recipes in my AH meal planner on my shopping list."*

Save money

*"Which products I usually buy are on bonus this week?"*

*"Rebuild tonight's stir-fry with ingredients that are on bonus, without changing the recipe too much."*

*"Is next week's bonus out yet? If not, when does it appear?"*

*"Which of my personal offers are worth activating this week?"*

*"How many koopzegels do I have, and what are they worth?"*

*"What's in the 2+1 gratis kaas deal?"*

Shop

*"Put the products I buy most back on my list."*

*"What's this product, and is it on bonus?"* (with a photo of its barcode)

*"What's the cheapest cheese at AH right now?"*

*"Find organic, gluten-free pasta, cheapest first."*

*"Compare the protein and sugar in these three yoghurts and add the best one to my list."*

*"When can AH deliver on Saturday?"*

*"The courgettes are sold out. What else would work in this recipe?"*

*"Add two more packs of milk to my upcoming delivery."*

*"Make a favourites list called Pasta night with everything from this recipe."*

*"Any vandaag-af bread or vegetables at my local AH worth picking up tonight?"*

Look back

*"How much did my in-store receipts add up to in September, and what were the five priciest items?"*

*"Show the receipt from my last shop and list anything I bought more than once."*

Getting started

You need an Albert Heijn account. Then:

  1. [Connect your app](#connecting-a-client): pick yours below.
  2. [Log in to Albert Heijn](#logging-in): ask your assistant to log you in, once.
  3. Ask away. See what you can ask.

Connecting a client

Your appHow
Claude DesktopDownload and double-click. Easiest; nothing else to install.
Cursor, VS CodeOne-click install button
ChatGPT, Claude.ai (web and mobile)Needs your own server (technical)
Other appsAdd a command to the app's settings
Claude Desktop
  1. Download albert-heijn-mcp.mcpb.
  2. Double-click it and choose Install. If it doesn't open in Claude, go to Settings → Extensions → Advanced settings → Install Extension… and pick the file.

That's it: the file contains everything it needs. To update, do the same with the file from the newest release.

Other desktop apps that support MCP Bundles (.mcpb files) install it the same way.

Cursor and VS Code

Install Node.js 24 (LTS) first, then click:

ChatGPT and Claude.ai

Web and mobile apps can't run anything on your computer; they only connect to servers on the internet. So you first need to run it on a server, which takes some technical know-how. Then add it as a connector:

  • ChatGPT needs Developer mode (Plus, Pro, Business, Enterprise and Education). Open Settings → advanced settings, turn on Developer mode, and create a connector with https://your-server/mcp. Set authentication to OAuth.
  • Claude.ai: Settings → Connectors → Add custom connector, paste https://your-server/mcp and choose Connect.

The app then opens a login page on your server: enter your AH_MCP_TOKEN there, once.

Other apps

Apps that start MCP servers as a local command need Node.js 24 (LTS) and run npx -y albert-heijn-mcp, which downloads and runs the latest version. Most of them take this JSON in their MCP settings:

{

"mcpServers": { "ah": { "command": "npx", "args": ["-y", "albert-heijn-mcp"] } } }

Where the settings live differs per app; see its documentation. Apps with a command line usually have an add command instead, e.g. mcp add ah -- npx -y albert-heijn-mcp. It is also listed in the MCP Registry, which some apps install from.

To install it permanently instead, run npm install --global albert-heijn-mcp and use the albert-heijn-mcp command; run the same command again to update.

[!TIP]

Desktop apps don't load your shell profile, so they may not find npx (common with nvm). Then set command to the output of which npx.

Logging in

Ask your assistant to log you in to Albert Heijn. You only do this once; the login is then kept and renewed automatically.

On your computer (Claude Desktop, Cursor, VS Code and other local apps), a separate browser window opens with AH's login page. Log in there as usual: the window closes by itself and you're logged in. Then tell your assistant you're done.

The window uses a fresh, empty browser profile, so type your password: saved passwords and password-manager extensions aren't available there. It needs Chrome, Edge, Brave or Chromium (not the snap version on Ubuntu) and a screen; otherwise you copy the code by hand as below.

On a server (ChatGPT, Claude.ai), or when no login window can open, you copy a code by hand. AH's login page has a captcha that only works on AH's own website, so the code has to come from your browser:

You need a computer for this, not a phone or tablet: their browsers have no developer console. Chrome, Edge or Brave work best.

  1. Open the link your assistant gives you, but don't log in yet.
  2. Open the developer console in that tab, a panel for web developers that you can open safely: ⌘ ⌥ J on Mac, or Ctrl Shift J on Windows and Linux.
  3. Log in as usual. AH then tries to open its phone app, which your browser can't do, so the page seems stuck. In the console, find this red line:
   Failed to launch 'appie://login-exit?code=…' because the scheme does not have a registered handler.
  1. Copy the part from `appie://` up to the closing quote and paste it into the chat. The code works once and expires quickly, so paste it right away.

No line there? See Troubleshooting. To log a server in without the developer console, see Running it on a server.

Where your login is stored

Your login is saved on your own computer and renewed automatically, in a file only your user can read:

OSLocation
macOS~/Library/Application Support/albert-heijn-mcp/tokens.json
Linux~/.config/albert-heijn-mcp/tokens.json (or under $XDG_CONFIG_HOME)
Windows%AppData%\albert-heijn-mcp\tokens.json

Override the location with AH_TOKENS_PATH.

Troubleshooting

No login window opens

The login window needs Chrome, Edge, Brave or Chromium installed in the usual place, and a screen: not over SSH, and not with Ubuntu's snap Chromium. Without one, your assistant gives you the link instead, and you copy the code by hand. If the window closed before you finished, ask to log in again.

No "Failed to launch" line after logging in

The developer console has to be open before you log in. Open it, then open the login link again in that same tab and log in. If AH skips the login form because you're still logged in, that's fine: the line appears all the same. You can also look for the appie://login-exit?code=… request in the Network tab. Browsers other than Chrome, Edge or Brave may show the link in an error page or dialog instead.

Login fails with "exchange code"

Codes work once and expire quickly. Ask to log in again and paste the new link straight away.

"Not logged in", or the session seems broken

Ask your assistant to log you out and back in, or delete tokens.json from the login location and log in again.

"The Albert Heijn login has expired"

Albert Heijn no longer accepts the stored login. Ask your assistant to log in to Albert Heijn again. Reconnecting your app to the server doesn't help: that's a separate login.

If it keeps expiring on your server, keep tokens.json on storage that survives restarts and redeploys, and run a single instance. AH replaces the login every time it's renewed, so an older copy of the file, or a second instance renewing on its own, gets rejected.

"Already connected as …" when pasting a login code

A code never replaces a working login, so a code from someone else's account can't switch you over. To switch accounts, ask to log out first, then log in again.

"There is no active delivery order to change"

AH accepts order changes only once an order exists. Choose a delivery slot in the AH app or on ah.nl first.

"The shopping list is not available while a delivery order is active"

Choosing a slot moved your list into the order. Ask your assistant to change the order instead (ah_get_cart, ah_update_cart_item) until it is delivered or cancelled.

<sum

Solo se muestra el principio; lee el resto en el repo