DataDoe
Servidor MCP alojado para vendedores y proveedores de Amazon. Conecta Claude, ChatGPT, Cursor, Codex, Gemini, GitHub Copilot con datos en vivo de las API SP-API y Ads API de Amazon.
Documentación
Servidor MCP de Amazon Seller - DataDoe
Servidor MCP alojado para Amazon Seller Central y Vendor Central con acceso de lectura y escritura. Conecta Claude, ChatGPT, Cursor, Codex, Gemini y GitHub Copilot a datos en vivo de Amazon SP-API y Amazon Ads API, y deja que tu agente de IA actúe sobre ellos: actualiza listados, gestiona pedidos y optimiza campañas de Amazon Ads. DataDoe se encarga de la aprobación de desarrollador SP-API, OAuth y los límites de tasa para que tu agente de IA empiece a trabajar en menos de un minuto.
🔗 Comienza una prueba gratuita · 📘 Documentación · ⚡ Acciones · 📊 Esquema de datos de Amazon · 🎥 Demo en video
🚀 Inicio rápido
-
Regístrate en DataDoe y conecta tu cuenta de Amazon Seller Central o Vendor Central.
-
Crea una clave API MCP de DataDoe en Integraciones MCP de DataDoe.
-
Pega la configuración a continuación en tu cliente de IA (Claude, Cursor, Codex, Gemini, GitHub Copilot, ChatGPT o cualquier herramienta compatible con MCP):
{ "mcpServers": { "datadoe": { "url": "https://mcp.datadoe.com/mcp/v1", "headers": { "datadoe-mcp-key": "<YOUR_DATADOE_MCP_KEY>" } } } } -
Pregunta a tu agente de IA: "Muéstrame mis 10 ASIN principales por ingresos del último mes en todos los marketplaces de Amazon."
Eso es todo. DataDoe ejecuta el servidor MCP en infraestructura alojada, por lo que tu equipo no necesita implementar nada localmente ni esperar la aprobación de desarrollador de Amazon SP-API.
¿Qué es DataDoe MCP?
DataDoe MCP es un servidor alojado de Model Context Protocol (MCP) para vendedores, proveedores y agencias de Amazon. Expone tus datos en vivo de la API de Selling Partner de Amazon (SP-API) y de Amazon Ads API a través de herramientas MCP que funcionan con Claude, ChatGPT, Cursor, Codex CLI, Gemini CLI, GitHub Copilot, Claude Desktop, n8n, NanoClaw y cualquier otro cliente compatible con MCP.
DataDoe MCP brinda a tu agente de IA dos capas sobre tu cuenta de Amazon:
- Una capa de lectura: pedidos a nivel de SKU, ventas, gasto en anuncios, tráfico, inventario, listados, devoluciones, liquidaciones, análisis de marca y catálogo, devueltos como respuestas de herramientas estructuradas o exportaciones descargables en CSV y JSON.
- Una capa de escritura (Acciones): tu agente puede cambiar tu cuenta de Amazon a través de SP-API y Amazon Ads API: actualizar listados, cancelar pedidos, confirmar envíos y gestionar campañas de Amazon Ads, grupos de anuncios, targets y anuncios.
Crear tu propia integración con Amazon SP-API normalmente requiere registro de desarrollador SP-API, flujo de token de actualización OAuth, endpoints específicos por marketplace, lógica de limitación de tasa y de 2 a 4 semanas de aprobación de Amazon. DataDoe se encarga de todo eso. Obtienes una única URL MCP autenticada tanto para leer como para actuar sobre tus datos de Amazon.

