Orkas Orkas
Início Blog Conectar o Etsy ao Claude
Ferramentas

Conectar o Etsy ao Claude: o que cada caminho pode e não pode fazer

O Claude não tem entrada para Etsy em seu diretório de conectores e a Etsy não lançou um servidor MCP. Todo caminho é de terceiros — e todos se dividem por uma coisa que decide se a conexão serve para algo.

A resposta para “dá para conectar o Etsy ao Claude” é sim, e há quatro caminhos. Eles não são intercambiáveis. Diferem em poder escrever e em onde suas credenciais do Etsy acabam. Depois, todos param na mesma porta, que os guias de configuração costumam resolver em uma frase.

Em resumo Não existe caminho oficial para o Etsy O diretório de conectores do Claude não tem entrada para Etsy, e a Etsy não publicou um servidor MCP próprio. Tudo o que você instala hoje é de terceiros.
Baixar o Orkas — grátis

Os quatro caminhos

O diretório de conectores do Claude. Não há o que conectar. O Etsy não está lá e não publicou um servidor MCP próprio, então isso ainda não é um caminho.

Um servidor MCP da comunidade. Existem vários no GitHub, sobre a Open API v3 do Etsy. Você roda o servidor na sua máquina, registra no cliente e fornece as credenciais.

Um MCP hospedado ou plataforma de integração. Ficam entre o Claude e o Etsy, e a configuração é a mais curta das quatro. Vêm com duas coisas: suas credenciais ficam na infraestrutura deles, e vários são somente leitura por design.

Um cliente desktop com o conector embutido. O Orkas tem esse formato. Ele chama https://openapi.etsy.com/v3/application direto da sua máquina, sem servidor MCP para rodar e sem nada no meio.

A porta em que todos param

A Open API v3 do Etsy não é aberta no sentido de “pegue uma chave e comece”. Ler ou escrever na sua própria loja exige um app aprovado para Seller API Access. Vendedores individuais podem solicitar em Etsy Developers → Your Apps; não é preciso ter empresa.

Você sai com três valores, e um deles custa uma tarde:

Keystring e Shared Secret vêm da página de detalhes do app. Shop ID é o identificador numérico, não o nome da loja — e a URL pública da sua loja traz o nome, não o ID. O jeito documentado de resolver isso é o endpoint findShops, que busca por nome e devolve shop_id no resultado. Essa chamada precisa ser autenticada com o Keystring e o Shared Secret que você acabou de receber, então a ordem importa: primeiro o app, depois as credenciais, e então busque o ID da sua própria loja com elas.

Um passo é mais fácil do que parece. A Etsy pede que você registre um endereço de callback para o app, o que soa como precisar de um servidor. Não precisa — você registra o endereço que o seu cliente usa. O Orkas usa https://orkas.ai/api/connectors/oauth/dcr-callback; cole no campo Redirect URI e o passo acabou.

Não vamos publicar um prazo de aprovação. A Etsy não se compromete com um, e os números citados em fóruns são relatos, não um cronograma. Trate como uma etapa, não uma formalidade, e comece antes de avaliar clientes. A documentação oficial de autenticação da Etsy é o que vale ler na espera.

Antes de comparar clientes Comece pelo pedido de Seller API Access Todo caminho precisa dele, então o pedido é o gargalo. Nada do que você escolher depois muda isso.
Baixar o Orkas — grátis

Ler não é escrever

Com credenciais em mãos, os caminhos deixam de ser equivalentes. Perguntar quantos pedidos entraram na semana passada é leitura. Mudar um preço, renovar um anúncio, atualizar estoque ou trocar um perfil de frete é escrita, e exige os escopos correspondentes.

É a distinção que a maioria dos textos sobre “conectar Etsy ao Claude” pula. Um conector hospedado que responde perguntas em linguagem natural sobre os dados da loja é genuinamente útil e genuinamente somente leitura; peça para corrigir doze anúncios e nada acontece. Verifique o lado da escrita antes de escolher, porque o esforço de aprovação na frente é idêntico nos dois casos.

O conector do Orkas cobre loja, anúncios, estoque, envio de pedidos, perfis de frete e seções da loja — os dois lados. As credenciais ficam criptografadas no seu próprio dispositivo, e não em um arquivo de configuração ou em servidores de terceiros, e tudo que escreve em uma loja ativa passa por um pedido de permissão no cliente, em vez de confiar que o modelo será cuidadoso.

Quando não usar isto

Quatro casos em que outra coisa é a resposta melhor. Você só quer perguntar: um conector hospedado dá menos trabalho e não há nada para instalar. Você quer rodando sozinho, agendado: o Orkas é um app desktop, fechar a janela para tudo; uma tarefa agendada em servidor é o formato certo. Você quer que o Etsy dispare workflows em dezenas de outros serviços: plataformas de integração existem para isso, e isto não. Você quer alterar títulos, preços ou tags em massa: a própria ferramenta de edição em massa do Shop Manager já faz isso, sem nenhum pedido de API. Não instale nada para esse caso.

O que o caminho desktop substitui não são as ferramentas da própria Etsy. É a pilha de pequenos serviços que você colocaria entre sua loja e um modelo, cada um com uma cópia das suas credenciais. O mesmo catálogo cobre eBay, Walmart Marketplace, Amazon Seller Central, Shopify, WooCommerce e as plataformas chinesas, para que essa pilha não reapareça uma vez por loja.