Plugin Tray API para Claude Code
Plugin completo para integração com as APIs da Tray. Acelera o desenvolvimento de aplicativos e-commerce por parceiros e comunidade na plataforma Tray, fornecendo documentação detalhada de 150+ endpoints, fluxos de autenticação OAuth, webhooks e boas práticas de integração.
Pré-requisitos
- Claude Code instalado
- Credenciais de API Tray (Consumer Key e Consumer Secret) — obtidas em developers.tray.com.br
Instalação
# Via marketplace próprio
/plugin marketplace add tray-tecnologia/tray-api-claude-plugin
/plugin install tray-api@tray-plugins
# Desenvolvimento local (clone o repositório)
git clone https://github.com/tray-tecnologia/tray-api-claude-plugin.git
claude --plugin-dir ./tray-api-claude-plugin
Componentes
| Componente | Quantidade | Descrição |
|---|---|---|
| Skills | 34 | Documentação completa de cada recurso da API Tray |
| Agentes | 10 | Fluxos especializados (setup, catálogo, pedidos, debug, migração + 5 especialistas por plataforma) |
| Comandos | 3 | Atalhos rápidos (setup, referência, validação) |
| Hooks | 2 | Validação automática de segurança |
Skills Disponíveis
Base
autorizacao, webhooks, produtos, variacoes, imagens-produtos, categorias, pedidos, clientes, informacoes-loja
Complementar
caracteristicas, marcas, kits, status-pedido, enderecos-cliente, perfis-cliente, frete, configuracao-frete, multicd, notas-fiscais, pagamentos
Avançado
cupons, carrinho-compras, listagem-carrinho, informacoes-adicionais, listas-preco-b2b, emissores-etiqueta, etiquetas-mercado-livre, etiquetas-hub, scripts-externos, newsletter, parceiros, palavras-chave, produtos-vendidos, usuarios
Agentes
| Agente | Descrição |
|---|---|
/tray-api:configuracao-aplicativo | Guia de setup inicial e configuração OAuth |
/tray-api:gestor-catalogo | Gestão em massa de catálogo (produtos, categorias, variações) |
/tray-api:gestor-pedidos | Ciclo completo de pedidos (criação, status, fulfillment) |
/tray-api:debug-integracao | Diagnóstico de problemas e erros de API |
/tray-api:assistente-migracao | Migração de outras plataformas (Shopify, WooCommerce, Magento, VTEX, Nuvemshop) |
Comandos
| Comando | Descrição |
|---|---|
/tray-api:setup | Configuração rápida de integração |
/tray-api:referencia-api | Referência completa de endpoints |
/tray-api:validar-integracao | Checklist de validação pré-publicação |
Exemplo de Uso
# 1. Adicione o marketplace
❯ /plugin marketplace add tray-tecnologia/tray-api-claude-plugin
⎿ Successfully added marketplace: tray-plugins
# 2. Instale o plugin
❯ /plugin install tray-api@tray-plugins
⎿ ✓ Installed tray-api. Run /reload-plugins to activate.
# 3. Ative o plugin
❯ /reload-plugins
⎿ Reloaded: 1 plugins · 34 skills · 5 agents · 2 hooks · 1 plugin MCP server · 0 plugin LSP servers
# Veja todas as skills disponíveis
❯ Quais skills disponíveis?
⏺ Aqui estão as skills disponíveis:
Tray API - Setup & Auth:
- /tray-api:setup — Guia rápido de configuração inicial
- /tray-api:autorizacao — Fluxo OAuth 2.0, tokens, refresh
- /tray-api:validar-integracao — Valida código de integração
- /tray-api:referencia-api — Referência rápida de endpoints
- /tray-api:webhooks — Notificações em tempo real
Tray API - Catálogo:
- /tray-api:produtos — CRUD de produtos
- /tray-api:variacoes — Variações/SKUs
- /tray-api:categorias — Árvore de categorias
- /tray-api:marcas — Marcas/fabricantes
- /tray-api:imagens-produtos — Upload de imagens
- /tray-api:caracteristicas — Propriedades de produtos
- /tray-api:informacoes-adicionais — Campos customizados
- /tray-api:kits — Kits/combos de produtos
Tray API - Pedidos & Frete:
- /tray-api:pedidos — Ciclo completo de pedidos
- /tray-api:status-pedido — Status personalizados
- /tray-api:notas-fiscais — NF-e
- /tray-api:frete — Cálculo de frete
- /tray-api:configuracao-frete — Métodos de envio
- /tray-api:carrinho-compras — Carrinho de compras
- /tray-api:listagem-carrinho — Listagem de carrinhos
- /tray-api:etiquetas-hub — Etiquetas HUB
- /tray-api:etiquetas-mercado-livre — Etiquetas ML
- /tray-api:emissores-etiqueta — Emissores de etiqueta