Saltar al contenido principal

ANYMARKET MCP

El ANYMARKET MCP es un puente que te permite conversar con ANYMARKET usando lenguaje natural dentro de tu asistente de IA favorito (Claude, ChatGPT, Gemini y otros). En lugar de abrir el panel y navegar por varios menús para consultar información, tú preguntas — en español mismo — y la IA busca la respuesta por ti.

Importante: por ahora, ANYMARKET MCP ofrece solo comandos de consulta (lectura). Puedes preguntar, listar, buscar y revisar información, pero aún no es posible crear, modificar o eliminar datos a través del asistente. Las acciones de escritura se habilitarán en versiones futuras.

Algunos ejemplos de lo que puedes pedir hoy:

  • "Lista los 10 productos más recientes de ANYMARKET."
  • "¿Cuántos pedidos entraron hoy?"
  • "Muéstrame los productos que están sin stock."
  • "¿Cuál es el precio actual de este SKU?"
  • "¿Qué anuncios están publicados en Mercado Libre?"
  • "Tráeme los detalles del pedido número 12345."

No necesitas saber programar ni entender de API — el asistente se encarga de eso. Esta guía muestra cómo conectar cada asistente al ANYMARKET MCP.

Antes de empezar

Vas a necesitar:

  • Cuenta en ANYMARKET con permiso para acceder a los recursos que quieres consultar (productos, pedidos, stock, etc.).
  • Un asistente de IA compatible con MCP ya instalado en tu computadora — por ejemplo, Claude Code, Claude Desktop, Codex CLI, ChatGPT (vía Connectors) o Gemini CLI.
  • Dirección del servidor MCP: https://mcp.anymarket.com.br/mcp — es la misma para todos, solo tienes que pegar esta URL en la configuración de tu asistente.

La primera vez que la uses, el asistente abrirá el navegador para que inicies sesión en ANYMARKET. Después de eso, la recuerda hasta que cierres la sesión.

Qué puedes consultar

ANYMARKET MCP cubre prácticamente todas las áreas del panel — siempre en modo solo lectura:

ÁreaQué puedes consultar
Productoslistar, buscar por SKU, ver detalles e historial de ventas
SKUs y variacionesrevisar tamaños, colores, versiones y atributos registrados
Stockver saldo por SKU, consultar depósitos y movimientos
Preciosconsultar los precios actuales de los artículos
Pedidoslistar, ver detalles, seguir estado y mensajes
Categorías, marcas y etiquetasconsultar la organización del catálogo
Imágeneslistar las fotos vinculadas a cada producto
Marketplacesver lo que está publicado en cada canal (Mercado Libre, Shopee, Amazon, etc.)
Callbacks (webhooks)listar los avisos automáticos ya configurados
Sugerencias, características y orígenesconsultar apoyo al registro

En total son más de 100 comandos de consulta disponibles — pero no necesitas memorizar nada. Basta con pedir en lenguaje natural y el asistente elige el comando correcto.

Cómo conectar en cada asistente

Todas las configuraciones de abajo usan la misma dirección: https://mcp.anymarket.com.br/mcp

Claude Code

Abre la terminal y ejecuta uno de estos comandos:

Para dejarlo disponible en todos tus proyectos:

claude mcp add --scope user --transport http anymarket https://mcp.anymarket.com.br/mcp

Para dejarlo disponible solo en el proyecto actual:

claude mcp add --scope project --transport http anymarket https://mcp.anymarket.com.br/mcp

Cierra y vuelve a abrir Claude Code. La primera vez que pidas algo relacionado con ANYMARKET, el navegador se abrirá para que inicies sesión.

Claude Desktop

Hay dos formas de conectar — desde la propia interfaz de Claude Desktop (más simple, recomendada) o editando el archivo de configuración (para quien prefiera).

Opción 1 — Directamente en Claude Desktop (recomendada)

Si usas Claude Desktop con una cuenta personal, o si el administrador de tu organización (si existe) lo ha habilitado, puedes agregar ANYMARKET sin tocar ningún archivo:

  1. Abre Claude Desktop.
  2. Ve a Settings → Connectors (o Configuración → Conectores).
  3. Haz clic en Add custom connector (Agregar conector personalizado).
  4. Completa:
    • Name: ANYMARKET
    • URL: https://mcp.anymarket.com.br/mcp
  5. Guarda y activa el conector.

