Servidor MCP de Turbodato

Qué es

Turbodato monitorea todos los días los precios de tus productos en retailers y marketplaces y los compara con los de tu propio sitio. El servidor MCP le abre esos datos a Claude —y a cualquier otro cliente que hable el Model Context Protocol— para que hagas preguntas en castellano en vez de filtrar el tablero a mano:

• “¿En qué productos hoy hay un competidor más barato que yo?”
• “¿Quién está vendiendo el Acme 500 ml por debajo de nuestro precio sugerido?”
• “¿Cómo cambió esta semana nuestra posición de precio en la categoría Bebidas?”
• “Exportá la matriz de precios de la marca X y resumí las brechas más grandes.”

El conector es de solo lectura. No puede cambiar precios, productos, alertas ni ninguna configuración de tu cuenta.

Requisitos

• Una cuenta de Turbodato con acceso a al menos un tablero. Turbodato es un producto pago; si todavía no tenés cuenta, agendá una llamada.
• Un cliente MCP que soporte servidores remotos con OAuth: Claude (web, escritorio y celular), Claude Code u otros.

Cómo conectarlo

URL del servidor:

https://app.turbodato.com/api/mcp

Transporte: Streamable HTTP. Autenticación: OAuth 2.1 con registro dinámico de clientes; no hay ninguna API key para pegar.

Claude (web, escritorio, celular)

• Abrí Configuración → Conectores y agregá Turbodato desde el directorio, o elegí Agregar conector personalizado y pegá la URL del servidor.
• Hacé clic en Conectar. Se abre una ventana de Turbodato: entrá con tu usuario de siempre (si ya tenés la sesión abierta, pasás directo al paso siguiente).
• Revisá el pedido y hacé clic en Permitir. Volvés a Claude y las herramientas quedan disponibles en tus chats.

Claude Code

claude mcp add --transport http turbodato https://app.turbodato.com/api/mcp

Después corré /mcp dentro de Claude Code y elegí Authenticate para terminar el inicio de sesión en el navegador.

Otros clientes MCP

En cualquier cliente que soporte servidores MCP remotos con OAuth, agregá un servidor nuevo con la URL de arriba. El cliente te va a pedir que entres a Turbodato y que autorices el acceso; no hace falta configurar nada más.

Qué puede ver el asistente

La conexión actúa como vos, con el permiso turbodato:read. El asistente ve exactamente los tableros que ve tu usuario de Turbodato, nada más:

• Un miembro ve solo los tableros a los que está vinculado.
• Los dueños y administradores de la organización ven todos los tableros de su organización.

El acceso se vuelve a chequear en cada llamada: si un administrador te saca el acceso a un tablero, el asistente también lo pierde. Los tokens de acceso duran una hora y los de renovación 30 días; cuando se da de baja a un usuario en Turbodato, su conector deja de funcionar en menos de una hora.

Herramientas

Todas son de solo lectura. Todas salvo list_clients reciben un clientId (un tablero), que el asistente obtiene de list_clients.

list_clients

Lista los tableros a los que tenés acceso, con su id y su nombre. Es lo primero que llama el asistente.

get_semaphore

El resumen del semáforo de tu posición de precio: cuántos productos están por encima, a la par o por debajo de la competencia, con porcentajes. Rojo significa que un competidor está más barato que tu sitio; verde, que los competidores están más caros. Es la forma más barata de tener una lectura general. Acepta los filtros comunes de más abajo.

get_data

La matriz detallada de precios: cada uno de tus productos con los precios relevados por retailer y por seller. Paginada (hasta 100 filas por página). Además de los filtros comunes acepta semaphore (red, yellow, green), order_by (priceASC, priceDESC, discountASC, discountDESC), page y limit. En los packs de varias unidades devuelve el precio por unidad, y en las marcas con precio sugerido marca las ofertas que están por debajo.

get_suggested_price

Cumplimiento del precio sugerido (PVP / MAP): cuántos productos y ofertas están por debajo del precio sugerido de la marca, más las ofertas que lo incumplen, de la peor a la mejor (hasta 500). Solo para tableros que siguen un precio sugerido.

get_filters

Los valores de filtro válidos de un tablero: categorías, marcas, sellers y sitios.

get_dates

Las fechas con precios relevados, para usar en el filtro date.

export_data

Exportación masiva de la matriz de precios en JSON, con un tope de 500 productos, para analizar muchos productos de una vez.

Filtros comunes

• brand, category, site, seller: valores exactos de get_filters.
• text: búsqueda libre por nombre de producto, EAN, SKU y marca.
• date: fecha del relevamiento, AAAA-MM-DD, de get_dates.
• favorites: solo los productos que marcaste con estrella en el tablero.

Límites

• 60 llamadas a herramientas por minuto por usuario. Pasado ese límite, la herramienta responde pidiendo que espere y el asistente reintenta solo.
• Hasta 100 filas por página de get_data y 500 productos por llamada a export_data, para que los resultados entren en lo que el modelo puede leer.

Cómo desconectarlo

En Claude, andá a Configuración → Conectores, abrí Turbodato y elegí Desconectar. Eso borra los tokens que guarda Claude. En Claude Code, corré claude mcp remove turbodato.

Problemas frecuentes

• “No access to that clientId.” Ese tablero no está vinculado a tu usuario. Pedile acceso al administrador de tu organización y después pedile al asistente que vuelva a listar tus tableros.
• El asistente dice que no hay tableros. Tu usuario todavía no tiene ningún tablero asignado; hablá con tu administrador o con el soporte de Turbodato.
• get_suggested_price devuelve un error. Ese tablero no sigue un precio sugerido. Usá get_semaphore o get_data.
• El conector te pide que vuelvas a entrar. Los tokens de renovación duran 30 días; después de eso, volvé a conectarlo desde Configuración → Conectores.

Privacidad y seguridad

En la política de privacidad del conector MCP (en inglés) está qué recibe el conector, qué registra Turbodato y por cuánto tiempo lo guarda.

Soporte

Escribinos a santiago@turbodato.com. Respondemos en castellano y en inglés.