# Como instalar o LUCA super tema

Essa primeira versão do LUCA necessita que, para ser instalado na loja do seu cliente, seja criado um app personalizado dentro da loja do seu cliente. Isso permitirá criar o tema, instalar componentes e automações necessárias para a montagem da loja.

Não se preocupe, o LUCA não tem acesso a dados sensíveis da sua agência ou do seu cliente, somente o necessário para construir a loja.

## Passo 1: Criar uma Loja no LUCA Admin[​](https://luca-copilot.github.io/doc-public/docs/primeiros-passos/como-instalar-o-luca#passo-1-criar-uma-loja-no-luca-admin)

1. **Criar uma loja no LUCA Admin:**
   * Clique em **Adicionar uma loja**.
   * Preencha os campos para identificação da loja e, ao concluir, clique em **Continuar**.
   * Dar permissões é basicamente instalar o LUCA na loja do seu cliente. Para isso, é necessário criar um app personalizado na loja do seu cliente.

![](https://luca-copilot.github.io/doc-public/assets/images/passo-1-criar-af32ead617a7cf61f5e113f7ba5bfd47.png)

## Passo 2: Criar um App Personalizado[​](https://luca-copilot.github.io/doc-public/docs/primeiros-passos/como-instalar-o-luca#passo-2-criar-um-app-personalizado)

1. **Acesse a loja no Shopify:**
   * Vá em **Configurações > Apps e canais de vendas**.
   * Clique em **Desenvolver apps**.

![](https://t9013067422.p.clickup-attachments.com/t9013067422/95b5d0d7-e091-43cd-988f-2ace97ad1261/image.png)

1. **Permitir o desenvolvimento de apps personalizados:**
   * Clique em **Permitir o desenvolvimento de apps personalizados**.
   * Clique novamente em **Permitir o desenvolvimento de apps personalizados**.

![](https://t9013067422.p.clickup-attachments.com/t9013067422/ab08cd47-1745-496e-93a4-c94b54856b10/image.png)

1. **Criar um App:**
   * Clique em **Criar um App**.
   * Nomeie o app como **LUCA App**, ou com outro nome desejado. Porém o nome precisa começar o com termo "**LUCA**".
   * Conclua clicando em **Criar app**.

![](https://t9013067422.p.clickup-attachments.com/t9013067422/37e9caa9-ef91-496a-a1ac-df8453b75600/image.png)

{% hint style="warning" %}
**Atenção**

Se o nome do app não começar com o termo "**LUCA**", pode interferir nas funções dele. Portanto nomeie sempre como "**LUCA \[o nome que desejar]**".
{% endhint %}

## Passo 3: Configurar o App[​](https://luca-copilot.github.io/doc-public/docs/primeiros-passos/como-instalar-o-luca#passo-3-configurar-o-app)

1. **Configurar escopos da API Admin:**
   * Clique em **Configurar escopos da API Admin**.
   * Adicione todas as permissões abaixo, seguindo as etapas de exemplo:
   * Products: `write_products`, `read_products`
   * Content: `write_content`, `read_content`
   * Themes: `write_themes`, `read_themes`
   * Metaobject: `write_metaobject_definitions`, `read_metaobject_definitions`, `write_metaobjects`, `read_metaobjects`
   * Customers: `write_customers`, `read_customers`

![](https://t9013067422.p.clickup-attachments.com/t9013067422/c7ff2d02-fc56-4208-abc4-78e867d5548b/image.png)

{% hint style="info" %}
**Dica**

Sugerimos utilizar a barra de busca para digitar os tópicos e encontrar as opções com mais agilidade.
{% endhint %}

## Passo 4: Instalar o App[​](https://luca-copilot.github.io/doc-public/docs/primeiros-passos/como-instalar-o-luca#passo-4-instalar-o-app)

1. **Instalar o App:**
   * Após salvar, clique em **Instalar app**.
   * Em seguida, clique em **Instalar**.
2. **Revelar o token necessário:**
   * Clique em **Revelar token uma vez**.
   * Copie o token.

![](https://t9013067422.p.clickup-attachments.com/t9013067422/3438af7e-a66c-40cf-9ec8-78d1c186416e/image.png)

1. **Conectar o LUCA à loja do seu cliente:**
   * Volte ao **LUCA Admin** e cole o código no campo **Token de acesso da API Admin**.
   * Por fim, clique em **Continuar** para seguir com o passo a passo da criação da loja.

![](https://t9013067422.p.clickup-attachments.com/t9013067422/1aff8305-20a5-48c4-8c98-0b9ed7d2102c/image.png)

## Conclusão[​](https://luca-copilot.github.io/doc-public/docs/primeiros-passos/como-instalar-o-luca#conclus%C3%A3o)

Pronto, após terminar o passo a passo da criação da loja, você já pode instalar os temas, componentes e automações necessárias para criar o seu projeto com o LUCA 🕺

Se tiver dúvidas ou sugestões, estamos à disposição no Discord ou por e-mail. Estamos aqui para ajudar!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.luca.global/boas-vindas/luca-tema/primeiros-passos/como-instalar-o-luca-super-tema.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.