Listo — ANYMARKET ya aparece disponible en tus conversaciones. La primera vez que pidas algo, Claude abrirá el navegador para que inicies sesión.

¿No ves la opción "Add custom connector"? Significa que el administrador de tu organización aún no ha habilitado los conectores personalizados. Pídele que lo habilite o usa la Opción 2 de abajo.

Opción 2 — Editando el archivo de configuración

Abre el archivo de configuración de Claude Desktop:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Pega (o combina con lo que ya existe):

{
"mcpServers": {
"anymarket": {
"type": "http",
"url": "https://mcp.anymarket.com.br/mcp"
}
}
}

Cierra completamente y vuelve a abrir Claude Desktop. Inicia sesión la primera vez que uses ANYMARKET en una conversación.

Codex CLI (OpenAI)

Abre el archivo ~/.codex/config.toml (en Windows: %USERPROFILE%\.codex\config.toml) y agrega:

[mcp_servers.anymarket]
url = "https://mcp.anymarket.com.br/mcp"

Reinicia Codex CLI. Una vez conectado, usa /mcp para confirmar que ANYMARKET aparece en la lista.

ChatGPT (Connectors)

En ChatGPT desktop, ve a Settings → Beta features → Connectors → Add custom connector y completa:

  • Name: ANYMARKET
  • URL: https://mcp.anymarket.com.br/mcp
  • Auth: OAuth (sigue las instrucciones en pantalla — la autorización la hace el propio ANYMARKET)

Guarda, marca el conector como activo y elige el modo Agent en la conversación.

Gemini CLI (Google)

Abre el archivo ~/.gemini/settings.json (en Windows: %USERPROFILE%\.gemini\settings.json) y agrega:

{
"mcpServers": {
"anymarket": {
"httpUrl": "https://mcp.anymarket.com.br/mcp",
"timeout": 30000,
"trust": false
}
}
}

Reinicia Gemini CLI y lista los comandos disponibles con /tools.

Probar que funcionó

Después de conectar, pídele al asistente:

"Lista los 5 productos más recientes de ANYMARKET."

Si aparece la lista, todo está en orden. Si quieres verificar con qué cuenta estás conectado, pide:

"Muéstrame en qué organización de ANYMARKET estoy conectado."

Buenas prácticas

  • Usa lenguaje claro. Cuanto más específico sea el pedido (SKU, nombre del producto, período), mejor el resultado.
  • Empieza con pocos elementos. Al pedir listados, solicita primero un número pequeño (por ejemplo, "los 5 primeros") para ver el formato antes de pedir volúmenes mayores.
  • ¿Necesitas modificar algo? Como el MCP hoy es solo de consulta, cualquier cambio (registro, edición, publicación, ajuste de precio o stock) aún tiene que hacerse directamente en el panel de ANYMARKET.

Problemas comunes

Qué sucedeMotivo probableQué hacer
El asistente no reconoce comandos de ANYMARKETLa configuración no se guardó o el asistente no se reinicióRevisa el archivo de configuración y reinicia el asistente
Aparece error de "no autorizado"Tu sesión expiróInicia sesión de nuevo en el asistente cuando lo pida
Aparece error de permiso en algún recursoTu organización no tiene acceso a esa consultaPídele al administrador de la cuenta ANYMARKET que revise tus permisos
Mensaje de "demasiadas solicitudes"Hiciste muchas solicitudes en poco tiempoEspera unos segundos e intenta de nuevo con un volumen menor
El inicio de sesión no se abre en el navegadorTu asistente está desactualizadoActualiza tu asistente a la última versión
Pediste modificar/crear algo y el asistente no lo hizoEl MCP hoy es solo lecturaHaz el cambio desde el panel de ANYMARKET; las acciones de escritura se habilitarán en versiones futuras

¿Necesitas ayuda?

Si algo no funciona, ponte en contacto con el equipo responsable de ANYMARKET en tu empresa — tienen acceso al servidor y pueden verificar si todo está funcionando correctamente.