Cómo conectar Allegro a Gemini vía MCP

💡 ¿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 + Gemini

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).

1. 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.
2. Registra una aplicación nueva del tipo que se usa con un navegador y una redirección, no el device flow.
3. Como redirect URI introduce <your AnythingMCP URL>/api/mcp-oauth/callback, en AnythingMCP Cloud https://cloud.anythingmcp.com/api/mcp-oauth/callback, carácter por carácter.
4. 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.
5. Pega el Client ID en ALLEGRO_CLIENT_ID y el Client Secret en ALLEGRO_CLIENT_SECRET y guarda.
6. En la página del conector haz clic en Authorize with Provider e inicia sesión con la cuenta de vendedor.
7. 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 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 Allegro.

Herramientas disponibles

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

¿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