A1 Yandex KIT MCP

Servidor MCP A1 Yandex KIT para a API de e-commerce Yandex KIT: produtos, pedidos, descontos, webhooks.

Documentação

Atribua tarefas da loja Yandex KIT ao assistente

Yandex KIT Skills ^β

Verifique o que exige atenção, organize o catálogo, processe os pedidos e inicie uma promoção com uma frase comum. O assistente lê o estado atual da loja, executa alterações somente sob comando exato e mostra o resultado verificado.

Verifica. Pedidos, catálogo, promoções, webhooks e prontidão da loja para abertura.
Executa. Atualiza preços e estoques definidos, inicia promoções, trabalha com arquivos e documentos.
Mostra o resultado. Informa o que mudou, o que foi totalmente verificado e onde faltaram dados.

Sua primeira solicitação

O que exige atenção agora na loja? Verifique pedidos e catálogo e indique quais dados foram possíveis de verificar.

Conectar loja · Ver o que mais pode ser atribuído · Assinar o canal no Telegram

Assistente de IA para Yandex KIT

Yandex KIT Skills ^β permite gerenciar a loja a partir do aplicativo habitual (Claude, Cursor, Codex e outros). Você define tarefas em palavras comuns, e o assistente verifica o estado atual da loja, encontra o que exige atenção e executa comandos.

Quatro cenários prontos. Riscos operacionais e prioridades, erros de catálogo, início de promoções e prontidão da loja para abertura.
Por voz ou texto. Formule tarefas de trabalho em linguagem natural. Escreva ou dite, se o aplicativo suportar entrada por voz. Se desejar, é possível chamar a habilidade necessária diretamente.
Alterações somente sob comando. As verificações não alteram nada, e o assistente não inventa preços, estoques, prazos ou outros valores de negócio.

O que o assistente já sabe fazer

Operador (a1-yandex-kit-operator) realiza a análise operacional da loja: encontra tudo que pode causar perda de pedido, dinheiro ou reputação, classifica os riscos por urgência e forma um plano de ação preciso.
Doutor do catálogo (a1-yandex-kit-catalog-doctor) encontra erros que fazem os produtos perderem visibilidade e vendas e, sob comando do proprietário, corrige-os.
Início de promoção (a1-yandex-kit-promo-launcher) transforma as condições definidas em uma promoção pronta: cria, altera e ativa descontos, cupons e brindes na loja.
Verificação de lançamento (a1-yandex-kit-launch-check) determina se a loja está pronta para abrir e receber pedidos: encontra bloqueios e lista tudo que ainda precisa ser confirmado.
Habilidades especializadas. a1-yandex-kit-orders, a1-yandex-kit-catalog, a1-yandex-kit-promotions, a1-yandex-kit-store e a1-yandex-kit-webhooks — para tarefas específicas de pedidos, catálogo, promoções, recursos da loja e webhooks.
Não encontrou o cenário desejado? Conte qual tarefa está faltando e acompanhe as novas possibilidades.

Veja o funcionamento em um minuto

Após a conexão:

Você: O que exige atenção agora na loja?

Assistente: Verifiquei os pedidos disponíveis, catálogo, promoções e webhooks. Mostrei os riscos encontrados e destaquei separadamente as áreas que não foi possível verificar completamente.

Você: Exporte os pedidos em CSV com data, valor e status.

Assistente: Preparei a exportação e indiquei sua abrangência. Se a lista não foi obtida por completo, isso está destacado no resultado.

Você: Aumente os preços de todos os produtos em 20%.

Assistente: Os preços de todos os 12 produtos foram aumentados de R$ 999 para R$ 1.199. Os preços base e final foram atualizados e verificados.

Você: [anexa sete arquivos PDF]

Aqui estão instruções, fichas técnicas e certificados. Os nomes dos arquivos não são claros. Analise a quais produtos cada documento corresponde e anexe-os, por favor.

Assistente: Analisei o conteúdo dos sete documentos e os relacionei ao catálogo pelos nomes dos modelos e SKUs:

«Cadeira Urban Relax» — instrução de montagem e ficha técnica;

«Nordic Comfort Lounge Chair» — instrução de montagem e especificação de materiais;

«Black Force», «Pink Dream» e «Champion Spirit» — declaração de conformidade para cada perfume.

Todas as correspondências são inequívocas. Anexei 7 de 7 documentos, dei nomes claros a eles e verifiquei a lista de documentos de cada produto. Não há arquivos não reconhecidos.

Início rápido

