> ## 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.

# introdução ao MCP

> conecte assistentes de IA como o Claude direto à sua operação B2B na teceo — catálogo, pedidos, clientes e relatórios

# MCP da teceo

o MCP (Model Context Protocol) da teceo conecta assistentes de IA, como o Claude, direto à sua operação na plataforma. em vez de navegar por telas, você conversa em linguagem natural — "quais pedidos do cliente X estão em rascunho?", "quanto vendi na coleção alto verão?", "abre um pedido pra loja Y" — e o assistente executa a ação na teceo por você.

<Warning>
  o MCP da teceo está em **beta**. as ferramentas disponíveis e o seu comportamento podem mudar ao longo da evolução do produto.
</Warning>

<Info>
  o **Model Context Protocol** é um padrão aberto que permite a assistentes de IA acessarem sistemas externos de forma segura. o servidor MCP da teceo expõe a sua operação como **ferramentas (tools)** que o Claude pode usar durante uma conversa, sempre no escopo de uma marca ou loja que você seleciona.
</Info>

## o que você pode fazer

<CardGroup cols={2}>
  <Card title="catálogo e produtos" icon="shirt">
    busque produtos por nome, coleção, categoria ou disponibilidade, com preço, cores, grade de tamanhos e fotos.
  </Card>

  <Card title="pedidos" icon="receipt">
    crie, edite, acompanhe e altere o status de pedidos — do rascunho à finalização.
  </Card>

  <Card title="clientes" icon="users">
    consulte clientes, endereços de entrega e representantes vinculados.
  </Card>

  <Card title="relatórios" icon="chart-line">
    consulte vendas (sell-in) e faturamento agregados, por período, produto, cliente, representante ou coleção.
  </Card>

  <Card title="metas de compra" icon="bullseye">
    planeje metas de compra por categoria e marca, apoiado no histórico de vendas e estoque (sell-out).
  </Card>
</CardGroup>

## para quem é

o MCP atende tanto os times de negócio da marca quanto os lojistas — o que cada perfil faz depende do contexto selecionado (marca ou loja):

* **administradores** e **representantes comerciais** (contexto de marca): catálogo, clientes, pedidos, relatórios e metas.
* **lojistas** (contexto de loja): acompanhamento de pedidos e planejamento de compra — metas de compra e consulta de vendas e estoque (sell-out).

o acesso respeita as mesmas permissões da sua conta na plataforma: você só enxerga e opera o que já poderia pela interface.

## como funciona o contexto

toda operação no MCP acontece no escopo de um **contexto** — uma marca ou uma loja específica. antes de qualquer consulta ou ação, você seleciona em qual contexto quer trabalhar. isso garante que os dados e ações fiquem sempre isolados no ambiente certo.

<Steps>
  <Step title="veja seus contextos">
    o assistente lista as marcas e lojas às quais você tem acesso.
  </Step>

  <Step title="selecione um">
    você escolhe a marca ou loja em que quer operar.
  </Step>

  <Step title="opere normalmente">
    a partir daí, todas as ferramentas passam a agir naquele contexto até você trocar.
  </Step>
</Steps>

## clientes compatíveis

o MCP da teceo funciona com qualquer cliente compatível com o protocolo, incluindo:

* **Claude.ai** (web e apps de desktop)
* **Claude Desktop**
* **Claude Code** (CLI)

## próximos passos

<CardGroup cols={2}>
  <Card title="conectar" icon="plug" href="/integracoes/mcp/conexao">
    passo a passo para conectar o MCP ao seu cliente de IA.
  </Card>

  <Card title="ferramentas" icon="wrench" href="/integracoes/mcp/ferramentas">
    referência completa das ferramentas disponíveis.
  </Card>

  <Card title="exemplos" icon="comments" href="/integracoes/mcp/exemplos">
    conversas reais de ponta a ponta para se inspirar.
  </Card>
</CardGroup>