DHL Paket MCP con Gemini CLI: envíos

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → DHL Paket Versand (Geschäftskunden), pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

DHL Parcel DE Shipping + Gemini

Reserva envíos DHL Paket desde tu IA con tu propio contrato de cliente empresarial de DHL (Geschäftskundenkonto) a través de la API oficial Parcel DE Shipping v2: comprueba envíos antes de reservarlos, resérvalos y obtén números de seguimiento y etiquetas, vuelve a descargar etiquetas, cancela envíos, haz el cierre diario (Tagesabschluss) y obtén el manifiesto.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

DHL_API_KEY, DHL_API_SECRET, DHL_GKP_USERNAME, DHL_GKP_PASSWORD

Paso 1 — Obtener credenciales

La configuración lleva unos 15 minutos, más el tiempo que DHL tarde en aprobar tu app. Necesitas un contrato de cliente empresarial de DHL con acceso al Geschäftskundenportal (GKP) de DHL y una cuenta en developer.dhl.com.

1. En developer.dhl.com abre My Apps → Create App y añade la API Parcel DE Shipping (Post & Parcel Germany). Cuando DHL haya aprobado la app, copia su API Key en DHL_API_KEY y su API Secret en DHL_API_SECRET.
2. En el Geschäftskundenportal elige un usuario que pueda crear envíos y pon su nombre de usuario en DHL_GKP_USERNAME y su contraseña en DHL_GKP_PASSWORD. Lo mejor es un usuario de sistema propio: Benutzerverwaltung → Systembenutzer anlegen. Un usuario personal del GKP también sirve, pero su contraseña caduca con regularidad.
3. Instala el conector. No hay paso Authorize with Provider: AnythingMCP cambia los cuatro valores por un access token (OAuth2 password grant) y lo renueva por sí mismo.
4. Busca tus números de facturación en el GKP, en Vertragsdaten, y prueba dhl_parcel_de_validate_shipments con un envío de prueba: DHL lo comprueba como una reserva real, pero no se crea ni se factura nada.

Número de facturación (Abrechnungsnummer): cada envío necesita un billingNumber de 14 caracteres: tu número de cliente de 10 dígitos (EKP), los 2 dígitos del procedimiento del producto y los 2 dígitos de la participación (Teilnahme, normalmente 01). Para DHL Paket (procedimiento 01) con participación 01 es tu EKP seguido de 0101. Dile una vez tu EKP a la IA y ella construye el número.

Productos: V01PAK DHL Paket (procedimiento 01), V62KP DHL Kleinpaket (62, sustituye a Warenpost), V53WPAK DHL Paket International (53), V54EPAK DHL Europaket para clientes empresariales en Europa (54) y V66WPI Warenpost International (66). Los servicios que puedes añadir (vecino preferido, lugar o día preferido, entrega solo a la persona indicada, sin entrega a vecinos, comprobación visual de la edad, firma del destinatario, seguro adicional, contra reembolso, mercancía voluminosa, Premium, GoGreen Plus, DHL Retoure, desvío a una sucursal) dependen del producto y de tu contrato.

Qué hace:

• dhl_parcel_de_validate_shipments comprueba direcciones, producto, servicios y número de facturación y devuelve los mismos mensajes que una reserva. No se crea ni se factura nada.
• dhl_parcel_de_create_shipments reserva hasta 30 envíos por llamada y devuelve para cada uno el número de envío (el número de seguimiento) con su etiqueta, como enlace o, con includeDocs: include, en base64. DHL factura cada envío reservado salvo que se cancele el mismo día, así que la IA te pregunta antes de reservar y valida primero los datos nuevos.
• dhl_parcel_de_get_labels vuelve a descargar etiquetas y documentos de aduana para hasta 30 números de envío.
• dhl_parcel_de_cancel_shipments cancela envíos que aún no se han cerrado, normalmente hasta el final del día. Un envío cancelado no se factura y su etiqueta deja de ser válida.
• dhl_parcel_de_close_out hace ya el cierre diario (Tagesabschluss) de algunos o de todos los envíos, en lugar de esperar al cierre automático de la tarde. Los envíos cerrados ya no se pueden cancelar.
• dhl_parcel_de_get_manifest devuelve el manifiesto (Einlieferungsliste) de un día: el PDF con los envíos cerrados por número de facturación y en qué hoja está cada envío.

Las 6 herramientas quedan activadas al instalar, también las que reservan, cancelan y cierran envíos. Si la IA solo debe comprobar datos de envío, desactiva dhl_parcel_de_create_shipments, dhl_parcel_de_cancel_shipments y dhl_parcel_de_close_out en la página del conector.

Leer la respuesta: la respuesta trae un status y una lista items con una entrada por envío, en el orden de la petición. HTTP 207 significa que algunos envíos fallaron: sstatus y validationMessages de cada entrada dicen por qué. Un aviso débil sobre la dirección ("Die Adresse konnte nicht geprüft werden") reserva el envío igualmente; con mustEncode: true DHL rechaza las direcciones que no puede codificar.

Seguimiento: para seguir un envío reservado, usa el conector DHL Shipment Tracking con el número de envío.

Límites: hasta 30 envíos por petición. Si las llamadas llegan demasiado rápido, DHL responde 429: espera un momento y vuelve a intentarlo.

Errores frecuentes: 401 significa que DHL rechazó el inicio de sesión. Comprueba que DHL_API_KEY y DHL_API_SECRET pertenecen a una app aprobada con la API Parcel DE Shipping y que el usuario y la contraseña del GKP son correctos. Una contraseña personal del GKP caduca y hay que renovarla en el portal.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de DHL Parcel DE Shipping.

Herramientas disponibles

Ejemplos de prompts

• "Comprueba sin reservarlo un DHL Paket de 2 kg para Anna Schmidt, Hauptstraße 5, 79098 Freiburg."
• "Reserva el envío y dame el número de seguimiento y el enlace a la etiqueta."
• "Cancela el envío 00340434161234567890, el cliente ha cancelado el pedido."
• "Haz el cierre diario de hoy y dame el manifiesto."
• "Vuelve a descargar las etiquetas de estos tres números de envío."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot