pular para o conteúdo
Início rápido

Início rápido

ver .md

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

2. Cole a URL no seu cliente

Escolha o seu cliente:

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

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.

Isso ajudou?

O que é MCP?Claude Desktop