Cómo conectar Nova Poshta a ChatGPT — via MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Nova Poshta, pega tus credenciales, genera una MCP API key — listo. Sin Docker, sin git clone, sin servidor local.

Nova Poshta + ChatGPT

Nova Poshta (Нова Пошта), la empresa de paquetería de Ucrania: rastrea hasta 100 guías de envío a la vez, busca ciudades y sucursales o casilleros de paquetes, calcula el precio y la fecha de entrega y consulta tus propios envíos. El seguimiento y las búsquedas funcionan sin clave de API.

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:

(none — public API)

Paso 1 — Obtener credenciales

1. El seguimiento, la búsqueda de ciudades y sucursales y el cálculo del precio y la fecha de entrega funcionan sin clave: no hay nada que configurar.
2. Solo nova_poshta_list_shipments (tus propias guías de envío) necesita una clave. En la cuenta de empresa de Nova Poshta, en new.novaposhta.ua, abre Settings → Security, haz clic en Create key, acepta las condiciones de la API y pon la clave en NOVA_POSHTA_API_KEY. Una clave es válida durante un año; con una clave vencida fallan todas las llamadas, así que renuévala o vacía la variable.
3. nova_poshta_track_parcels acepta hasta 100 números de guía (TTN). Incluye el teléfono del remitente o del destinatario para obtener el registro completo; sin él solo obtienes el estado.
4. Para el precio y la fecha de entrega, resuelve la ciudad con nova_poshta_search_settlements y pasa su valor DeliveryCity (no Ref) a nova_poshta_get_delivery_price o nova_poshta_get_delivery_date, junto con un tipo de servicio: Warehouse (sucursal), Doors (dirección) o Postomat (casillero de paquetes).

Las fechas usan el formato DD.MM.YYYY, el peso va en kg y el valor declarado en UAH. Nova Poshta responde HTTP 200 incluso cuando una llamada falla, así que el asistente lee success y errors; un número de seguimiento desconocido devuelve "Номер не знайдено" (número no encontrado). Los textos están en ucraniano, y muchos registros también incluyen un DescriptionRu en ruso.

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 ChatGPT

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.

ChatGPT se conecta a servidores MCP como apps personalizadas en modo desarrollador (Developer mode), disponible en los planes de pago, no en el gratuito. En los espacios Business y Enterprise puede que un administrador tenga que habilitarlo antes.

1. En ChatGPT, abre Settings → Security and login y activa Developer mode.
2. Ve a chatgpt.com/plugins y pulsa +.
3. Escribe un nombre y una descripción breve, por ejemplo Name: Nova Poshta.
4. En Connection, introduce la URL del servidor MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID y crea la conexión.
5. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP (OAuth) y permite el acceso.

Herramientas disponibles

FAQ

¿Funciona el plan gratuito de ChatGPT con conectores MCP personalizados? No. Las conexiones MCP personalizadas necesitan el modo desarrollador, que solo está en los planes de pago.

Siguientes pasos

• Página del conector
• Conectar a Claude