Beaconed

@beaconed/mcp

Servidor MCP que expone la API v1 de Beaconed a Claude Desktop, Cursor y cualquier cliente compatible con MCP. Pídele a Claude que liste tus productos, ponga optimizaciones en cola, apruebe copias generadas por IA y gestione webhooks, todo mediante lenguaje natural.

Requiere Node.js 22 o posterior.

Instalación

npm install -g @beaconed/mcp

Configuración

Agrega a tu claude_desktop_config.json de Claude Desktop:

{
  "mcpServers": {
    "beaconed": {
      "command": "beaconed-mcp",
      "env": {
        "BEACONED_API_KEY": "your-api-key"
      }
    }
  }
}

Obtén tu clave de API en beaconed.ai en Configuración > Claves de API.

Establece BEACONED_BASE_URL para sobrescribir el https://beaconed.ai predeterminado (útil para desarrollo local o staging).

Herramientas

Herramientas de lectura

• beaconed_products_list — lista productos con filtros por estado, puntuación, calificación y búsqueda por título
• beaconed_products_get — detalle completo del producto, incluidas imágenes, historial de puntuación y la última optimización
• beaconed_products_scores — historial de puntuación de un producto específico
• beaconed_products_optimizations — lista optimizaciones limitadas a un producto
• beaconed_optimizations_list — lista todas las optimizaciones generadas por IA en todos los productos
• beaconed_optimizations_get — detalle completo de la optimización (contenido original vs. sugerido)
• beaconed_scores_list — puntuaciones de preparación en todos los productos
• beaconed_scores_latest — última puntuación por producto
• beaconed_settings_get — configuración de optimización de la cuenta (voz de marca, palabras clave, configuración de envío automático)
• beaconed_webhooks_list — lista suscripciones a webhooks
• beaconed_webhooks_get — detalle del webhook, incluida la información del último error
• beaconed_webhooks_events — catálogo global de todos los tipos de eventos de webhook disponibles

Herramientas de mutación

• beaconed_products_create — crea un producto a partir de datos externos (no Shopify)
• beaconed_products_update — actualiza campos del producto (actualización parcial)
• beaconed_products_sync — actualiza todos los productos de la tienda del producto seleccionado desde Shopify (límite de solicitudes: 10/min)
• beaconed_products_optimize — pone en cola la optimización de IA para uno o más campos del producto (límite de solicitudes: 10/min)
• beaconed_products_calculate_score — recalcula la puntuación de preparación de un producto (límite de solicitudes: 10/min)
• beaconed_optimizations_approve — aprueba una optimización pendiente; puede publicar contenido en vivo cuando el envío automático está habilitado (límite de solicitudes: 10/min)
• beaconed_optimizations_reject — rechaza una optimización pendiente con un motivo opcional
• beaconed_optimizations_apply — solicita la aplicación de una optimización aprobada al producto en vivo (DESTRUCTIVO, límite de solicitudes: 10/min)
• beaconed_optimizations_revert — solicita la reversión de una optimización aplicada al contenido original (DESTRUCTIVO, límite de solicitudes: 10/min)
• beaconed_webhooks_create — crea una suscripción a webhook (el secreto de firma se devuelve solo una vez)
• beaconed_webhooks_update — actualiza la URL, los eventos o el estado de un webhook
• beaconed_webhooks_delete — elimina permanentemente una suscripción a webhook (DESTRUCTIVO)
• beaconed_webhooks_test — envía un evento de prueba para verificar la entrega
• beaconed_bulk_optimize — pone en cola la optimización de IA para múltiples productos en una sola solicitud (límite de solicitudes: 10/min)

Este paquete usa stdio y requiere Node.js 20+. Las herramientas operan en la cuenta asociada con BEACONED_API_KEY.

La optimización utiliza créditos de la cuenta; el límite de solicitudes anterior es un límite de velocidad, no un precio. La aceptación en la cola no confirma la finalización. Lee los detalles del producto o de la optimización para verificar el resultado. La aprobación puede publicar de inmediato o poner en cola una escritura en Shopify cuando auto_push_on_approve está habilitado; inspecciona la configuración de la cuenta y el contenido propuesto antes de aprobar. Aplicar o revertir puede reemplazar el contenido en vivo.

Las anotaciones de las herramientas describen efectos de solo lectura, reemplazo, llamadas repetidas y sistemas externos. Los clientes pueden usar estas sugerencias al solicitar confirmación; las anotaciones no imponen la confirmación.

Las implementaciones alojadas deben limitar la velocidad de POST /register en un borde confiable usando la dirección de cliente verificada. El servicio Node ignora deliberadamente los encabezados de dirección de cliente reenviados porque aceptarlos sin un límite de proxy autenticado permitiría a los llamantes falsificar la identidad del límite de velocidad.

El contenedor de producción y la configuración requerida están documentados en docs/deployment.md.

Licencia

MIT — consulta LICENSE.

Publicación en el registro

server.json describe el paquete npm stdio. Su nombre coincide con mcpName en package.json; ambas versiones deben coincidir con la versión que se está enviando. Publica y verifica esa versión exacta de npm antes de ejecutar mcp-publisher publish. La aceptación del registro y la aprobación del directorio son independientes de una publicación en npm.