Cómo conectar Allegro a Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Allegro.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

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

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

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