DataDoe

Servidor MCP hospedado para vendedores e fornecedores da Amazon. Conecte Claude, ChatGPT, Cursor, Codex, Gemini, GitHub Copilot a dados ao vivo das APIs SP-API e Ads da Amazon.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP de Vendedor Amazon - DataDoe

Servidor MCP hospedado do Amazon Seller Central e Vendor Central com acesso de leitura e escrita. Conecte Claude, ChatGPT, Cursor, Codex, Gemini e GitHub Copilot aos dados ao vivo da Amazon SP-API e da Amazon Ads API e deixe seu agente de IA agir sobre eles: atualize anúncios, gerencie pedidos e otimize campanhas de Amazon Ads. A DataDoe cuida da aprovação de desenvolvedor da SP-API, OAuth e limites de taxa para que seu agente de IA comece a trabalhar em menos de um minuto.

🔗 Inicie um teste gratuito · 📘 Documentação · ⚡ Ações · 📊 Esquema de dados da Amazon · 🎥 Demonstração em vídeo

🚀 Início rápido

Cadastre-se na DataDoe e conecte sua conta do Amazon Seller Central ou Vendor Central.
Crie uma chave de API MCP da DataDoe em Integrações MCP da DataDoe.

Cole a configuração abaixo no seu cliente de IA (Claude, Cursor, Codex, Gemini, GitHub Copilot, ChatGPT ou qualquer ferramenta compatível com MCP):

{
  "mcpServers": {
    "datadoe": {
      "url": "https://mcp.datadoe.com/mcp/v1",
      "headers": {
        "datadoe-mcp-key": "<YOUR_DATADOE_MCP_KEY>"
      }
    }
  }
}

Pergunte ao seu agente de IA: "Mostre meus 10 principais ASINs por receita no mês passado em todos os marketplaces da Amazon."

É isso. A DataDoe executa o servidor MCP em infraestrutura hospedada, então sua equipe não precisa implantar nada localmente nem esperar pela aprovação de desenvolvedor da Amazon SP-API.

O que é o DataDoe MCP?

DataDoe MCP é um servidor hospedado do Model Context Protocol (MCP) para vendedores, fornecedores e agências da Amazon. Ele expõe seus dados ao vivo da Amazon Selling Partner API (SP-API) e da Amazon Ads API por meio de ferramentas MCP que funcionam com Claude, ChatGPT, Cursor, Codex CLI, Gemini CLI, GitHub Copilot, Claude Desktop, n8n, NanoClaw e qualquer outro cliente compatível com MCP.

O DataDoe MCP oferece ao seu agente de IA duas camadas sobre sua conta da Amazon:

Uma camada de leitura - pedidos em nível de SKU, vendas, gastos com anúncios, tráfego, inventário, anúncios, devoluções, liquidações, análise de marca e catálogo, retornados como respostas estruturadas de ferramentas ou exportações CSV e JSON para download.
Uma camada de escrita (Ações) - seu agente pode alterar sua conta da Amazon por meio da SP-API e da Amazon Ads API: atualizar anúncios, cancelar pedidos, confirmar remessas e gerenciar campanhas de Amazon Ads, grupos de anúncios, alvos e anúncios.

Criar sua própria integração com a Amazon SP-API normalmente exige registro de desenvolvedor na SP-API, fluxo de token de atualização OAuth, endpoints específicos por marketplace, lógica de limitação de taxa e 2 a 4 semanas de aprovação da Amazon. A DataDoe cuida de tudo isso. Você obtém uma única URL MCP autenticada para ler e agir sobre seus dados da Amazon.

Para quem é o DataDoe MCP?

Vendedores da Amazon (FBA, FBM, multi-marketplace) - obtenha respostas instantâneas dos seus próprios dados de vendedor sem alternar para o Seller Central.
Agências da Amazon que gerenciam várias contas de clientes - consulte todas as contas conectadas do Seller Central / Vendor Central a partir de um único servidor MCP.
Fornecedores com Vendor Central - leia dados 1P junto com dados 3P com as mesmas ferramentas.
Criadores e desenvolvedores de IA - lance agentes de IA, painéis e ferramentas internas com conhecimento da Amazon sem escrever sua própria integração com a SP-API.
Equipes de operações - automatize relatórios recorrentes via Claude Code, Cursor, n8n ou qualquer ferramenta de fluxo de trabalho compatível com MCP.

