> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teceo.co/llms.txt
> Use this file to discover all available pages before exploring further.

# conexão

> conecte o MCP da teceo ao Claude.ai, Claude Desktop ou Claude Code e autentique com sua conta

# conectar o MCP

conectar o MCP da teceo ao seu cliente de IA leva poucos passos. a autenticação é feita com a **mesma conta que você usa na plataforma teceo**, via OAuth — não é preciso gerar tokens nem chaves manualmente.

## pré-requisitos

* uma conta ativa na teceo, com acesso a pelo menos uma marca ou loja.
* um cliente compatível com MCP (Claude.ai, Claude Desktop ou Claude Code).

## URL do servidor

use esta URL ao adicionar o conector no seu cliente:

```
https://api.app.teceo.co/mcp
```

<Info>
  em breve o MCP da teceo estará disponível direto no **diretório de conectores do Claude** — bastará buscar por "teceo" e clicar em conectar. até lá, use a URL acima para adicionar como conector personalizado.
</Info>

## adicionar o conector

<Tabs>
  <Tab title="Claude.ai / Claude Desktop">
    <Steps>
      <Step title="abra os conectores">
        vá em **configurações → conectores** e escolha **adicionar conector personalizado**.
      </Step>

      <Step title="informe a URL">
        cole a URL do servidor:

        ```
        https://api.app.teceo.co/mcp
        ```
      </Step>

      <Step title="conecte">
        confirme. o Claude abre a tela de login da teceo automaticamente.
      </Step>
    </Steps>

    <Note>
      conectores personalizados estão disponíveis nos planos pagos do Claude. o nome exato do menu pode variar conforme a versão do cliente.
    </Note>
  </Tab>

  <Tab title="Claude Code">
    adicione o servidor pelo terminal:

    ```bash theme={null}
    claude mcp add --transport http teceo https://api.app.teceo.co/mcp
    ```

    ou versione um arquivo `.mcp.json` na raiz do projeto:

    ```json .mcp.json theme={null}
    {
      "mcpServers": {
        "teceo": {
          "type": "http",
          "url": "https://api.app.teceo.co/mcp"
        }
      }
    }
    ```

    na primeira vez, rode `/mcp` dentro do Claude Code para iniciar o login da teceo.
  </Tab>
</Tabs>

## autenticar

<Steps>
  <Step title="entre na teceo">
    na tela de login que o Claude abre, entre com o mesmo e-mail e senha que você usa na plataforma teceo.
  </Step>

  <Step title="autorize o acesso">
    revise as permissões e confirme. o Claude e a teceo trocam as credenciais por você via OAuth — nenhum token fica exposto na conversa.
  </Step>

  <Step title="pronto">
    o conector aparece como conectado. as ferramentas da teceo já estão disponíveis na conversa.
  </Step>
</Steps>

<Check>
  para confirmar que deu certo, peça ao assistente: **"quais contextos eu tenho acesso na teceo?"**. ele deve listar suas marcas e lojas.
</Check>

## primeiro uso: selecionar um contexto

antes de qualquer consulta ou ação, selecione a marca ou loja em que quer trabalhar. basta pedir em linguagem natural:

> "seleciona a marca **minha marca** na teceo"

o assistente confirma o contexto ativo e, a partir daí, todas as ferramentas operam nele. veja os detalhes em [ferramentas de contexto](/integracoes/mcp/ferramentas#contexto).

## solução de problemas

<AccordionGroup>
  <Accordion title="o Claude não abre a tela de login">
    confirme que a URL está exatamente `https://api.app.teceo.co/mcp` e que seu plano do Claude suporta conectores personalizados. remova e adicione o conector novamente se o problema persistir.
  </Accordion>

  <Accordion title="'nenhum contexto selecionado'">
    é o comportamento esperado antes da primeira seleção. peça ao assistente para listar os contextos e escolha uma marca ou loja para continuar.
  </Accordion>

  <Accordion title="não vejo uma marca ou loja esperada">
    o MCP respeita as permissões da sua conta na teceo. se um contexto não aparece, verifique com o administrador da marca se o seu usuário tem acesso a ele na plataforma.
  </Accordion>
</AccordionGroup>