Abra o terminal e instale o pacote de habilidades:
```
npx skills@latest add ztemerbekov/a1-yandex-kit-skills -y
```
Para receber atualizações recentes depois, execute npx skills update.
Chame explicitamente o instalador pela habilidade a1-yandex-kit-setup. No Codex, a chamada fica assim:
```
$a1-yandex-kit-setup
```
Em outro aplicativo, selecione a habilidade com esse nome na lista de comandos.
Siga as perguntas do instalador. Ele verificará o ambiente e o token, conectará a loja ao aplicativo escolhido e fará a primeira chamada.
Após a mensagem de conexão bem-sucedida, os cenários de trabalho podem ser chamados com frases comuns — por voz ou texto. Comece com uma pergunta simples:

Como está a loja?

O instalador funciona com Claude Code, Claude Desktop, Cursor, OpenAI Codex e outros aplicativos. O pacote também pode ser instalado pelo marketplace do aplicativo. Se a conexão não for concluída, abra a instrução detalhada: lá há a lista completa de plataformas, configuração manual e formas de resolver erros.

Mais sobre os cenários

Escolha uma tarefa conhecida e envie a solicitação ao assistente. As formulações podem ser alteradas: insira seus produtos, pedidos, datas e condições. Para verificação, basta descrever o que interessa; para alteração, indique o valor desejado ou anexe um arquivo do qual ele possa ser extraído.

Entender o que exige atenção na loja

Começa o dia de trabalho, acumularam-se pedidos ou é preciso entender rapidamente o estado da loja. O Operador (a1-yandex-kit-operator) verificará os dados disponíveis e classificará os riscos encontrados por urgência.

O que você pode escrever:

Como está a loja? Por onde começo hoje?

Não olhei a loja por três dias. Analise os pedidos desse período e mostre o que exige atenção.

Antes do fim de semana, verifique pedidos, catálogo e promoções ativas. Quais questões precisam ser resolvidas primeiro?

O que você receberá: análise de pedidos, estado do catálogo, promoções e webhooks com fatos da loja. O assistente indicará separadamente o que não foi possível verificar.

Organizar fichas, preços e estoques

Chegou uma remessa, mudou a tabela de preços ou acumularam-se erros no catálogo. O Doutor do catálogo (a1-yandex-kit-catalog-doctor) ajudará a verificar os produtos e aplicar as alterações definidas.

O que você pode escrever:

Faça uma auditoria completa do catálogo. Primeiro mostre os erros que impedem a compra do produto.

Encontre produtos sem fotos e verifique onde as características não foram preenchidas.

Aumente os preços de todos os produtos em 20%.

Defina o estoque do cropped Summer Breeze: 13 unidades.

Anexo um arquivo com os novos estoques. Relacione os produtos por SKU e atualize os estoques conforme o arquivo. Mostre as linhas sem correspondência inequívoca.

O que você receberá: lista de erros com indicação dos produtos ou resultado verificado das alterações. Para a auditoria, o assistente dividirá bloqueios, riscos e recomendações, indicará a abrangência e as áreas não verificadas. Preços e estoques serão extraídos do seu comando ou arquivo.

Processar pedidos, obter link de pagamento e documentos para envio

É preciso verificar o pagamento, preparar um relatório ou repassar as remessas ao serviço de entrega. Essas tarefas estão disponíveis por meio de a1-yandex-kit-orders.

O que você pode escrever:

Mostre os pedidos de hoje e seus status de pagamento. Oculte nomes, telefones e endereços.

Exporte os pedidos da semana passada em CSV: data, valor e status.

Dê o link de pagamento para o pedido 123.

Gere os termos de recebimento e transferência para todas as partes do pedido 123. Se para alguma parte o termo não estiver disponível, explique o motivo.

O que você receberá: lista de pedidos, CSV, link de pagamento ou links para PDF com os termos — conforme a solicitação. Se a exportação estiver incompleta, o assistente indicará sua abrangência; se o termo não estiver disponível, listará as partes do pedido omitidas com os motivos.

O link de pagamento é entregue a você pelo assistente; o envio ao comprador é feito por você. Ele é permanente e irrevogável, portanto não o publique em acesso aberto. Os links para PDF com os termos, ao contrário, expiram: se o link parar de funcionar, solicite o termo novamente.

Adicionar fotos, vídeos e documentos aos produtos

O fornecedor enviou materiais, e eles precisam ser distribuídos nas fichas. As habilidades a1-yandex-kit-catalog e a1-yandex-kit-store ajudam a trabalhar com mídias e arquivos da loja.

O que você pode escrever:

Anexo sete arquivos PDF: instruções, fichas técnicas e certificados. Analise a quais produtos eles correspondem e anexe os documentos às fichas.