Por que usar o DataDoe MCP?

✅ Nenhuma aprovação da SP-API necessária - A DataDoe cuida do registro de desenvolvedor da SP-API, OAuth, tokens de atualização e limites de taxa em seu nome.
✅ Configuração em 30 segundos - cole a URL MCP e sua chave de API na configuração do seu cliente de IA. A DataDoe executa o servidor em infraestrutura hospedada.
✅ Mais de 20 integrações documentadas prontas para uso: Claude, ChatGPT, Cursor, Codex, Gemini CLI, GitHub Copilot, n8n, CrewAI, os SDKs de Agentes da Claude e OpenAI, Excel / Word / PowerPoint via Claude e qualquer outro cliente compatível com MCP.
✅ Resolução em nível de SKU - aprofunde-se em ASINs individuais, anúncios pai, marketplaces, períodos de tempo, campanhas de anúncios, relatórios de palavras-chave, liquidações, devoluções.
✅ Multi-marketplace, multi-conta - um único servidor MCP cobre todos os marketplaces da Amazon (EUA, Reino Unido, Alemanha, França, Itália, Espanha, Canadá, Austrália, Japão, México e mais) no Seller Central e no Vendor Central.
✅ Nativo de IA por design - exports_create aceita grupos de filtros no estilo SQL, GROUP BY, agregações e intervalos de datas, para que seu agente de IA possa criar relatórios complexos com uma única chamada de ferramenta.
✅ Leitura e escrita - com Ações, seu agente não apenas relata, mas atualiza anúncios, gerencia pedidos e otimiza Amazon Ads, com uma etapa de validação dryRun e controles por tipo.
✅ Infraestrutura hospedada sempre ativa - A DataDoe gerencia limites de taxa da SP-API, rotação de tokens e manutenção contínua.

O que você pode perguntar ao DataDoe MCP?

Exemplos de perguntas que seu agente de IA pode responder com o DataDoe MCP conectado:

"Quais foram meus 20 principais ASINs por receita no mês passado em todos os marketplaces da Amazon?"
"Concilie minhas liquidações da Amazon com os pedidos do 1º trimestre e mostre quaisquer discrepâncias."
"Quais campanhas de Amazon Ads tiveram ACoS acima de 40% na semana passada e qual foi o gasto total?"
"Mostre unidades de inventário em risco de falta de estoque nos próximos 14 dias."
"Crie um painel de KPIs diários com vendas, tráfego e gastos com anúncios dos últimos 90 dias."
"Quais termos de pesquisa em meus relatórios de PPC geraram mais cliques, mas zero conversões?"
"Puxe todas as devoluções da Amazon para o SKU ABC-123 nos últimos 60 dias e resuma os motivos das devoluções."
"Compare a participação de voz dos termos de pesquisa da minha análise de marca mês a mês."

E com Ações habilitadas, seu agente pode agir sobre o que encontrar:

"Aumente o orçamento diário da minha campanha de Sponsored Products com maior ACoS em 20%."
"Pause todas as campanhas com ACoS acima de 50% na semana passada."
"Atualize o preço do SKU ABC-123 para 19,99 e atualize seus bullet points."
"Confirme o envio do pedido 123-4567890-1234567 com o rastreamento UPS 1Z999..."

Ações: escrever na Amazon

As Ações permitem que seu agente de IA faça alterações nas suas contas conectadas do Amazon Seller Central, Vendor Central e Amazon Ads por meio da SP-API e da Amazon Ads API. Cada Ação é registrada e auditável.

O que seu agente pode fazer:

Anúncios - atualize o título, bullet points, descrição, preço, palavra-chave genérica e palavra-chave de tipo de item (AMAZON_LISTINGS_UPDATE).
Pedidos - cancele um item de pedido com um motivo (AMAZON_ORDERS_CANCEL) ou confirme o envio e envie o rastreamento (AMAZON_ORDERS_CONFIRM_SHIPMENT).
Amazon Ads - adicione, atualize, remova e encontre campanhas, grupos de anúncios, alvos, anúncios e associações de anúncios em Sponsored Products, Brands, Display, TV e Amazon DSP.

Como funciona - o agente executa cada Ação por meio destas ferramentas MCP:

actions_details_schema_get - obtenha o esquema do payload para o tipo de Ação.
actions_start com dryRun=true - valide o payload sem executar.
actions_start - execute a Ação e obtenha um id de ação.
actions_get - faça polling até concluir e leia o result.

Use actions_list para revisar Ações passadas (filtre por status, tipo, criador e data).

Os tipos de Ação ficam desabilitados por padrão e são habilitados por tipo em Configurações > Ações. Quando um tipo está desabilitado, actions_start rejeita execuções ao vivo, mas ainda permite a validação dryRun.

Exemplo 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
      }
    ]
  }
}

Executar uma Ação custa 2 tokens de IA para até 100 entidades, mais 1 token por 100 adicionais. Consulte a documentação de Ações para o catálogo completo e esquemas de payload.

Ferramentas MCP disponíveis

O DataDoe MCP expõe as seguintes ferramentas ao seu cliente de IA:

Ferramenta	Categoria	O que faz
`sellers_and_vendors_list`	Conta	Lista vendedores e fornecedores da Amazon conectados à sua organização DataDoe, com paginação e filtros opcionais por nome e código de país do marketplace.
`organization_and_subscription_details_get`	Conta	Retorna o perfil da sua organização DataDoe e o plano de assinatura ativo.
`exports_sources_get`	Dados	Pesquisa o catálogo da DataDoe de modelos de exportação de dados da Amazon pré-construídos (pedidos, vendas e tráfego, desempenho de anúncios, inventário, anúncios, liquidações, devoluções, análise de marca e mais).
`exports_create`	Dados	Cria uma exportação de dados da Amazon de qualquer fonte. Suporta filtros no estilo SQL, GROUP BY, agregações (soma / média / contagem / contagemDistinta / mínimo / máximo), intervalos de datas (DIA / SEMANA / MÊS), paginação e saída em CSV ou JSON.
`exports_get`	Dados	Retorna status e metadados para um trabalho de exportação em andamento ou concluído.
`exports_raw_url_get`	Dados	Retorna uma URL de download única servida pelo servidor MCP da DataDoe para uma exportação concluída.
`exports_raw_download`	Dados	Retorna o conteúdo bruto da exportação (CSV ou JSON) inline na resposta da ferramenta.
`exports_delete`	Dados	Exclui uma exportação pelo seu ID.
`files_create`	Arquivos	Cria e envia um arquivo utilitário (imagens de anúncio ou A+) como conteúdo codificado em base64.
`files_list`	Arquivos	Lista arquivos utilitários da organização com paginação e filtros.
`files_get`	Arquivos	Retorna metadados de um arquivo utilitário por id.
`files_download_url_get`	Arquivos	Retorna uma URL de download única para um arquivo enviado.
`files_delete`	Arquivos	Exclui um arquivo utilitário e seu objeto armazenado quando presente.
`datadoe_user_docs_table_of_contents_get`	Documentação	Retorna o sumário da documentação do usuário da DataDoe, útil quando um agente precisa consultar recursos ou capacidades sob demanda.
`datadoe_user_docs_page_get`	Documentação	Retorna o conteúdo completo de uma página de documentação da DataDoe.
`actions_details_schema_get`	Ações	Retorna o JSON Schema do payload `details` necessário para iniciar um determinado tipo de Ação.
`actions_start`	Ações	Inicia uma Ação que altera sua conta da Amazon (anúncios, pedidos, Amazon Ads). Defina `dryRun=true` para validar sem executar. Retorna um id de ação.
`actions_get`	Ações	Retorna o status e o `result` de uma Ação por id; faça polling após `actions_start`.
`actions_list`	Ações	Retorna o histórico de Ações paginado, filtrável por status, tipo, criador e data.
`extensions_get`	Extensões	Retorna todas as Memórias e Habilidades adicionadas pelo usuário.
`extensions_memories_create`	Extensões	Cria uma Memória para o usuário ou organização.
`extensions_memories_edit`	Extensões	Atualiza uma Memória para o usuário ou organização.

Configuração rápida por cliente de IA

Os trechos abaixo são a configuração mínima necessária. Para guias passo a passo por cliente de IA, consulte a lista de Guias de configuração por cliente no final desta seção.

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

Adicione a ~/.cursor/mcp.json (global) ou .cursor/mcp.json (por projeto):

{
  "mcpServers": {
    "datadoe": {
      "url": "https://mcp.datadoe.com/mcp/v1",
      "headers": {
        "datadoe-mcp-key": "<YOUR_DATADOE_MCP_KEY>"
      }
    }
  }
}