¿Para quién es DataDoe MCP?
- Vendedores de Amazon (FBA, FBM, multi-marketplace): obtén respuestas instantáneas de tus propios datos de vendedor sin cambiar de contexto a Seller Central.
- Agencias de Amazon que gestionan múltiples cuentas de clientes: consulta todas las cuentas conectadas de Seller Central / Vendor Central desde un solo servidor MCP.
- Proveedores con Vendor Central: lee datos 1P junto con datos 3P con las mismas herramientas.
- Desarrolladores y creadores de IA: lanza agentes de IA conscientes de Amazon, paneles y herramientas internas sin escribir tu propia integración SP-API.
- Equipos de operaciones: automatiza informes recurrentes mediante Claude Code, Cursor, n8n o cualquier herramienta de flujo de trabajo compatible con MCP.
¿Por qué usar DataDoe MCP?
- ✅ No se necesita aprobación SP-API: DataDoe gestiona el registro de desarrollador SP-API, OAuth, tokens de actualización y límites de tasa en tu nombre.
- ✅ Configuración en 30 segundos: pega la URL MCP y tu clave API en la configuración de tu cliente de IA. DataDoe ejecuta el servidor en infraestructura alojada.
- ✅ Más de 20 integraciones documentadas listas para usar: Claude, ChatGPT, Cursor, Codex, Gemini CLI, GitHub Copilot, n8n, CrewAI, los SDK de Agentes de Claude y OpenAI, Excel / Word / PowerPoint vía Claude, y cualquier otro cliente compatible con MCP.
- ✅ Resolución a nivel de SKU: profundiza en ASIN individuales, listados principales, marketplaces, períodos de tiempo, campañas de anuncios, informes de palabras clave, liquidaciones, devoluciones.
- ✅ Multi-marketplace, multi-cuenta: un solo servidor MCP cubre todos los marketplaces de Amazon (EE. UU., Reino Unido, Alemania, Francia, Italia, España, Canadá, Australia, Japón, México y más) tanto en Seller Central como en Vendor Central.
- ✅ Diseñado para IA de forma nativa:
exports_createacepta grupos de filtros similares a SQL, GROUP BY, agregaciones e intervalos de fechas, para que tu agente de IA pueda crear informes complejos con una sola llamada de herramienta. - ✅ Lectura y escritura: con Acciones, tu agente no solo informa, sino que actualiza listados, gestiona pedidos y optimiza Amazon Ads, con un paso de validación
dryRuny controles por tipo. - ✅ Infraestructura alojada siempre activa: DataDoe gestiona los límites de tasa de SP-API, la rotación de tokens y el mantenimiento continuo.
¿Qué puedes preguntar a DataDoe MCP?
Ejemplos de preguntas que tu agente de IA puede responder con DataDoe MCP conectado:
- "¿Cuáles fueron mis 20 ASIN principales por ingresos el mes pasado en todos los marketplaces de Amazon?"
- "Concilia mis liquidaciones de Amazon con los pedidos del primer trimestre y muestra cualquier discrepancia."
- "¿Qué campañas de Amazon Ads tuvieron un ACoS superior al 40% la semana pasada y cuál fue su gasto total?"
- "Muestra las unidades de inventario en riesgo de quedarse sin stock en los próximos 14 días."
- "Crea un panel de KPI diario con ventas, tráfico y gasto en anuncios de los últimos 90 días."
- "¿Qué términos de búsqueda en mis informes de PPC generaron más clics pero cero conversiones?"
- "Trae todas las devoluciones de Amazon para el SKU ABC-123 en los últimos 60 días y resume los motivos de devolución."
- "Compara mi participación de voz por término de búsqueda en análisis de marca mes a mes."
Y con Acciones habilitadas, tu agente puede actuar sobre lo que encuentra:
- "Aumenta el presupuesto diario de mi campaña de Sponsored Products con mejor ACoS en un 20%."
- "Pausa todas las campañas con ACoS superior al 50% la semana pasada."
- "Actualiza el precio del SKU ABC-123 a 19.99 y actualiza sus viñetas."
- "Confirma el envío del pedido 123-4567890-1234567 con el seguimiento de UPS 1Z999..."
Acciones: escribir en Amazon
Las Acciones permiten que tu agente de IA realice cambios en tus cuentas conectadas de Amazon Seller Central, Vendor Central y Amazon Ads a través de SP-API y Amazon Ads API. Cada Acción se registra y es auditable.
Lo que tu agente puede hacer:
- Listados: actualizar el título, viñetas, descripción, precio, palabra clave genérica y palabra clave de tipo de artículo (
AMAZON_LISTINGS_UPDATE). - Pedidos: cancelar un artículo de pedido con un motivo (
AMAZON_ORDERS_CANCEL) o confirmar el envío y cargar el seguimiento (AMAZON_ORDERS_CONFIRM_SHIPMENT). - Amazon Ads: agregar, actualizar, eliminar y encontrar campañas, grupos de anuncios, targets, anuncios y asociaciones de anuncios en Sponsored Products, Brands, Display, TV y Amazon DSP.
Cómo funciona: el agente ejecuta cada Acción a través de estas herramientas MCP:
actions_details_schema_get: obtén el esquema de payload para el tipo de Acción.actions_startcondryRun=true: valida el payload sin ejecutarlo.actions_start: ejecuta la Acción y obtén un id de acción.actions_get: consulta hasta que se complete y luego lee elresult.
Usa actions_list para revisar Acciones pasadas (filtra por estado, tipo, creador y fecha).
Los tipos de Acción están deshabilitados por defecto y se habilitan por tipo en Configuración > Acciones. Cuando un tipo está deshabilitado, actions_start rechaza ejecuciones en vivo pero aún permite la validación dryRun.
Ejemplo de payload details para AMAZON_LISTINGS_UPDATE:
{
"type": "AMAZON_LISTINGS_UPDATE",
"sellerOrVendorId": "<SELLER_OR_VENDOR_UUID>",
"dryRun": true,
"details": {
"changes": [
{
"sku": "ABC-123",
"language_tag": "en_US",
"name": "Stainless Steel Water Bottle 750ml",
"price": 19.99
}
]
}
}
Ejecutar una Acción cuesta 2 tokens de IA por hasta 100 entidades, más 1 token por cada 100 adicionales. Consulta la documentación de Acciones para el catálogo completo y los esquemas de payload.
Herramientas MCP disponibles
DataDoe MCP expone las siguientes herramientas a tu cliente de IA:
| Herramienta | Categoría | Qué hace |
|---|---|---|
sellers_and_vendors_list | Cuenta | Lista los vendedores y proveedores de Amazon conectados a tu organización de DataDoe, con paginación y filtros opcionales por nombre y código de país del marketplace. |
organization_and_subscription_details_get | Cuenta | Devuelve el perfil de tu organización de DataDoe y el plan de suscripción activo. |
exports_sources_get | Datos | Busca en el catálogo de DataDoe de plantillas de exportación de datos de Amazon preconstruidas (pedidos, ventas y tráfico, rendimiento de anuncios, inventario, listados, liquidaciones, devoluciones, análisis de marca y más). |
exports_create | Datos | Crea una exportación de datos de Amazon desde cualquier fuente. Admite filtros similares a SQL, GROUP BY, agregaciones (sum / avg / count / countDistinct / min / max), intervalos de fechas (DAY / WEEK / MONTH), paginación y salida en CSV o JSON. |
exports_get | Datos | Devuelve el estado y los metadatos de un trabajo de exportación en curso o completado. |
exports_raw_url_get | Datos | Devuelve una URL de descarga única servida por el servidor MCP de DataDoe para una exportación completada. |
exports_raw_download | Datos | Devuelve el contenido bruto de la exportación (CSV o JSON) en línea en la respuesta de la herramienta. |
exports_delete | Datos | Elimina una exportación por su ID. |
files_create | Archivos | Crea y sube un archivo de utilidad (imágenes de listado o A+) como contenido codificado en base64. |
files_list | Archivos | Lista los archivos de utilidad de la organización con paginación y filtros. |
files_get | Archivos | Devuelve metadatos de un archivo de utilidad por id. |
files_download_url_get | Archivos | Devuelve una URL de descarga única para un archivo subido. |
files_delete | Archivos | Elimina un archivo de utilidad y su objeto almacenado cuando esté presente. |
datadoe_user_docs_table_of_contents_get | Docs | Devuelve la tabla de contenidos de la documentación de usuario de DataDoe, útil cuando un agente necesita buscar funciones o capacidades bajo demanda. |
datadoe_user_docs_page_get | Docs | Devuelve el contenido completo de una página de documentación de DataDoe con nombre. |
actions_details_schema_get | Acciones | Devuelve el Esquema JSON del payload details requerido para iniciar un tipo de Acción determinado. |
actions_start | Acciones | Inicia una Acción que cambia tu cuenta de Amazon (listados, pedidos, Amazon Ads). Establece dryRun=true para validar sin ejecutar. Devuelve un id de acción. |
actions_get | Acciones | Devuelve el estado y el result de una Acción por id; consulta después de actions_start. |
actions_list | Acciones | Devuelve el historial de Acciones paginado, filtrable por estado, tipo, creador y fecha. |
extensions_get | Extensiones | Devuelve todos los Memories y Skills agregados por el usuario. |
extensions_memories_create | Extensiones | Crea un Memory para el usuario u organización. |
extensions_memories_edit | Extensiones | Actualiza un Memory para el usuario u organización. |
Configuración rápida por cliente de IA
Los fragmentos a continuación son la configuración mínima que necesitas. Para guías paso a paso por cliente de IA, consulta la lista de Guías de configuración por cliente al final de esta sección.
Claude Desktop · Claude.ai
{
"mcpServers": {
"datadoe": {
"url": "https://mcp.datadoe.com/mcp/v1",
"headers": {
"datadoe-mcp-key": "<YOUR_DATADOE_MCP_KEY>"
}
}
}
}
Claude Code
claude mcp add datadoe \
--transport http \
--url https://mcp.datadoe.com/mcp/v1 \
--header "datadoe-mcp-key: <YOUR_DATADOE_MCP_KEY>"
Cursor
Agrega a ~/.cursor/mcp.json (global) o .cursor/mcp.json (por proyecto):
{
"mcpServers": {
"datadoe": {
"url": "https://mcp.datadoe.com/mcp/v1",
"headers": {
"datadoe-mcp-key": "<YOUR_DATADOE_MCP_KEY>"
}
}
}
}
GitHub Copilot (VS Code)
Agrega a tu mcp.json de VS Code:
{
"mcpServers": {
"datadoe": {
"url": "https://mcp.datadoe.com/mcp/v1",
"headers": {
"datadoe-mcp-key": "<YOUR_DATADOE_MCP_KEY>"
}
}
}
}
Codex CLI · Gemini CLI · ChatGPT · n8n · NanoClaw · cualquier otro cliente MCP
DataDoe MCP funciona como un servidor MCP remoto genérico. Configura tu cliente con:
- URL:
https://mcp.datadoe.com/mcp/v1 - Transporte: HTTP Streamable
- Cabecera de autenticación:
datadoe-mcp-key: <YOUR_DATADOE_MCP_KEY>(crea una clave en Integraciones MCP de DataDoe)
Guías de configuración por cliente
Para guías de configuración paso a paso por cliente de IA, consulta las páginas dedicadas de documentación de DataDoe:
- Usando Claude
- Usando ChatGPT
- Usando Claude Code
- Usando Claude Agent SDK
- Usando Codex
- Usando Codex Sites
- Usando CrewAI
- Usando Cursor
- Usando Excel + Claude
- Usando Gemini CLI
- Usando Gumloop
- Usando Hermes Agent
- Usando n8n
- Usando NanoClaw
- Usando OpenAI Agents SDK
- Usando OpenClaw
- Usando OpenCode
- Usando PowerPoint + Claude
- Usando VS Code
- Usando Word + Claude
Raíz de documentación completa: www.datadoe.com/hub/docs
¿Qué datos de Amazon están disponibles?
DataDoe MCP expone todas las tablas de datos de Amazon disponibles en DataDoe, incluyendo:
- Pedidos y ventas: líneas de pedido, rendimiento de pedidos, ventas y tráfico, reembolsos
- Amazon Ads: campañas, grupos de anuncios, palabras clave, términos de búsqueda, productos / marcas / display patrocinados, métricas de ACoS / ROAS / cuota de impresiones
- Inventario: inventario FBA, recomendaciones de reposición, inventario varado, antigüedad, unidades en riesgo
- Listados y catálogo: catálogo de ASIN, atributos de producto, propiedad de la Buy Box, variaciones
- Finanzas: liquidaciones, tarifas, reservas, reembolsos, depósitos
- Devoluciones: devoluciones de clientes, motivos de devolución, devoluciones FBA
- Analítica de marca: rendimiento de consultas de búsqueda, cesta de mercado, compra repetida, datos demográficos
- Tráfico: sesiones, visitas a páginas, tasa de conversión, por ASIN, por marketplace
Esquema completo: www.datadoe.com/hub/data-scheme
Lo que DataDoe MCP NO es
Para evitar confusiones al evaluar servidores MCP de Amazon:
- ❌ No es un servidor MCP autoalojado. DataDoe MCP está alojado en
mcp.datadoe.com. Este repositorio de GitHub es la fachada de esquema utilizada para publicar DataDoe MCP en registros MCP públicos (Official MCP Registry, mcpservers.org, glama.ai, mcpmarket.com, Cline, smithery.ai y otros). - ❌ No es un envoltorio de SP-API que operes tú mismo. DataDoe posee el registro de desarrollador de SP-API, el flujo OAuth, la rotación de tokens de actualización, los endpoints de marketplace y el manejo de límites de tasa. Tú aportas tu cuenta de Amazon; nosotros nos encargamos del resto.
- ❌ No es un servidor gratuito de código abierto. DataDoe MCP requiere una suscripción a DataDoe. Para una alternativa gratuita autoalojada, consulta los servidores MCP de Amazon de la comunidad indexados en mcpservers.org.
Documentación y recursos
- Página principal de DataDoe
- Documentación de DataDoe
- DataDoe Actions (escribir en Amazon)
- Referencia del esquema de datos de Amazon
- Página del producto DataDoe MCP
- Comparación entre DataDoe y Amazon MCP
- Demo en video de DataDoe MCP
- Blog de DataDoe: explicaciones de Amazon SP-API, Ads API y MCP
- Crear una clave API de DataDoe MCP
Licencia
MIT. La fachada de esquema de DataDoe MCP en este repositorio es de código abierto. El servidor MCP alojado, la aplicación DataDoe y la infraestructura de DataDoe son propietarios y están operados por Deltologic.
Cómo iniciar y conectar localmente (para indexación y listado)
Este servidor es solo una fachada de esquema del servidor real de DataDoe MCP, creado para exponer DataDoe MCP a varios registros MCP. Es un servidor no-op: no hace nada más que exponer el esquema de DataDoe MCP. Si quieres usar realmente DataDoe MCP, consulta la documentación de DataDoe MCP.
1. Instalar dependencias
yarn install
2. Compilar el servidor local
yarn build
Esto compila el código fuente de TypeScript en dist/index.js.
3. Iniciar el servidor
yarn start
El servidor se comunica a través de stdio, por lo que el proceso está diseñado para ser lanzado por tu cliente MCP en lugar de abrirse en un navegador.
4. Conectar desde un cliente MCP
Para una configuración local, apunta tu cliente al punto de entrada compilado. Un mcp.json típico se ve así:
{
"mcpServers": {
"datadoe": {
"command": "node",
"args": ["/absolute/path/to/datadoe-mcp/dist/index.js"]
}
}
}
Si tu cliente admite rutas de espacio de trabajo basadas en variables de entorno, normalmente puedes intercambiar la ruta absoluta por la ubicación real del clon en tu máquina.
DataDoe es operado por Deltologic · datadoe.com