Mostre os arquivos carregados, incluindo documentos, com links para eles.

Mostre a lista de vídeos carregados e seus status de processamento.

Adicione esta foto ao produto SKU-42. Mantenha as demais fotografias na ficha.

O que você receberá: lista de arquivos ou resultado da anexação de materiais com verificação das fichas. Se não for possível determinar inequivocamente o produto pelo documento, o assistente esclarecerá a correspondência. Os vídeos são armazenados separadamente e não entram na lista geral de arquivos — você pode solicitá-los com uma frase separada.

Iniciar uma promoção ou alterar um cupom ativo

As condições da promoção já estão definidas; falta transferi-las para a loja. O Início de promoção (a1-yandex-kit-promo-launcher) cria e altera descontos, cupons e brindes sob seu comando.

O que você pode escrever:

Quais promoções estão ativas agora? Mostre prazos, produtos e condições de cada uma.

Crie o cupom SMPT10 «Setembro 10»: desconto de 10% em todos os produtos de 1 a 30 de setembro de 2026, horário de Moscou, sem limite de usos. Ative imediatamente.

Estenda o cupom SMPT10 até 7 de outubro de 2026, 23h59, horário de Moscou. Mantenha as demais condições.

Desative o cupom SMPT10 e verifique se ele não está mais ativo.

O que você receberá: visão geral das promoções ativas ou uma promoção configurada com verificação das condições finais e do status. Se faltarem o valor do desconto, produtos, prazo ou outra condição obrigatória para o início, o assistente esclarecerá.

Obter catálogo para publicidade e CRM

Um profissional de publicidade ou integrador pede o link do feed de produtos — o arquivo do qual o serviço obtém o catálogo. A habilidade a1-yandex-kit-store encontrará o link para a plataforma necessária.

O que você pode escrever:

Preciso do link do catálogo para o Yandex Direct. Dê o feed YML da loja.

Estou integrando o RetailCRM. Mostre o link do feed ICML.

Dê o feed para o Yandex Products e indique qual é o formato.

O que você receberá: link permanente para o feed necessário: YML para Yandex Direct, ICML para RetailCRM ou YML_GOODS para Yandex Products. O endereço é mantido ao atualizar o conteúdo. O link precisa ser adicionado ao serviço correspondente; a obtenção do feed por si só não inicia publicidade nem configura CRM.

Encontrar dados do cliente ou preparar uma exportação

É necessário o histórico de pedidos de um cliente específico, uma lista para relatório ou uma edição na ficha. Essas tarefas estão disponíveis por meio de a1-yandex-kit-orders.

O que você pode escrever:

Mostre os pedidos do cliente com este ID, ocultando os dados pessoais dele.

Exporte os clientes em CSV: ID, nome e e-mail.

Na ficha do cliente com este ID, substitua a observação por «Prefere retirada no local». Mantenha os demais campos. O que você receberá: os dados solicitados, uma exportação indicando a cobertura ou uma alteração verificada no cadastro. A ocultação de dados pessoais afeta apenas a resposta do assistente — as informações na loja são mantidas.

Verificar notificações para integrações

O sistema externo recebe eventos da loja por meio de webhooks. A habilidade a1-yandex-kit-webhooks ajuda a visualizar as assinaturas, verificar o endereço de recebimento ou desativar um webhook específico.

O que você pode escrever:

Mostre os webhooks da loja: para onde enviam notificações, a quais eventos estão assinados e qual é o status deles.

Execute a verificação do webhook com este ID e mostre o resultado. Não o ative.

Desative o webhook com este ID. O webhook em si deve ser mantido.

O que você receberá: a lista de configurações, o resultado da verificação ou a desativação confirmada. A verificação envia uma solicitação de teste para o endereço do webhook; o assistente a executa sob seu comando.

Verificar a loja antes da abertura

O catálogo está preenchido e você está prestes a receber os primeiros pedidos. A verificação de inicialização (a1-yandex-kit-launch-check) ajuda a encontrar o que ainda impede a abertura.

O que você pode escrever:

Verifique se a loja está pronta para abrir. O que impede o início do recebimento de pedidos?

Amanhã vamos lançar a loja. Verifique o catálogo e as promoções e liste as etapas de compra não verificadas em uma lista separada.

O que devo verificar manualmente em pagamento e entrega antes da abertura?

O que você receberá: o status "não pronta", "condicionalmente pronta" ou "pronta" com bloqueios, riscos e trechos não verificados. O assistente verificará o catálogo e as promoções, considerará as confirmações da verificação do checkout e, se o aplicativo tiver acesso web, visualizará a vitrine pública. O checkout e o pagamento de um pedido de teste são verificados pelo proprietário; apenas os dados da API não são suficientes para o status "pronta".