GitHub Copilot (VS Code)

Adicione ao seu mcp.json do 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 · qualquer outro cliente MCP

O DataDoe MCP funciona como um servidor MCP remoto genérico. Configure seu cliente com:

URL: https://mcp.datadoe.com/mcp/v1
Transporte: HTTP Streamable
Cabeçalho de autenticação: datadoe-mcp-key: <YOUR_DATADOE_MCP_KEY> (crie uma chave em Integrações MCP da DataDoe)

Guias de configuração por cliente

Para guias de configuração passo a passo por cliente de IA, consulte as páginas dedicadas da documentação da DataDoe:

Raiz da documentação completa: www.datadoe.com/hub/docs

Quais dados da Amazon estão disponíveis?

O MCP do DataDoe expõe todas as tabelas de dados da Amazon disponíveis no DataDoe, incluindo:

Pedidos e vendas: itens de linha de pedido, desempenho de pedidos, vendas e tráfego, reembolsos
Amazon Ads: campanhas, grupos de anúncios, palavras-chave, termos de pesquisa, produtos / marcas / display patrocinados, métricas de ACoS / ROAS / participação de impressões
Inventário: inventário FBA, recomendações de reabastecimento, inventário encalhado, idade, unidades em risco
Listagens e catálogo: catálogo de ASINs, atributos do produto, propriedade da Buy Box, variações
Finanças: liquidações, taxas, reservas, reembolsos, depósitos
Devoluções: devoluções de clientes, motivos de devolução, devoluções FBA
Análises da marca: desempenho de consultas de pesquisa, cesta de compras, compra repetida, dados demográficos
Tráfego: sessões, visualizações de página, taxa de conversão, por ASIN, por marketplace

Esquema completo: www.datadoe.com/hub/data-scheme

O que o MCP do DataDoe NÃO é

Para evitar confusão ao avaliar servidores Amazon MCP:

❌ Não é um servidor MCP auto-hospedado. O MCP do DataDoe está hospedado em mcp.datadoe.com. Este repositório GitHub é a fachada de esquema usada para publicar o MCP do DataDoe em registros públicos de MCP (Official MCP Registry, mcpservers.org, glama.ai, mcpmarket.com, Cline, smithery.ai e outros).
❌ Não é um wrapper SP-API que você opera. DataDoe detém o registro de desenvolvedor SP-API, fluxo OAuth, rotação de refresh-token, endpoints de marketplace e tratamento de limites de taxa. Você traz sua conta Amazon; nós cuidamos do resto.
❌ Não é um servidor open-source gratuito. O MCP do DataDoe requer uma assinatura do DataDoe. Para uma alternativa gratuita auto-hospedada, veja os servidores da comunidade Amazon MCP indexados em mcpservers.org.

Documentação e recursos

Licença

MIT. A fachada de esquema do MCP do DataDoe neste repositório é open-source. O servidor MCP hospedado, o aplicativo DataDoe e a infraestrutura DataDoe são proprietários e operados pela Deltologic.

Como iniciar e conectar localmente (para indexação e listagem)

Este servidor é apenas uma fachada de esquema do servidor MCP real do DataDoe, feito para expor o MCP do DataDoe a vários registros de MCP. É um servidor no-op: não faz nada além de expor o esquema do MCP do DataDoe. Se você quiser realmente usar o MCP do DataDoe, veja a documentação do MCP do DataDoe.

1. Instalar dependências

yarn install

2. Compilar o servidor local

yarn build

Isso compila o código-fonte TypeScript em dist/index.js.

3. Iniciar o servidor

yarn start

O servidor se comunica via stdio, então o processo é destinado a ser iniciado pelo seu cliente MCP em vez de aberto no navegador.

4. Conectar a partir de um cliente MCP

Para uma configuração local, aponte seu cliente para o ponto de entrada compilado. Um típico mcp.json se parece com isto:

{
  "mcpServers": {
    "datadoe": {
      "command": "node",
      "args": ["/absolute/path/to/datadoe-mcp/dist/index.js"]
    }
  }
}

Se o seu cliente suportar caminhos de workspace baseados em ambiente, você geralmente pode trocar o caminho absoluto pela localização real do clone na sua máquina.

O DataDoe é operado por Deltologic · datadoe.com