# mcplace

**Um endpoint. Todo o seu e-commerce.** O mcplace é um hub de conectores MCP
para marketplaces brasileiros: conecte sua conta do **Mercado Livre** (Shopee,
Amazon e TikTok Shop em breve) ao Claude, ChatGPT, n8n ou ao seu próprio
agente de IA — e opere + analise suas vendas em linguagem natural.

## Por onde começar

1. [O que é MCP?](/o-que-e-mcp) — explicação para quem nunca ouviu falar.
2. [Início rápido](/quickstart) — do cadastro ao agente funcionando em 5 minutos.
3. [Referência de tools](/referencia) — o que cada ferramenta faz, em todos os marketplaces conectados.
4. [Consulta genérica (`query`)](/conectores/mercado-livre/query) — filtros e agregações sob medida.
5. [Receitas](/conectores/mercado-livre/receitas) — perguntas prontas e o que conferir na resposta.

Quando algo não sair como esperado: [Erros e limites](/erros-e-limites),
[Segurança e controle](/seguranca) e [Solução de problemas](/solucao-de-problemas).

Para agentes: toda página existe em Markdown puro trocando o final da URL por
`.md`, e o índice fica em [`/llms.txt`](/llms.txt).

## O diferencial

O mcplace **não devolve JSON cru**. Pergunte “qual meu faturamento de pedidos
pagos nos últimos 7 dias?” e o servidor computa e devolve **um número** — em 1
chamada, sem estourar o contexto do seu agente:

```json
{ "totals": { "gmv": 48212.90, "count": 312, "units": 471 }, "currency": "BRL" }
```

## Segurança

- Tokens do Mercado Livre em cofre criptografado (nunca expostos ao agente).
- Escritas granulares com auditoria; modo somente-leitura e confirmação
  obrigatória por conector.
- Guardas de sanidade: variação de preço acima de ±50% e estoque negativo são
  rejeitados no servidor.