Conectar Back Market MCP con Gemini CLI

💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Back Market, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

Back Market + Gemini

API de vendedor de Back Market para reacondicionadores: pedidos con aceptación y envío con seguimiento, listados con precio y stock, precios de Backbox y competidores, categorías, carpetas y mensajes de atención al cliente, entregas de BackShip y pedidos de BuyBack. Token de API, por plataforma (Europa, Estados Unidos, Asia-Pacífico).

Requisitos previos

Consulta las instrucciones completas de configuración incluidas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:

BACK_MARKET_HOST, BACK_MARKET_TOKEN, BACK_MARKET_MARKET

Paso 1 — Obtener credenciales

La configuración tarda aproximadamente 3 minutos.

1. Inicia sesión en la oficina de Back Market de tu plataforma: https://www.backmarket.fr/bo-seller (Europa), https://www.backmarket.com/bo-seller (Estados Unidos) o https://www.backmarket.co.jp/bo-seller (Japón y Australia). El acceso a la API viene con una cuenta de vendedor que Back Market ha validado.
2. Abre la página de Integraciones en Opciones y crea un token de API.
3. Pega el token como se muestra en BACK_MARKET_TOKEN, sin la palabra Basic al principio: el conector lo envía como Authorization: Basic seguido del token.
4. Elige tu plataforma en BACK_MARKET_HOST y tu mercado principal en BACK_MARKET_MARKET (por ejemplo, fr-fr en Europa, en-us en Estados Unidos, ja-jp en Asia-Pacífico). El mercado debe pertenecer a la plataforma.

Cada llamada lleva el mercado en Accept-Language y el User-Agent BM-AnythingMCP-Connector, que Back Market requiere. Las herramientas con un argumento market pueden mirar otro mercado de la misma plataforma para una llamada.

Dónde empezar: back_market_list_orders con estado 1 muestra pedidos pagados cuyas líneas debes aceptar, estado 3 los pedidos a enviar. back_market_list_listings muestra tus ofertas; back_market_list_backbox indica cuáles de ellas tienen el Backbox.

Flujo de trabajo de pedidos: un pedido llega en estado 1 una vez que se valida el pago (nunca envíes en estados 0, 8 o 10). Acepta cada línea con back_market_accept_order_line (estado de línea 1 a 2); el pedido luego pasa a estado 3. Envía con back_market_ship_order y un número de seguimiento (todas las líneas van en un solo paquete, estado del pedido 9). back_market_get_order muestra los estados de las líneas. back_market_set_order_line_identifiers almacena el IMEI o número de serie del dispositivo; no se puede corregir después. back_market_cancel_order_line y back_market_refund_order_line están instalados desactivados: ambos reembolsan al cliente y no pueden deshacerse, y las cancelaciones afectan al Backbox.

Listados: un listado cubre todos los mercados de la plataforma. La cantidad es compartida; el precio, comentario y garantía son por mercado. back_market_get_listing encuentra un listado por SKU; back_market_update_listing cambia el precio o stock en tiempo real (cantidad 0 lo saca de línea). back_market_import_listings (desactivado) envía un CSV para muchos listados a la vez y responde con un id de tarea para back_market_get_task. back_market_get_competitors muestra el precio necesario para ganar el Backbox por mercado. back_market_get_category_tree y back_market_get_category_branch dan las categorías y los atributos que necesita un nuevo producto.

Atención al cliente: back_market_list_care_folders y back_market_get_care_folder leen casos de postventa con sus mensajes; back_market_send_care_message responde al cliente. back_market_create_care_refund está instalado desactivado.

BackShip y BuyBack: back_market_list_deliveries y back_market_list_returns solo devuelven datos para vendedores que utilizan las etiquetas de envío BackShip de Back Market. back_market_list_buyback_orders y back_market_get_buyback_order leen pedidos de intercambio; validar o contrarrestar uno decide lo que se le paga al cliente y no está incluido.

Formatos: los precios son cadenas decimales con impuestos, en la moneda del mercado (160.99). Los ids de pedidos y los ids de líneas de pedido son enteros; los ids de listados son UUIDs (el id numérico de listado está en desuso). Las fechas son RFC 3339; los filtros de carpetas de atención utilizan YYYY-MM-DD-hh-mm. Las listas responden con count, next, previous y results; next es nulo en la última página.

Límites: más de 200 llamadas en 10 segundos se bloquean durante 10 segundos (llamadas de catálogo: 20 en 10 segundos), con un 429. Las actualizaciones de listados están limitadas a aproximadamente 2,000 líneas SKU por hora. Las llamadas de atención tienen límites diarios (lista de carpetas 4,000 al día, reembolsos 500 al día).

Respuestas 403: Back Market está detrás de Cloudflare. Un 403 con una página HTML o el código bot-need-challenge significa que el firewall bloqueó al llamador, no que el token sea incorrecto: envía el valor cf-ray de la respuesta a tu contacto de Back Market. Un token incorrecto o faltante también responde con 403 o 401, con un error JSON.

Paso 2 — Instalar el adaptador

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 Back Market.

Herramientas disponibles

Ejemplos de indicaciones

• "¿Qué pedidos de Back Market tienen líneas esperando mi aceptación?"
• "¿Cuáles de mis listados han perdido el Backbox, y qué precio lo ganaría de nuevo?"
• "Establece el stock de mi listado de iPhone 13 reacondicionado de 128 GB en 12."
• "Envía el pedido 41234567 con seguimiento de Colissimo 6A12345678901 y el IMEI de cada línea."
• "¿Qué carpetas de atención al cliente están abiertas, y qué preguntan los clientes?"

Preguntas frecuentes

¿Dónde obtengo el token de API? En la oficina de Back Market de tu plataforma, Opciones, Integraciones. Pega el token como se muestra, sin la palabra Basic, y elige tu plataforma (Europa, Estados Unidos o Asia-Pacífico) y mercado principal. El acceso a la API viene con una cuenta de vendedor que Back Market ha validado.

¿Qué mercados cubre? Cada mercado de la plataforma en la que está tu cuenta: los mercados europeos en backmarket.fr, Estados Unidos en backmarket.com, y Japón y Australia en backmarket.co.jp. Las herramientas con un argumento de mercado pueden mirar otro mercado de la misma plataforma.

¿Qué herramientas están instaladas desactivadas? back_market_cancel_order_line, back_market_refund_order_line, back_market_create_care_refund y back_market_import_listings, porque reembolsan a los clientes o reemplazan listados en bloque. Actívalas en la página del conector solo si la IA debe usarlas.

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

Próximos pasos

• Página de inicio del conector
• Conectar a Claude