Como o assistente interage com a loja

A verificação não altera nada. Se você pedir "mostre", "verifique", "analise" ou "encontre", o assistente apenas verificará a loja e mostrará o resultado.

Para alterações, é necessário um comando preciso. Indique o que deve ser alterado e qual valor deve ser definido. Por exemplo: "Aumente os preços de todos os produtos em 20%". O assistente não inventará preço, estoque, prazo ou outra decisão por conta própria.

Não é necessária confirmação repetida. Um comando preciso já é considerado autorização para a ação.

Essa regra se aplica ao assistente. O próprio aplicativo de IA pode exibir separadamente o botão Allow antes de chamar a ferramenta. Ao conectar, você pode ativar uma vez o "Trabalho sem interrupções": o aplicativo de IA permitirá todas as ferramentas atuais e futuras do Yandex KIT, incluindo exclusões, pedidos, promoções e configurações da loja. As próprias habilidades continuam alterando a loja apenas sob seu comando preciso.

O resultado é verificado. Antes da alteração, o assistente verificará o estado atual do objeto, executará o comando e, em seguida, verificará o que foi feito.

Operação incerta não é repetida. Se a conexão cair durante uma alteração e o resultado não puder ser confirmado, o assistente informará isso, mas não repetirá o comando às cegas.

Não há cancelamento automático. O assistente não salva uma cópia do estado da loja antes de cada alteração; portanto, não é possível reverter tudo com um único comando "como estava".

Atenção

Todas as alterações ocorrem na loja em produção. Não há loja de teste separada nem modo de teste.

O assistente não monitora a loja constantemente. Ele verifica o estado da loja e executa ações somente quando você define uma tarefa.

Nem todas as ações estão disponíveis com pedidos. O assistente pode visualizar, confirmar e cancelar pedidos. Para retirada e entrega própria com automação desativada, ele pode concluir a entrega; status arbitrários de entrega e status de pagamento não estão disponíveis. Ele não pode criar pedidos, alterar livremente o conteúdo do pedido, processar devoluções ou escrever para os clientes.

A prontidão para abertura não é verificada totalmente de forma automática. O assistente não vê as configurações de pagamento e entrega e não pode concluir e pagar um pedido de teste por conta própria. Essa parte da verificação é feita pelo proprietário da loja.

Após erro de conexão, o comando não é repetido automaticamente. Primeiro, o assistente tentará verificar se a alteração foi executada. Se não for possível confirmar o resultado, ele informará e parará, para não executar a ação duas vezes acidentalmente.

A cobertura da lista é visível na resposta. O assistente indicará quantos objetos foram verificados e marcará objetos ou trechos não verificados separadamente. Se os dados forem insuficientes, ele não chamará o resultado de completo. Para listas grandes, pode ser necessário várias consultas à loja.

Listas de pedidos e clientes podem ser exportadas em CSV. Peça para exportar a lista com os campos selecionados, por exemplo: "Exporte os pedidos em CSV com data, valor e status". Se a lista não for obtida por completo, o assistente informará.

Dados pessoais podem ser ocultados na resposta. Peça para mostrar pedidos, clientes ou cartões-presente sem nomes, telefones, emails, endereços e observações. Isso altera apenas a resposta exibida — os dados da loja são mantidos como estão.

Servidor MCP (Model Context Protocol)

Este repositório contém um servidor MCP funcional para a API Yandex KIT — não apenas habilidades e plugins para clientes de IA.

Implementação. O servidor é escrito em TypeScript com o pacote oficial @modelcontextprotocol/sdk, criado via McpServer e conectado ao cliente de IA via StdioServerTransport.
Recursos MCP. O servidor fornece 92 ferramentas (tools) para trabalhar com produtos, variantes (incluindo atualização em massa de preços), categorias, características, vídeos, notícias, pedidos, clientes e seus carrinhos, depósitos, coleções, arquivos, descontos, códigos promocionais, cartões-presente, alertas e webhooks. Recursos (resources) e prompts (prompts) não são declarados: as operações da API são fornecidas como ferramentas MCP.
Cobertura completa da API. Ferramentas especializadas complementam search_operations, get_operation_schema e kit_request, por meio das quais todas as 169 operações da API Yandex KIT estão disponíveis.
Transporte. O servidor MCP local funciona via stdio.
Publicação. O servidor está disponível como pacote npm mcp-yandex-kit e é executado via npx no Node.js 20.11 ou superior.
Habilidades. As habilidades deste repositório adicionam cenários de trabalho prontos e regras de execução segura de operações sobre as ferramentas MCP, mas não substituem o próprio servidor MCP.

