# Início rápido

Do cadastro ao agente funcionando. Pré-requisito: uma conta de vendedor no
Mercado Livre (você precisa ser o administrador da conta).

## 1. Crie sua conta e conecte o Mercado Livre

1. Acesse [app.mcplace.com.br](https://app.mcplace.com.br) → **Criar conta
   grátis** (sem cartão).
2. No painel, clique **Conectar Mercado Livre** e autorize no login oficial.
3. Abra **Seu agente** no painel: ali está a **sua URL MCP**, uma por espaço de
   trabalho. Ela é sua, não de uma loja — alcança todas as contas que você
   conectar.

O plano Grátis dá 50 chamadas por dia durante 7 dias, contados da primeira
chamada de tool. Veja [Cota do plano Grátis](/erros-e-limites#free-quota).

## 2. Cole a URL no seu cliente

> **Atenção:** **A URL é uma senha.** Ela sozinha dá acesso às suas contas conectadas. Não cole em chat público, issue, print ou repositório. Se ela vazar, gire a URL em **Seu agente** — a antiga para de funcionar na hora. Veja [Se a URL vazar](/seguranca#rotate-url).

Escolha o seu cliente:

- [Claude Desktop](/quickstart/claude-desktop) — conector personalizado
- [Claude Code](/quickstart/claude-code) — linha de comando
- [ChatGPT](/quickstart/chatgpt) — conector no modo desenvolvedor
- [Cursor](/quickstart/cursor) — arquivo de configuração
- [n8n](/quickstart/n8n) — node MCP Client
- [Qualquer outro cliente](/quickstart/universal) — prompt universal

## 3. Teste

Pergunte ao agente:

> qual meu faturamento de pedidos pagos nos últimos 7 dias no Mercado Livre?

Ele deve chamar `aggregate_orders` e responder com o número computado. Para
conferir a conexão, peça ao agente para chamar `connection_status`: é grátis e é
a única checagem que realmente busca o token do Mercado Livre. O botão **Testar
conexão** do painel confere só que o mcplace está no ar, que o conector está
ativo e que existe uma autorização gravada.

## Mais de uma conta conectada

A URL é sua, não de uma loja: alcança todas as contas conectadas no seu espaço
de trabalho. Para saber o que o agente alcança, peça a ele para chamar
`connection_status` sem parâmetro: é grátis e devolve a lista, com o apelido de
cada conta.

Diga a conta pelo apelido, no pedido ou no parâmetro `account` (por exemplo,
`account: "loja-sul"`). Toda **escrita** leva uma conta explícita; o servidor
nunca escolhe por você. Numa leitura sem conta, se mais de uma servir, o
agente recebe a lista para escolher (veja
[`account_ambiguous`](/erros-e-limites#account_ambiguous)).

Para ligar um agente a uma conta só, acrescente `/a/<apelido>` ao fim da URL.
Continua sendo a mesma URL, não uma segunda credencial: girar a URL corta
também a forma estreitada.

## Alternativas de autenticação

A URL do painel vai no campo de endereço da conexão. Ela não funciona como
cabeçalho `Authorization` — para um cliente que só aceita cabeçalho, use uma
chave de API.

### Chave de API

Crie em *API keys* no painel e envie como `Authorization: Bearer mcpk_…` (uso
programático/n8n).

### OAuth 2.1

Aponte o cliente para `https://mcp.mcplace.com.br/mcp` e entre com a sua conta
mcplace quando ele pedir. O login sempre cai no seu espaço de trabalho pessoal:
para uma organização, use a URL do painel ou uma chave de API.