KPN Grexx

Name: KPN Grexx
Author: WYRE-AI

de WYRE-AIversión 2.3.1i★ 0iSe ejecuta en tu computadora

Nombre en el registroio.github.WYRE-AI/kpn-mcp

Cómo instalar

What it does

KPN IRMA on Grexx: address checks, prequalification, customers, orders, mobile and line tools.

Connects Se ejecuta en tu computadora
Account or key Needs KPN_GREXX_PASSWORD, KPN_CLIENT_SECRET · 2 settings to fill in (KPN_GREXX_USERNAME, KPN_GREXX_BASE_URL)
Category Tiendas en línea y pagos

Instalación

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

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

Primero: ¿qué IA usas?

ClaudeWeb · app · móvilChatGPTWebClaude CodeTerminalCursorEditor de códigoVS CodeEditor de códigoOtrasOtras apps

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Necesitas una clave de KPN Grexx (créala en el sitio del autor) · 2 ajuste(s) que rellenar (KPN_GREXX_USERNAME, KPN_GREXX_BASE_URL) · Instala Docker 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 KPN Grexx para Claude en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "kpn": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "KPN_GREXX_USERNAME", "-e", "KPN_GREXX_PASSWORD", "-e", "KPN_GREXX_BASE_URL", "-e", "KPN_CLIENT_SECRET", "ghcr.io/wyre-ai/kpn-mcp:v2.3.1" ], "env": { "KPN_GREXX_USERNAME": "your-value", "KPN_GREXX_PASSWORD": "your-value", "KPN_GREXX_BASE_URL": "your-value", "KPN_CLIENT_SECRET": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En KPN_GREXX_PASSWORD, KPN_CLIENT_SECRET, KPN_GREXX_USERNAME, KPN_GREXX_BASE_URL deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de KPN Grexx 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 Docker (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --version
- Aparece un número de versión, p. ej. Docker version … = 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: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Hecho
Regístrate y crea una clave de KPN Grexx
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Abrir el sitio de KPN Grexx ↗
Hecho
3
Rellena 2 ajuste(s)
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
- KPN_GREXX_USERNAME Grexx API username. Passed to the SDK as the OAuth client_id (portal: API Gegevens). The SDK sends it with HTTP Basic on the token endpoint. This server does not mint the token.
- KPN_GREXX_BASE_URL Grexx interface root, without /realtime. No default; acceptatie and production differ. In gateway mode a connection may override it with X-Grexx-Api-Url (together with X-Grexx-Token-Url, allowlisted…
Las descripciones siguen en el inglés original.
Hecho
Abre el archivo de configuración de la app de Claude de escritorio
SettingsDeveloperEdit Config
Hecho

Pega esta configuración y guarda el archivo

{
  "mcpServers": {
    "kpn": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KPN_GREXX_USERNAME",
        "-e",
        "KPN_GREXX_PASSWORD",
        "-e",
        "KPN_GREXX_BASE_URL",
        "-e",
        "KPN_CLIENT_SECRET",
        "ghcr.io/wyre-ai/kpn-mcp:v2.3.1"
      ],
      "env": {
        "KPN_GREXX_USERNAME": "your-value",
        "KPN_GREXX_PASSWORD": "your-value",
        "KPN_GREXX_BASE_URL": "your-value",
        "KPN_CLIENT_SECRET": "your-value"
      }
    }
  }
}

Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

Hecho

Cierra Claude y vuelve a abrirlo
Hecho
Pruébalo
Usa KPN Grexx y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si Claude dice que está usando KPN Grexx o muestra una herramienta de KPN Grexx en la respuesta, ya está conectado

9 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

KPN_GREXX_TOKEN_URL OAuth token endpoint. Production differs from acceptatie. In gateway mode a connection may override it with X-Grexx-Token-Url (together with X-Grexx-Api-Url). · valor por defecto https://service-accept.grexx.today/oauth/access_token
KPN_LEGACY_DEVELOPER_API Set to 1 to also register the developer.kpn.com tools (disturbances, availability, SIM swap, MSM). Default is Grexx only.
KPN_CLIENT_ID Legacy developer.kpn.com project client ID. Used only when KPN_LEGACY_DEVELOPER_API=1.
KPN_MSM_CLIENT_ID Optional legacy MSM app ID. Used only when KPN_LEGACY_DEVELOPER_API=1. Must be paired with KPN_MSM_CLIENT_SECRET.
KPN_MSM_CLIENT_SECRET Optional legacy MSM app secret. Used only when KPN_LEGACY_DEVELOPER_API=1, together with KPN_MSM_CLIENT_ID.
KPN_BASE_URL Legacy developer.kpn.com base URL. Env only. Used only when KPN_LEGACY_DEVELOPER_API=1. · valor por defecto https://api-prd.kpn.com
MCP_TRANSPORT Transport mode. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting. · valor por defecto stdio
AUTH_MODE Credential source: 'env' reads KPN_GREXX_* locally, 'gateway' expects X-KPN-Grexx-Username and X-KPN-Grexx-Password, plus optional X-Grexx-Api-Url and X-Grexx-Token-Url per connection.
LOG_LEVEL Nivel de detalle del registro: debug, info, warn, error
Ver original en inglés
Log verbosity: debug, info, warn, error
· valor por defecto info

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

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 KPN Grexx

KPN Grexx 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 KPN Grexx

Pasos para Claude →Necesitas una clave de KPN Grexx (créala en el sitio del autor) · 2 ajuste(s) que rellenar (KPN_GREXX_USERNAME, KPN_GREXX_BASE_URL) · Instala Docker 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
Pasos para Claude Code →Necesitas una clave de KPN Grexx (créala en el sitio del autor) · 2 ajuste(s) que rellenar (KPN_GREXX_USERNAME, KPN_GREXX_BASE_URL) · Instala Docker en tu computadora primero (una sola vez)
Pasos para Cursor →Necesitas una clave de KPN Grexx (créala en el sitio del autor) · 2 ajuste(s) que rellenar (KPN_GREXX_USERNAME, KPN_GREXX_BASE_URL) · Instala Docker en tu computadora primero (una sola vez)
Pasos para VS Code →Necesitas una clave de KPN Grexx (créala en el sitio del autor) · 2 ajuste(s) que rellenar (KPN_GREXX_USERNAME, KPN_GREXX_BASE_URL) · Instala Docker 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

Spree Commerce developer docs for AI agents✓ ChatGPT
Stripe MCP✓ ChatGPT
earnrate✓ ChatGPT

Funciona con Claude Code, pero hay que preparar algo antes

Necesitas una clave de KPN Grexx (créala en el sitio del autor) · 2 ajuste(s) que rellenar (KPN_GREXX_USERNAME, KPN_GREXX_BASE_URL) · Instala Docker 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 KPN Grexx para Claude Code en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user kpn --env KPN_GREXX_USERNAME=your-value --env KPN_GREXX_PASSWORD=your-value --env KPN_GREXX_BASE_URL=your-value --env KPN_CLIENT_SECRET=your-value -- docker run -i --rm -e KPN_GREXX_USERNAME -e KPN_GREXX_PASSWORD -e KPN_GREXX_BASE_URL -e KPN_CLIENT_SECRET ghcr.io/wyre-ai/kpn-mcp:v2.3.1 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En KPN_GREXX_PASSWORD, KPN_CLIENT_SECRET, KPN_GREXX_USERNAME, KPN_GREXX_BASE_URL deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de KPN Grexx 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 Docker (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --version
- Aparece un número de versión, p. ej. Docker version … = 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: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Hecho
Regístrate y crea una clave de KPN Grexx
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Abrir el sitio de KPN Grexx ↗
Hecho
3
Rellena 2 ajuste(s)
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
- KPN_GREXX_USERNAME Grexx API username. Passed to the SDK as the OAuth client_id (portal: API Gegevens). The SDK sends it with HTTP Basic on the token endpoint. This server does not mint the token.
- KPN_GREXX_BASE_URL Grexx interface root, without /realtime. No default; acceptatie and production differ. In gateway mode a connection may override it with X-Grexx-Api-Url (together with X-Grexx-Token-Url, allowlisted…
Las descripciones siguen en el inglés original.
Hecho
Abre la Terminal
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
Hecho

Pega este comando y pulsa Enter

claude mcp add --scope user kpn --env KPN_GREXX_USERNAME=your-value --env KPN_GREXX_PASSWORD=your-value --env KPN_GREXX_BASE_URL=your-value --env KPN_CLIENT_SECRET=your-value -- docker run -i --rm -e KPN_GREXX_USERNAME -e KPN_GREXX_PASSWORD -e KPN_GREXX_BASE_URL -e KPN_CLIENT_SECRET ghcr.io/wyre-ai/kpn-mcp:v2.3.1

Cambia “your-value” por tu clave antes de pulsar Enter

Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

Hecho

Escribe /mcp en Claude Code
Deberías ver KPN Grexx en la lista como conectado
Hecho
Pruébalo
Usa KPN Grexx y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si Claude Code dice que está usando KPN Grexx o muestra una herramienta de KPN Grexx en la respuesta, ya está conectado

9 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

KPN_GREXX_TOKEN_URL OAuth token endpoint. Production differs from acceptatie. In gateway mode a connection may override it with X-Grexx-Token-Url (together with X-Grexx-Api-Url). · valor por defecto https://service-accept.grexx.today/oauth/access_token
KPN_LEGACY_DEVELOPER_API Set to 1 to also register the developer.kpn.com tools (disturbances, availability, SIM swap, MSM). Default is Grexx only.
KPN_CLIENT_ID Legacy developer.kpn.com project client ID. Used only when KPN_LEGACY_DEVELOPER_API=1.
KPN_MSM_CLIENT_ID Optional legacy MSM app ID. Used only when KPN_LEGACY_DEVELOPER_API=1. Must be paired with KPN_MSM_CLIENT_SECRET.
KPN_MSM_CLIENT_SECRET Optional legacy MSM app secret. Used only when KPN_LEGACY_DEVELOPER_API=1, together with KPN_MSM_CLIENT_ID.
KPN_BASE_URL Legacy developer.kpn.com base URL. Env only. Used only when KPN_LEGACY_DEVELOPER_API=1. · valor por defecto https://api-prd.kpn.com
MCP_TRANSPORT Transport mode. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting. · valor por defecto stdio
AUTH_MODE Credential source: 'env' reads KPN_GREXX_* locally, 'gateway' expects X-KPN-Grexx-Username and X-KPN-Grexx-Password, plus optional X-Grexx-Api-Url and X-Grexx-Token-Url per connection.
LOG_LEVEL Nivel de detalle del registro: debug, info, warn, error
Ver original en inglés
Log verbosity: debug, info, warn, error
· valor por defecto info

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

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

Necesitas una clave de KPN Grexx (créala en el sitio del autor) · 2 ajuste(s) que rellenar (KPN_GREXX_USERNAME, KPN_GREXX_BASE_URL) · Instala Docker 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 KPN Grexx para Cursor en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "kpn": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "KPN_GREXX_USERNAME", "-e", "KPN_GREXX_PASSWORD", "-e", "KPN_GREXX_BASE_URL", "-e", "KPN_CLIENT_SECRET", "ghcr.io/wyre-ai/kpn-mcp:v2.3.1" ], "env": { "KPN_GREXX_USERNAME": "your-value", "KPN_GREXX_PASSWORD": "your-value", "KPN_GREXX_BASE_URL": "your-value", "KPN_CLIENT_SECRET": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En KPN_GREXX_PASSWORD, KPN_CLIENT_SECRET, KPN_GREXX_USERNAME, KPN_GREXX_BASE_URL deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de KPN Grexx 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 Docker (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --version
- Aparece un número de versión, p. ej. Docker version … = 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: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Hecho
Regístrate y crea una clave de KPN Grexx
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Abrir el sitio de KPN Grexx ↗
Hecho
3
Rellena 2 ajuste(s)
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
- KPN_GREXX_USERNAME Grexx API username. Passed to the SDK as the OAuth client_id (portal: API Gegevens). The SDK sends it with HTTP Basic on the token endpoint. This server does not mint the token.
- KPN_GREXX_BASE_URL Grexx interface root, without /realtime. No default; acceptatie and production differ. In gateway mode a connection may override it with X-Grexx-Api-Url (together with X-Grexx-Token-Url, allowlisted…
Las descripciones siguen en el inglés original.
Hecho
Pulsa este botón para abrir Cursor
Abrir en Cursor
Cursor te pedirá confirmar; pulsa Install
Hecho
Escribe tu clave
En la configuración de KPN Grexx, KPN_GREXX_PASSWORD, KPN_CLIENT_SECRET, KPN_GREXX_USERNAME, KPN_GREXX_BASE_URL está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Hecho
Abre el chat de IA de Cursor en modo Agent
Hecho
Pruébalo
Usa KPN Grexx y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si Cursor dice que está usando KPN Grexx o muestra una herramienta de KPN Grexx en la respuesta, ya está conectado

9 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

KPN_GREXX_TOKEN_URL OAuth token endpoint. Production differs from acceptatie. In gateway mode a connection may override it with X-Grexx-Token-Url (together with X-Grexx-Api-Url). · valor por defecto https://service-accept.grexx.today/oauth/access_token
KPN_LEGACY_DEVELOPER_API Set to 1 to also register the developer.kpn.com tools (disturbances, availability, SIM swap, MSM). Default is Grexx only.
KPN_CLIENT_ID Legacy developer.kpn.com project client ID. Used only when KPN_LEGACY_DEVELOPER_API=1.
KPN_MSM_CLIENT_ID Optional legacy MSM app ID. Used only when KPN_LEGACY_DEVELOPER_API=1. Must be paired with KPN_MSM_CLIENT_SECRET.
KPN_MSM_CLIENT_SECRET Optional legacy MSM app secret. Used only when KPN_LEGACY_DEVELOPER_API=1, together with KPN_MSM_CLIENT_ID.
KPN_BASE_URL Legacy developer.kpn.com base URL. Env only. Used only when KPN_LEGACY_DEVELOPER_API=1. · valor por defecto https://api-prd.kpn.com
MCP_TRANSPORT Transport mode. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting. · valor por defecto stdio
AUTH_MODE Credential source: 'env' reads KPN_GREXX_* locally, 'gateway' expects X-KPN-Grexx-Username and X-KPN-Grexx-Password, plus optional X-Grexx-Api-Url and X-Grexx-Token-Url per connection.
LOG_LEVEL Nivel de detalle del registro: debug, info, warn, error
Ver original en inglés
Log verbosity: debug, info, warn, error
· valor por defecto info

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

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

Necesitas una clave de KPN Grexx (créala en el sitio del autor) · 2 ajuste(s) que rellenar (KPN_GREXX_USERNAME, KPN_GREXX_BASE_URL) · Instala Docker 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 KPN Grexx para VS Code en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "kpn": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "-e", "KPN_GREXX_USERNAME", "-e", "KPN_GREXX_PASSWORD", "-e", "KPN_GREXX_BASE_URL", "-e", "KPN_CLIENT_SECRET", "ghcr.io/wyre-ai/kpn-mcp:v2.3.1" ], "env": { "KPN_GREXX_USERNAME": "your-value", "KPN_GREXX_PASSWORD": "your-value", "KPN_GREXX_BASE_URL": "your-value", "KPN_CLIENT_SECRET": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En KPN_GREXX_PASSWORD, KPN_CLIENT_SECRET, KPN_GREXX_USERNAME, KPN_GREXX_BASE_URL deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de KPN Grexx 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 Docker (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --version
- Aparece un número de versión, p. ej. Docker version … = 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: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Hecho
Regístrate y crea una clave de KPN Grexx
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Abrir el sitio de KPN Grexx ↗
Hecho
3
Rellena 2 ajuste(s)
Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.
- KPN_GREXX_USERNAME Grexx API username. Passed to the SDK as the OAuth client_id (portal: API Gegevens). The SDK sends it with HTTP Basic on the token endpoint. This server does not mint the token.
- KPN_GREXX_BASE_URL Grexx interface root, without /realtime. No default; acceptatie and production differ. In gateway mode a connection may override it with X-Grexx-Api-Url (together with X-Grexx-Token-Url, allowlisted…
Las descripciones siguen en el inglés original.
Hecho
Pulsa este botón para abrir VS Code
Abrir en VS Code
VS Code te pedirá confirmar; pulsa Install
Hecho
Escribe tu clave
En la configuración de KPN Grexx, KPN_GREXX_PASSWORD, KPN_CLIENT_SECRET, KPN_GREXX_USERNAME, KPN_GREXX_BASE_URL está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Hecho
Abre el chat de IA de VS Code en modo Agent
Hecho
Pruébalo
Usa KPN Grexx y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si VS Code dice que está usando KPN Grexx o muestra una herramienta de KPN Grexx en la respuesta, ya está conectado

9 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

KPN_GREXX_TOKEN_URL OAuth token endpoint. Production differs from acceptatie. In gateway mode a connection may override it with X-Grexx-Token-Url (together with X-Grexx-Api-Url). · valor por defecto https://service-accept.grexx.today/oauth/access_token
KPN_LEGACY_DEVELOPER_API Set to 1 to also register the developer.kpn.com tools (disturbances, availability, SIM swap, MSM). Default is Grexx only.
KPN_CLIENT_ID Legacy developer.kpn.com project client ID. Used only when KPN_LEGACY_DEVELOPER_API=1.
KPN_MSM_CLIENT_ID Optional legacy MSM app ID. Used only when KPN_LEGACY_DEVELOPER_API=1. Must be paired with KPN_MSM_CLIENT_SECRET.
KPN_MSM_CLIENT_SECRET Optional legacy MSM app secret. Used only when KPN_LEGACY_DEVELOPER_API=1, together with KPN_MSM_CLIENT_ID.
KPN_BASE_URL Legacy developer.kpn.com base URL. Env only. Used only when KPN_LEGACY_DEVELOPER_API=1. · valor por defecto https://api-prd.kpn.com
MCP_TRANSPORT Transport mode. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting. · valor por defecto stdio
AUTH_MODE Credential source: 'env' reads KPN_GREXX_* locally, 'gateway' expects X-KPN-Grexx-Username and X-KPN-Grexx-Password, plus optional X-Grexx-Api-Url and X-Grexx-Token-Url per connection.
LOG_LEVEL Nivel de detalle del registro: debug, info, warn, error
Ver original en inglés
Log verbosity: debug, info, warn, error
· valor por defecto info

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

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 KPN Grexx💬 Conversación →

Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user kpn --env KPN_GREXX_USERNAME=your-value --env KPN_GREXX_PASSWORD=your-value --env KPN_GREXX_BASE_URL=your-value --env KPN_CLIENT_SECRET=your-value -- docker run -i --rm -e KPN_GREXX_USERNAME -e KPN_GREXX_PASSWORD -e KPN_GREXX_BASE_URL -e KPN_CLIENT_SECRET ghcr.io/wyre-ai/kpn-mcp:v2.3.1

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "kpn": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KPN_GREXX_USERNAME",
        "-e",
        "KPN_GREXX_PASSWORD",
        "-e",
        "KPN_GREXX_BASE_URL",
        "-e",
        "KPN_CLIENT_SECRET",
        "ghcr.io/wyre-ai/kpn-mcp:v2.3.1"
      ],
      "env": {
        "KPN_GREXX_USERNAME": "your-value",
        "KPN_GREXX_PASSWORD": "your-value",
        "KPN_GREXX_BASE_URL": "your-value",
        "KPN_CLIENT_SECRET": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "kpn": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KPN_GREXX_USERNAME",
        "-e",
        "KPN_GREXX_PASSWORD",
        "-e",
        "KPN_GREXX_BASE_URL",
        "-e",
        "KPN_CLIENT_SECRET",
        "ghcr.io/wyre-ai/kpn-mcp:v2.3.1"
      ],
      "env": {
        "KPN_GREXX_USERNAME": "your-value",
        "KPN_GREXX_PASSWORD": "your-value",
        "KPN_GREXX_BASE_URL": "your-value",
        "KPN_CLIENT_SECRET": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "kpn": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KPN_GREXX_USERNAME",
        "-e",
        "KPN_GREXX_PASSWORD",
        "-e",
        "KPN_GREXX_BASE_URL",
        "-e",
        "KPN_CLIENT_SECRET",
        "ghcr.io/wyre-ai/kpn-mcp:v2.3.1"
      ],
      "env": {
        "KPN_GREXX_USERNAME": "your-value",
        "KPN_GREXX_PASSWORD": "your-value",
        "KPN_GREXX_BASE_URL": "your-value",
        "KPN_CLIENT_SECRET": "your-value"
      }
    }
  }
}

Valores que debes completar

KPN_GREXX_USERNAME obligatorio env
Grexx API username. Passed to the SDK as the OAuth client_id (portal: API Gegevens). The SDK sends it with HTTP Basic on the token endpoint. This server does not mint the token.
KPN_GREXX_PASSWORD secreto obligatorio env
Grexx API password. Passed to the SDK as the OAuth client_secret (scope=all). The SDK sends it with HTTP Basic on the token endpoint.
KPN_GREXX_BASE_URL obligatorio env
Grexx interface root, without /realtime. No default; acceptatie and production differ. In gateway mode a connection may override it with X-Grexx-Api-Url (together with X-Grexx-Token-Url, allowlisted…
KPN_GREXX_TOKEN_URL env
OAuth token endpoint. Production differs from acceptatie. In gateway mode a connection may override it with X-Grexx-Token-Url (together with X-Grexx-Api-Url).
KPN_LEGACY_DEVELOPER_API env
Set to 1 to also register the developer.kpn.com tools (disturbances, availability, SIM swap, MSM). Default is Grexx only.
KPN_CLIENT_ID env
Legacy developer.kpn.com project client ID. Used only when KPN_LEGACY_DEVELOPER_API=1.
KPN_CLIENT_SECRET secreto obligatorio env
Legacy developer.kpn.com project client secret. Used only when KPN_LEGACY_DEVELOPER_API=1, together with KPN_CLIENT_ID.
KPN_MSM_CLIENT_ID env
Optional legacy MSM app ID. Used only when KPN_LEGACY_DEVELOPER_API=1. Must be paired with KPN_MSM_CLIENT_SECRET.
KPN_MSM_CLIENT_SECRET secreto env
Optional legacy MSM app secret. Used only when KPN_LEGACY_DEVELOPER_API=1, together with KPN_MSM_CLIENT_ID.
KPN_BASE_URL env
Legacy developer.kpn.com base URL. Env only. Used only when KPN_LEGACY_DEVELOPER_API=1.
MCP_TRANSPORT env
Transport mode. Set to 'stdio' for local CLI use; the image defaults to 'http' for gateway hosting.
AUTH_MODE secreto env
Credential source: 'env' reads KPN_GREXX_* locally, 'gateway' expects X-KPN-Grexx-Username and X-KPN-Grexx-Password, plus optional X-Grexx-Api-Url and X-Grexx-Token-Url per connection.
LOG_LEVEL env
Nivel de detalle del registro: debug, info, warn, error
Ver original en inglés
Log verbosity: debug, info, warn, error

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

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

Estrellas de GitHub i: 0
Descargas por semanai: No está en npm/PyPI
Licencia i: Apache-2.0
Conexión: Se ejecuta en tu computadora
Transporte: stdio
Última versióni: 2.3.1
Categoríai: Tiendas en línea y pagos
Publicado en el registroi: 22 oct 2026
Último cambio de códigoi: 12 nov 2026
Creador: WYRE-AI
Paquetes: oci: ghcr.io/wyre-ai/kpn-mcp:v2.3.1
Repo: WYRE-AI/kpn-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

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

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 15 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub WYRE-AI, dueña del repo
✓ Superada
Sigue en mantenimiento
Último cambio de código: hace 3 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)

No revisado: solo se pueden revisar paquetes npm y PyPI con versión

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo

Iniciar sesión

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 0% de los otros 2813 servidores de esta categoría
Publicado en el registro más recientemente que el 58% de los otros 2813 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 2813 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 KPN Grexx?

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?

Debes completar: KPN_GREXX_PASSWORD, KPN_CLIENT_SECRET

¿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 3 días, y la última versión (2.3.1) llegó al registro hace 24 días.

¿Qué apps pueden usarlo?

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

¿Qué puedo usar en su lugar?

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

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

Cómo conectar

flightclaw

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

de flightclawEn crecimiento★ 85Actualizado hace 2 meses

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

Cómo conectar

Trade It

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

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

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

Cómo conectar

Vaaya

Paid APIs and tokenized shares for agents. Prepaid funding, including authorized Instinct checkout.

de vaaya-aiInicial↓ 127/sem★ 44Actualizado hace 2 meses

Computadora o nube✓ del servicio · vaaya.ai

Instalar

Marketplace Ad Pros: Amazon Ads & Seller Central

Amazon Ads, Seller Central, Vendor Central and AMC data for AI agents. Read-only by default.

de MarketplaceAdProsInicial★ 29Actualizado hace 10 días

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

Cómo conectar

Stripe MCP — Funciona en la nube, sin instalar nada · Sin clave · En el directorio de Claude
flightclaw — Funciona en la nube, sin instalar nada · Sin clave
Trade It — Funciona en la nube, sin instalar nada · Sin clave
Vaaya — En la nube o instalado en tu equipo · Sin clave
Marketplace Ad Pros: Amazon Ads & Seller Central — Funciona en la nube, sin instalar nada · Sin clave

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.

kpn-mcp

MCP server for KPN IRMA APIs hosted by Grexx (acceptatie: service-accept.grexx.today), aimed at MSP helpdesks. The default surface is realtime XML over OAuth 2.0 client credentials. The SDK sends HTTP Basic to the token endpoint. POST /realtime uses the Bearer token.

Built on the MCP 2026-07-28 spec via the split v2 SDK (@modelcontextprotocol/server / /node / /client ^2.0.0-beta.5) with dual-era serving: one shared McpServerFactory behind createMcpHandler({ legacy: 'stateless' }) answers both 2025-era initialize-handshake clients and modern 2026-07-28 envelope clients, with the same tool list for every caller. Ships as a GHCR container only (no MCPB bundle). The client is @wyre-ai/node-kpn (Grexx export). Contract: docs/GREXX.md.

Tools (15, flat)

kpn_grexx_test_connection: the SDK mints an OAuth client-credentials token and posts a ZipCodeCheckRequest_V6 probe for the public reference address 1012JS 1 (portfolio All). Success means the token endpoint and POST /realtime accepted the Bearer token.
kpn_grexx_zipcode_check: technology and speeds at a Dutch address (ZipCodeCheckRequest_V6 → ZipCodeCheckResponse_V5).
kpn_grexx_prequalification: address and product-type availability per supplier (PrequalificationRequest_V2 → PrequalificationResponse_V1). When hasBroadband is true, serviceId or referencePhoneNumber is required.
kpn_grexx_order_data: customer id, product code, and quantity for an order id (OrderDataRequest_V1 → OrderDataResponse_V1).

11 more realtime tools built from the portal request XSDs (see docs/GREXX.md): kpn_grexx_carrier_info, kpn_grexx_radius_check, kpn_grexx_ras_check, kpn_grexx_start_line_diagnose, kpn_grexx_customer_data, kpn_grexx_order_summary, kpn_grexx_get_sim, kpn_grexx_mobile_settings, kpn_grexx_mobile_usage, kpn_grexx_mobile_orders, kpn_grexx_available_portings. start_line_diagnose starts a test at KPN, so it is not read-only and is never retried. SIM codes and the RadiusCheck PPP password are masked.

IRMA enforces XSD element order and rejects a bad request with an HTTP 200 NinaResponse; both are handled by the server. Queued writes and Proxymodule notifications are not exposed.

Set KPN_LEGACY_DEVELOPER_API=1 to also serve the previous 23 developer.kpn.com tools (disturbances, availability, SIM swap, MSM). They are absent from the default list. See docs/DESIGN.md for that catalog. Gated MSM writes still require confirmation.

Credentials

Grexx username and password are the OAuth client_id and client_secret (scope=all). Copy the interface root from the partner portal (API Gegevens). There is no default base URL: acceptatie and production differ.

Env var (env mode)	Gateway header (`AUTH_MODE=gateway`)	Required
`KPN_GREXX_USERNAME`	`X-KPN-Grexx-Username`	yes
`KPN_GREXX_PASSWORD`	`X-KPN-Grexx-Password`	yes
`KPN_GREXX_BASE_URL`	`X-Grexx-Api-Url` (optional, per connection)	yes, unless the request sends `X-Grexx-Api-Url` + `X-Grexx-Token-Url`. No default. Interface root, without `/realtime`
`KPN_GREXX_TOKEN_URL`	`X-Grexx-Token-Url` (optional, per connection)	no. Default `https://service-accept.grexx.today/oauth/access_token`

Example (acceptatie shape — replace the interface id from API Gegevens):

export KPN_GREXX_USERNAME="..."

export KPN_GREXX_PASSWORD="..." export KPN_GREXX_BASE_URL="https://service-accept.grexx.today/interfaces/kpn/kpn_partners_acceptatieomgeving/ /"

export KPN_GREXX_TOKEN_URL="https://service-accept.grexx.today/oauth/access_token"

See env.example. Token mint, cache, and Bearer retry live in @wyre-ai/node-kpn. Base or token URLs under any other header name (X-KPN-Grexx-Base-Url, ...) are rejected (HTTP 400).

In gateway mode a request missing X-KPN-Grexx-Username or X-KPN-Grexx-Password is answered 401 (JSON-RPC error -32001) before the MCP handler runs. It never falls through to env credentials.

Per-connection Grexx environment (WYREAI-525)

In gateway mode Conduit may send two headers on every call to point that connection at another Grexx environment, such as production:

Header	Value	Example
`X-Grexx-Api-Url`	Interface root from the portal (API Gegevens), without `/realtime`	`https://service.grexx.today/interfaces/kpn/ /`
`X-Grexx-Token-Url`	OAuth token endpoint	`https://service.grexx.today/oauth/access_token`

Both or neither. When both are absent or empty, the sidecar uses KPN_GREXX_BASE_URL and KPN_GREXX_TOKEN_URL, also when the credential headers are sent without the URL headers. KPN_GREXX_BASE_URL has no default and is then required; KPN_GREXX_TOKEN_URL is optional and defaults to the acceptatie token endpoint (https://service-accept.grexx.today/oauth/access_token). Exactly one URL header is HTTP 400.
Honoured only with X-KPN-Grexx-Username / X-KPN-Grexx-Password; without them the request is 401.
Scheme and authority: https: only, port 443 only, no userinfo, no query string, no fragment.
Exact-host allowlist (GREXX_ALLOWED_HOSTS in @wyre-ai/node-kpn): service.grexx.today and service-accept.grexx.today. No *.grexx.today wildcard; IP literals never match.
Paths: token URL path exactly /oauth/access_token; API URL path must start with /interfaces/kpn/ and is the interface root without /realtime (the SDK appends it).
Any violation is HTTP 400 (JSON-RPC -32600), and the message never echoes the URL.
Private-IP blocking: with header URLs the SDK resolves the host before every token mint and /realtime post, and again at socket connect (undici fetch with a guarded Agent), and refuses private, loopback, link-local (incl. 169.254.169.254), CGNAT, reserved/benchmark, ULA and metadata addresses.
Redirects are refused: any 3xx fails the call.
Every other URL header name (X-KPN-Grexx-Base-Url, ...) is still rejected with HTTP 400.

HTTP authentication

CONDUIT_S2S_SECRET is required when MCP_TRANSPORT=http. If it is empty, the process logs an error and exits non-zero. It never prints the secret. Known placeholders (changeme, change-me, secret, placeholder, example, your-secret, your-s2s-secret, s2s-secret, replace-me, replace-with-a-real-secret) are rejected the same way, including when MCP_ALLOW_INSECURE_DEV=1 is set.

MCP_ALLOW_INSECURE_DEV=1 is local development only. The process logs a warning, does not check X-Gateway-S2S, and listens on 127.0.0.1 only. A non-loopback MCP_HTTP_HOST (including 0.0.0.0) is ignored in that mode and the override is logged.

MCP_HTTP_HOST is honored when a real secret is set. Unset, that bind stays 0.0.0.0. Set 127.0.0.1 to keep a secret-backed process on loopback. The container image sets 0.0.0.0 and AUTH_MODE=gateway.

With a real secret, every request except /health and /healthz must include:

X-Gateway-S2S: t=<unix seconds>,v1=<hex hmac-sha256>

v1 is HMAC-SHA256 of the exact string t= (the same t= prefix that starts the header), keyed with CONDUIT_S2S_SECRET, hex-encoded. The timestamp must be within 300 seconds of the server clock. A missing or invalid header is 401. /health and /healthz stay unauthenticated and do not read credentials. The stdio transport does not use CONDUIT_S2S_SECRET.

# sign "t=$NOW" with the gateway-provisioned secret

NOW=$(date +%s) SIG=$(printf 't=%s' "$NOW" | openssl dgst -sha256 -hmac "$CONDUIT_S2S_SECRET" | awk '{print $NF}') curl -sS -D- http://127.0.0.1:8080/mcp \ -H "X-Gateway-S2S: t=${NOW},v1=${SIG}" \ -H "X-KPN-Grexx-Username: ..." \ -H "X-KPN-Grexx-Password: ..." \ -H 'Content-Type: application/json' \ -H 'Accept: application/json, text/event-stream' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

SDK dependency

Import the Grexx client from @wyre-ai/node-kpn (package root), not /legacy.

The dependency is the published range ^2.2.0 (per-connection URLs + SSRF guard from node-kpn#6; Prequalification and OrderData from node-kpn#5, tag v2.1.0). Token minting is the HTTP Basic behavior from node-kpn#4. /legacy remains the developer.kpn.com client for KPN_LEGACY_DEVELOPER_API=1 only. This server does not mint the Grexx token.

Running

export NODE_AUTH_TOKEN=$(gh auth token)   # GitHub Packages auth for @wyre-ai/*

npm install npm run build node dist/index.js # stdio (default)

HTTP refuses to start until CONDUIT_S2S_SECRET is a real secret

CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" MCP_TRANSPORT=http node dist/index.js

Local HTTP only, without a service-to-service secret (always binds 127.0.0.1)

MCP_ALLOW_INSECURE_DEV=1 MCP_TRANSPORT=http node dist/index.js npm run smoke # both protocol eras serve the same Grexx tools

Docker (linux/amd64 per fleet law). The image listens on 0.0.0.0 inside the container and defaults to AUTH_MODE=gateway. Publish the port on loopback and pass the S2S secret. Grexx username and password arrive on each request as headers. KPN_GREXX_BASE_URL stays in the environment because a caller-supplied URL is rejected.

docker build --platform linux/amd64 --build-arg GITHUB_TOKEN=$(gh auth token) -t kpn-mcp .

docker run \ -e CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \ -e KPN_GREXX_BASE_URL="https://service-accept.grexx.today/interfaces/kpn/kpn_partners_acceptatieomgeving/ /" \ -p 127.0.0.1:8080:8080 \ kpn-mcp

Compose refuses to start when CONDUIT_S2S_SECRET is unset, publishes 127.0.0.1:8080:8080, and does not inject KPN_GREXX_USERNAME or KPN_GREXX_PASSWORD:

CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \

KPN_GREXX_BASE_URL="https://service-accept.grexx.today/interfaces/kpn/kpn_partners_acceptatieomgeving/ /" \ GITHUB_TOKEN=$(gh auth token) \ docker compose up --build

Single-tenant HTTP (AUTH_MODE=env) still requires the S2S secret, then uses KPN_GREXX_USERNAME and KPN_GREXX_PASSWORD:

docker run \

-e CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \ -e AUTH_MODE=env \ -e KPN_GREXX_USERNAME=... \ -e KPN_GREXX_PASSWORD=... \ -e KPN_GREXX_BASE_URL=... \ -p 127.0.0.1:8080:8080 \ kpn-mcp

/health is a shallow liveness probe. It does not call Grexx and does not read credentials.

Legacy developer.kpn.com tools

With KPN_LEGACY_DEVELOPER_API=1 the process also registers kpn_test_connection, kpn_disturbances_check, kpn_availability_check, kpn_sim_swap_get_date, and the MSM read/write tools. Credentials are KPN_CLIENT_ID / KPN_CLIENT_SECRET (gateway: X-KPN-Client-Id / X-KPN-Client-Secret), plus an optional MSM pair. KPN_BASE_URL stays env-only. A half MSM pair is rejected. MSM writes still create orders, are not retried, and require confirmation (confirm_destructive_action when the client cannot be prompted).

Vendor quirks encoded here

OAuth client_credentials, scope=all. The SDK sends HTTP Basic to the token endpoint, then Bearer on POST /realtime (Content-Type: text/xml). Plain XML, no SOAP envelope. Basic Auth is not sent on POST /realtime.
This server hands token minting to GrexxClient, which sends HTTP Basic first and may fall back to form-body client_id / client_secret after HTTP 400/401 invalid_client.
The token endpoint is not retried into a Bearer-less call. HTTP 401 remints once inside the SDK.
IRMA code 108 and HTTP 429 are rate limits. Code 102 is an IP allowlist rejection.
Success codes include Success (what acceptatie returned for ZipCodeCheck).

License

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

KPN Grexx

What it does

Instalación

Instala Docker (si no lo tienes)

Regístrate y crea una clave de KPN Grexx

Rellena 2 ajuste(s)

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

Pega esta configuración y guarda el archivo

Cierra Claude y vuelve a abrirlo

Pruébalo

Lo que puedes hacer en su lugar

Instala Docker (si no lo tienes)

Regístrate y crea una clave de KPN Grexx

Rellena 2 ajuste(s)

Abre la Terminal

Pega este comando y pulsa Enter

Escribe /mcp en Claude Code

Pruébalo

Instala Docker (si no lo tienes)

Regístrate y crea una clave de KPN Grexx

Rellena 2 ajuste(s)

Pulsa este botón para abrir Cursor

Escribe tu clave

Abre el chat de IA de Cursor en modo Agent

Pruébalo

Instala Docker (si no lo tienes)

Regístrate y crea una clave de KPN Grexx

Rellena 2 ajuste(s)

Pulsa este botón para abrir VS Code

Escribe tu clave

Abre el chat de IA de VS Code en modo Agent

Pruébalo

Instalado en tu computadora

Valores que debes completar

De un vistazo

Qué apps pueden usarlo

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Vulnerabilidades publicadas (OSV.dev)

Conversación

Reseñas de usuarios

Comparado con otros en Tiendas en línea y pagosi

Preguntas frecuentes

Alternativas parecidas

Stripe MCP

flightclaw

Trade It

Vaaya

Marketplace Ad Pros: Amazon Ads & Seller Central

README del creador

kpn-mcp

Tools (15, flat)

Credentials

export KPN_GREXX_TOKEN_URL="https://service-accept.grexx.today/oauth/access_token"

Per-connection Grexx environment (WYREAI-525)

HTTP authentication

SDK dependency

Running

HTTP refuses to start until CONDUIT_S2S_SECRET is a real secret

Local HTTP only, without a service-to-service secret (always binds 127.0.0.1)

Legacy developer.kpn.com tools

Vendor quirks encoded here

License