Código-fonte: packages/mcp/src/index.ts · packages/mcp/src/tools · lista de ferramentas · README do pacote MCP.

Abaixo é mostrada a conexão direta do próprio servidor MCP. Ela adiciona ferramentas MCP para trabalhar com a API Yandex KIT, mas não instala as habilidades prontas deste repositório.

Codex — conectar o servidor MCP

Adicione o servidor com o comando:

codex mcp add yandex-kit \
  --env YANDEX_KIT_TOKEN=ваш_токен \
  -- npx -y mcp-yandex-kit@latest

Inicie uma nova tarefa no Codex.
Verifique a conexão com uma solicitação simples:

Verifique se a loja foi conectada. Mostre quantos produtos há no catálogo e diga no que vale a pena prestar atenção primeiro.

Cursor — conectar o servidor MCP

Abra ~/.cursor/mcp.json e adicione o servidor:

{
  "mcpServers": {
    "yandex-kit": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-kit"],
      "env": {
        "YANDEX_KIT_TOKEN": "ваш_токен"
      }
    }
  }
}

Recarregue a janela do Cursor.
Verifique a conexão com uma solicitação simples:

Verifique se a loja foi conectada. Mostre quantos produtos há no catálogo e diga no que vale a pena prestar atenção primeiro.

Claude Code — conectar o servidor MCP

Adicione o servidor com o comando:

claude mcp add yandex-kit \
  -e YANDEX_KIT_TOKEN=ваш_токен \
  -- npx -y mcp-yandex-kit@latest

Inicie uma nova sessão no Claude Code.
Verifique a conexão com uma solicitação simples:

Verifique se a loja foi conectada. Mostre quantos produtos há no catálogo e diga no que vale a pena prestar atenção primeiro.

Instalação por meio de marketplaces

Escolha o aplicativo de IA no qual deseja gerenciar a loja. Cada opção instala o conjunto completo: conexão com Yandex KIT, habilidades de API e quatro cenários prontos.

Se o método de instalação não for importante, use o início rápido — basta um comando.

Codex — instalar via Marketplace

Adicione o marketplace e instale o conjunto completo:

codex plugin marketplace add ztemerbekov/a1-yandex-kit-skills
codex plugin add a1-yandex-kit-skills@a1-yandex-kit-skills

Inicie uma nova tarefa no Codex para carregar as habilidades instaladas.

Conecte a loja:

$a1-yandex-kit-skills:a1-yandex-kit-setup

Siga as perguntas do instalador — ele verificará o ambiente, conectará a loja e executará a primeira chamada.

Cursor — instalar via Marketplace

Adicione o marketplace:

cursor-agent plugin marketplace add https://github.com/ztemerbekov/a1-yandex-kit-skills

Execute o Cursor Agent, abra /plugin e selecione o marketplace A1 Yandex KIT.
Instale o plugin A1 Yandex KIT e, em seguida, selecione a habilidade a1-yandex-kit-setup e siga as perguntas de conexão.

Claude Code — instalar via Marketplace

Adicione o marketplace e instale o conjunto completo:

/plugin marketplace add ztemerbekov/a1-yandex-kit-skills
/plugin install a1-yandex-kit-skills@a1-yandex-kit-skills

Carregue as habilidades instaladas:
```
/reload-plugins
```

Conecte a loja:

/a1-yandex-kit-skills:a1-yandex-kit-setup

Siga as perguntas do instalador — ele verificará o ambiente, conectará a loja e executará a primeira chamada.

Atualização

Atualize o pacote da mesma forma que o instalou.

Se você usou o início rápido, obtenha a versão mais recente das habilidades com um comando:

npx skills update

Se você instalou o pacote por meio do marketplace, atualize o plugin A1 Yandex KIT no mesmo aplicativo de IA. Após a atualização, inicie uma nova tarefa para que o aplicativo carregue a versão mais recente das habilidades.

Documentação

Como instalar e conectar a loja — configuração passo a passo, aplicativos compatíveis e ajuda se a conexão não funcionar.
Como funciona o Yandex KIT Skills — a que o assistente se conecta, quais ações estão disponíveis e quais são as limitações.
Documentação da API Yandex KIT — referência oficial da Yandex para desenvolvedores.

Ajuda e feedback

Precisa de ajuda, algo não funciona ou tem uma ideia? Escreva para nós no Telegram — Yandex KIT Skills ^β.

Две Моны дают пять

Você chegou ao final!