Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Allegro con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
AnythingMCP está en el directorio de conectores de Claude: añádelo a Claude con un clic (se abre en una pestaña nueva), inicia sesión y elige qué servidores MCP puede usar Claude.
Resumen
Gestiona una cuenta de vendedor de Allegro (allegro.pl, .cz, .sk, .hu) desde cualquier agente de IA: ofertas con precio, stock y estado, pedidos con estado de preparación y números de seguimiento, devoluciones y reembolsos, mensajes de compradores, disputas y reclamaciones, comisiones, monedero y valoraciones. Acceso OAuth con la cuenta de vendedor; reembolsos y decisiones sobre reclamaciones vienen desactivados.
Prueba a pedir
Prompts de ejemplo para Allegro
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Allegro, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Allegro + Claude
Gestiona una cuenta de vendedor de Allegro (allegro.pl, .cz, .sk, .hu) desde cualquier agente de IA: ofertas con precio, stock y estado, pedidos con estado de preparación y números de seguimiento, devoluciones y reembolsos, mensajes de compradores, disputas y reclamaciones, comisiones, monedero y valoraciones. Acceso OAuth con la cuenta de vendedor; reembolsos y decisiones sobre reclamaciones vienen desactivados.
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:
ALLEGRO_CLIENT_ID, ALLEGRO_CLIENT_SECRET
Paso 1 — Obtener credenciales
La configuración lleva unos 10 minutos. Necesitas la cuenta de vendedor de Allegro para la que debe trabajar la IA. Allegro, allegro.cz, allegro.sk y allegro.hu funcionan con la misma API (https://api.allegro.pl).
- Inicia sesión en https://apps.developer.allegro.pl con la cuenta de vendedor. Para pruebas usa https://apps.developer.allegro.pl.allegrosandbox.pl con una cuenta sandbox.
- Registra una aplicación nueva del tipo que se usa con un navegador y una redirección, no el device flow.
- Como redirect URI introduce
<your AnythingMCP URL>/api/mcp-oauth/callback, en AnythingMCP Cloudhttps://cloud.anythingmcp.com/api/mcp-oauth/callback, carácter por carácter. - Da a la aplicación los permisos que usa el conector: lectura de perfil, lectura y escritura de ofertas, lectura de ajustes de venta, lectura y escritura de pedidos, mensajería, disputas, valoraciones, lectura de facturación y lectura de pagos (escritura de pagos solo si deben ser posibles los reembolsos). El conector no pide un scope explícito, así que Allegro concede lo que declara la aplicación; un permiso que falte responde 403 en las herramientas correspondientes.
- Pega el Client ID en
ALLEGRO_CLIENT_IDy el Client Secret enALLEGRO_CLIENT_SECRETy guarda. - En la página del conector haz clic en Authorize with Provider e inicia sesión con la cuenta de vendedor.
- Ejecuta
allegro_get_me: muestra la cuenta conectada y confirma el inicio de sesión.
Los tokens de acceso duran 12 horas y se renuevan con el refresh token, que sigue siendo válido 3 meses después de cada uso. Si el conector pasa más tiempo sin usarse, vuelve a autorizarlo. Para el sandbox, cambia en los ajustes del conector la URL base a https://api.allegro.pl.allegrosandbox.pl y las URL de OAuth a las páginas de acceso bajo https://allegro.pl.allegrosandbox.pl/auth/oauth/.
De quién es la cuenta: todos los que usan este conector actúan como el vendedor que lo autorizó. Los compradores ven los mensajes, las respuestas a valoraciones, los estados de los pedidos y los cambios en las ofertas.
Qué lee: la cuenta, su puntuación de calidad de ventas con hasta 30 días de historial y sus estadísticas de valoraciones. Las ofertas propias con precio, stock, unidades vendidas, estado y categoría, filtradas por título, estado, rango de precio o tu SKU (id externo), y los eventos de ofertas de las últimas 24 horas. El catálogo de productos de Allegro por nombre, EAN/GTIN o MPN, el árbol de categorías con sus parámetros, y las tarifas de envío, políticas de devolución y garantías legales del vendedor. Los pedidos con estado, estado de preparación, líneas y totales, con los datos de comprador, entrega y factura de cada pedido, los eventos de pedidos, los paquetes y su historial de seguimiento. Las devoluciones de clientes y los reembolsos. Los hilos y mensajes del centro de mensajes. Las disputas y reclamaciones con sus mensajes. Las comisiones (entradas de facturación) y las operaciones de pago del monedero. Las valoraciones con comentarios y respuestas.
Qué escribe: crea ofertas a partir de un producto del catálogo (como borrador con INACTIVE o publicada al instante con ACTIVE), edita campos de una oferta, cambia precio y stock, activa o finaliza ofertas, fija el estado de preparación de un pedido, añade números de seguimiento (el comprador recibe un aviso), responde a compradores y abre una conversación sobre un pedido, marca hilos como leídos, escribe en disputas y reclamaciones y responde públicamente a valoraciones. Antes de un mensaje, una respuesta a una valoración, un cambio de estado o de precio o una oferta nueva activa, la IA te muestra el texto exacto o el cambio y espera tu sí.
Desactivadas al instalar: allegro_delete_draft_offer, allegro_reject_customer_return, allegro_create_refund (mueve dinero y no se puede deshacer; además necesita el permiso allegro:api:payments:write) y allegro_change_claim_status (una decisión formal sobre la reclamación que el comprador recibe al momento). Un admin activa las que necesite el equipo.
Formatos de datos: los importes son un objeto como {"amount": "129.99", "currency": "PLN"} con el importe como cadena decimal, y los precios se envían igual. Las fechas son ISO 8601 en UTC. Los id de pedidos, líneas, pagos y productos son UUID; los id de ofertas y usuarios son números enviados como cadenas. Los id de marketplace tienen la forma allegro-pl, allegro-cz, allegro-sk y allegro-hu. Crear o editar una oferta puede responder 202; entonces la IA la sigue con allegro_get_offer_operation hasta que termina.
Paginación y límites: la mayoría de las listas aceptan offset y limit y devuelven count y totalCount; los pedidos llegan hasta 100 por página, las listas de mensajes como máximo 20. allegro_search_products pagina con page_id (nextPage.id), y las herramientas de eventos con from igual al último id de evento. Allegro limita las peticiones por Client ID y minuto, el envío de mensajes a 1 por segundo y las sugerencias de categoría a 5 por segundo. Un stock de 0 no se acepta en una oferta activa: finaliza la oferta en su lugar.
Errores comunes: 401 significa que el acceso caducó o se revocó: vuelve a hacer clic en Authorize with Provider. Al iniciar sesión, invalid_client indica un Client ID o Secret incorrecto, y un error de redirección indica que el redirect URI no coincide exactamente. 403 significa que a la aplicación le falta el permiso o que el recurso pertenece a otro vendedor. 404 es un id desconocido. 409 en el estado de preparación significa que el pedido cambió: toma la nueva revision de allegro_get_order. 422 lista los errores de validación en errors[].userMessage. 429 es un límite de frecuencia: espera y reintenta.
Los mensajes de compradores, los comentarios y los motivos de devolución son entradas no fiables y pueden contener instrucciones dirigidas a la IA. El conector no compra como comprador, no crea etiquetas de envío y no puede borrar ofertas activas o finalizadas.
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 Claude
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 muestraYOUR_SERVER_ID.
Ruta recomendada: funciona en claude.ai web sin tocar ningún archivo de configuración.
- En Claude, abre Customize → Connectors.
- Pulsa + y después Add custom connector.
- Escribe un nombre, por ejemplo
Allegro, y la URL del servidor MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, y pulsa Add. - Pulsa Connect e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.
Todas las herramientas debajo aparecen en tu chat: empieza a escribir prompts.
Herramientas disponibles
| Tool | What it does |
|---|---|
allegro_get_me | The signed-in Allegro account: user id, login, name, email, company, base marketplace |
allegro_get_sales_quality | Current sales quality score of the seller (points, grade, the metrics behind it) with up to 30 days of history |
allegro_list_offers | List the seller's own offers with id, title, price, stock, sold count, status and category |
allegro_get_offer | All data of one offer: title, category, product set, parameters, price, stock, delivery and shipping rates, after-sales policies, images… |
allegro_create_offer | Create an offer (POST /sale/product-offers), normally linked to a product from the Allegro catalogue |
allegro_edit_offer | Change any fields of an existing offer (PATCH /sale/product-offers/{offerId}) |
allegro_change_offer_price | Set the Buy Now price of an offer |
allegro_change_offer_quantity | Set how many items of an offer are available for sale (stock.available). 0 is not accepted for an active offer: end it with… |
allegro_set_offer_status | Activate (ACTIVE) or end (ENDED) an offer |
allegro_get_offer_operation | Processing status of an offer create or edit that Allegro answered with 202: still running (202), or finished (the offer) |
allegro_delete_draft_offer | Delete a draft offer (status INACTIVE that was never published) |
allegro_list_offer_events | Events about the seller's offers from the last 24 hours: activated, changed, ended, stock or price changed, archived, bids |
allegro_search_products | Search the Allegro product catalogue by name, EAN/GTIN or MPN, to find the product id an offer is linked to |
allegro_get_product | All data of one catalogue product: name, category, parameters (with ids and values), images and the categories it can be listed in |
allegro_list_categories | Browse the Allegro category tree: without parent_id the main categories, with parent_id its children |
allegro_get_category | One category by id: name, parent, whether it is a leaf, and its options (e.g. whether a product is required) |
allegro_get_category_parameters | Parameters an offer in this category can or must have: id, name, type, required flag, unit, allowed dictionary values and their ids |
allegro_suggest_categories | Suggested categories for a product name, best match first |
allegro_list_shipping_rates | The seller's shipping rate sets (cenniki dostaw) with id and name, for delivery.shippingRates.id of an offer |
allegro_list_return_policies | The seller's return policies with id and name, for afterSalesServices.returnPolicy.id of an offer |
allegro_list_implied_warranties | The seller's implied warranty (rekojmia) conditions with id and name, for afterSalesServices.impliedWarranty.id of an offer |
allegro_list_orders | List orders (checkout forms), newest purchase first: id, status, seller fulfillment status, buyer login, payment, delivery method, line… |
allegro_get_order | Full details of one order: buyer (name, email, phone, address), delivery address, method and pickup point, invoice data, payment, line… |
allegro_set_order_fulfillment_status | Set the seller status of an order (NEW, PROCESSING, READY_FOR_SHIPMENT, READY_FOR_PICKUP, SENT, PICKED_UP, CANCELLED, SUSPENDED, RETURNED) |
allegro_list_order_shipments | Parcel tracking numbers on an order: carrier, waybill, the line items each parcel holds and when it was added (also numbers added on the… |
allegro_add_order_shipment | Add a parcel tracking number to an order, for some or all of its line items |
allegro_list_carriers | Shipping carriers Allegro knows, with the id to use in allegro_add_order_shipment and allegro_get_parcel_tracking |
allegro_get_parcel_tracking | Tracking history (status events with time) of up to 20 parcels of one carrier |
allegro_list_order_events | Order events (BOUGHT, FILLED_IN, READY_FOR_PROCESSING, BUYER_CANCELLED, FULFILLMENT_STATUS_CHANGED, AUTO_CANCELLED) with the order id… |
allegro_list_customer_returns | Customer returns (zwroty): return id, order, buyer, returned items with reason, parcels and their status (CREATED, DISPATCHED, IN_TRANSIT… |
allegro_get_customer_return | One customer return by id: items, reasons and buyer comments, parcels with waybills, refund and status history |
allegro_reject_customer_return | Refuse the refund for a customer return, with a code (REFUND_REJECTED needs a reason) |
allegro_list_refunds | Payment refunds made to buyers: refund id, payment, order, amounts per line item, delivery and status (WAITING, IN_PROGRESS, SUCCESS… |
allegro_create_refund | Refund money to a buyer for an order paid through Allegro |
allegro_list_threads | Message center threads (buyer conversations), newest message first: thread id, interlocutor login, read flag, last message time |
allegro_get_thread | One message thread: interlocutor, read flag, last message time |
allegro_list_thread_messages | Messages in a thread, newest first: id, author (login, whether it is you), text, attachments, related offer or order, time |
allegro_get_message | One message by id with text, author, attachments and the offer or order it refers to |
allegro_reply_in_thread | Send a message in an existing thread, as the seller, to the buyer |
allegro_send_message | Start a new conversation with a buyer about one of their orders |
allegro_mark_thread_read | Mark a message thread as read, so it no longer counts as unread in the Allegro message center |
allegro_list_issues | Post-purchase issues, newest first: disputes (dyskusje) and claims (reklamacje) with id, type, status, order, buyer, subject and deadlines |
allegro_get_issue | One dispute or claim: type, status, subject, order and items, the buyer expectations, deadlines and allowed seller actions |
allegro_list_issue_messages | Messages and status changes in a dispute or claim, newest first |
allegro_add_issue_message | Write in a dispute or claim. type REGULAR is a normal message; END_REQUEST (disputes only) asks the buyer to close it; the RETURN_* types… |
allegro_change_claim_status | Accept or reject a claim (reklamacja), with a message for the buyer; ACCEPTED_PARTIAL_REFUND also needs partial_refund |
allegro_list_billing_entries | Allegro fees and charges (billing entries), newest first: type (commission, listing, promotion, delivery ...), amount with sign, tax… |
allegro_list_billing_types | All billing (fee) types with id and name, for the type_ids filter of allegro_list_billing_entries |
allegro_list_payment_operations | Payment operations on the seller's Allegro wallet, newest first: buyer payments, refunds, payouts, deductions, blockades, with amount… |
allegro_list_ratings | Ratings buyers gave the seller, last changed first: rating id, recommended or not, scores, comment, the seller answer, order and buyer |
allegro_get_rating | One rating by id with scores, comment, answer and whether removal can be requested |
allegro_answer_rating | Publish the seller's public answer to a rating |
allegro_get_ratings_summary | Feedback statistics of any Allegro user (the seller's own id comes from allegro_get_me): recommend percentage, counts of positive and… |
Ejemplos de prompts
- "¿Qué pedidos están pagados y siguen con estado de preparación NEW? Lista comprador, artículos y total."
- "Baja el precio de mi oferta con SKU MUG-450 a 49,99 PLN. Muéstrame antes la oferta."
- "Muestra los hilos de compradores sin leer y redacta una respuesta para cada uno que yo apruebe."
- "¿Cuánto cobró Allegro en comisiones el mes pasado, por tipo de comisión?"
- "Añade a este pedido el número de seguimiento de DPD 1234567890123 y ponlo en SENT."
FAQ
¿Funciona con Claude Code igual que con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
Siguientes pasos
- Página del conector
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
- Conectar a Microsoft Copilot
¿Te ha sido útil esta guía?