Pular para o conteúdo principal

ANYMARKET MCP

O ANYMARKET MCP é uma ponte que permite conversar com o ANYMARKET usando linguagem natural dentro do seu assistente de IA favorito (Claude, ChatGPT, Gemini e outros). Em vez de abrir o painel e navegar por vários menus para consultar informações, você pergunta — em português mesmo — e a IA busca a resposta para você.

Importante: por enquanto, o ANYMARKET MCP disponibiliza apenas comandos de consulta (leitura). Você consegue perguntar, listar, buscar e conferir informações, mas ainda não é possível criar, alterar ou excluir dados pelo assistente. Ações de escrita serão liberadas em versões futuras.

Alguns exemplos do que dá para pedir hoje:

  • "Liste os 10 produtos mais recentes do ANYMARKET."
  • "Quantos pedidos entraram hoje?"
  • "Me mostre os produtos que estão sem estoque."
  • "Qual o preço atual deste SKU?"
  • "Quais anúncios estão publicados no Mercado Livre?"
  • "Me traga os detalhes do pedido número 12345."

Você não precisa saber programar, nem entender de API — o assistente cuida disso. Este guia mostra como conectar cada assistente ao ANYMARKET MCP.

Antes de começar

Você vai precisar de:

  • Conta no ANYMARKET com permissão para acessar os recursos que deseja consultar (produtos, pedidos, estoque etc.).
  • Um assistente de IA compatível com MCP já instalado no seu computador — por exemplo, Claude Code, Claude Desktop, Codex CLI, ChatGPT (via Connectors) ou Gemini CLI.
  • Endereço do servidor MCP: https://mcp.anymarket.com.br/mcp — é o mesmo para todos, você só cola essa URL na configuração do seu assistente.

Na primeira vez que você usar, o assistente vai abrir o navegador para você fazer login no ANYMARKET. Depois disso, ele lembra até você fechar a sessão.

O que dá para consultar

O ANYMARKET MCP cobre praticamente todas as áreas do painel — sempre em modo somente leitura:

ÁreaO que você consegue consultar
Produtoslistar, buscar por SKU, ver detalhes e histórico de vendas
SKUs e variaçõesconferir tamanhos, cores, versões e atributos cadastrados
Estoquever saldo por SKU, consultar depósitos e movimentações
Preçosconferir os preços atuais dos itens
Pedidoslistar, ver detalhes, acompanhar status e mensagens
Categorias, marcas e tagsconsultar a organização do catálogo
Imagenslistar as fotos vinculadas a cada produto
Marketplacesver o que está publicado em cada canal (Mercado Livre, Shopee, Amazon etc.)
Callbacks (webhooks)listar avisos automáticos já configurados
Sugestões, características e origensconsultar apoio ao cadastro

Ao todo são mais de 100 comandos de consulta disponíveis — mas você não precisa memorizar nada. Basta pedir em linguagem natural e o assistente escolhe o comando certo.

Como conectar em cada assistente

Todas as configurações abaixo usam o mesmo endereço: https://mcp.anymarket.com.br/mcp

Claude Code

Abra o terminal e rode um destes comandos:

Para deixar disponível em todos os seus projetos:

claude mcp add --scope user --transport http anymarket https://mcp.anymarket.com.br/mcp

Para deixar disponível apenas no projeto atual:

claude mcp add --scope project --transport http anymarket https://mcp.anymarket.com.br/mcp

Feche e abra o Claude Code de novo. Na primeira vez que pedir algo relacionado ao ANYMARKET, o navegador vai abrir para você fazer login.

Claude Desktop

Há duas formas de conectar — pela interface do próprio Claude Desktop (mais simples, recomendada) ou editando o arquivo de configuração (para quem prefere).

Opção 1 — Direto pela tela do Claude Desktop (recomendado)

Se você usa o Claude Desktop com uma conta pessoal, ou se o administrador da sua organização (caso exista) tiver liberado essa possibilidade, dá para adicionar o ANYMARKET sem mexer em nenhum arquivo:

  1. Abra o Claude Desktop.
  2. Vá em Settings → Connectors (ou Configurações → Conectores).
  3. Clique em Add custom connector (Adicionar conector personalizado).
  4. Preencha:
    • Name: ANYMARKET
    • URL: https://mcp.anymarket.com.br/mcp
  5. Salve e ative o conector.

Pronto — o ANYMARKET já aparece disponível nas conversas. Na primeira vez que você pedir algo, o Claude vai abrir o navegador para você fazer login.

Não vê a opção "Add custom connector"? Isso significa que o administrador da sua organização ainda não liberou conectores personalizados. Nesse caso, peça a liberação para ele ou use a Opção 2 abaixo.

Opção 2 — Editando o arquivo de configuração

Abra o arquivo de configuração do Claude Desktop:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Cole (ou junte com o que já existe):

{
"mcpServers": {
"anymarket": {
"type": "http",
"url": "https://mcp.anymarket.com.br/mcp"
}
}
}

Feche completamente e reabra o Claude Desktop. Faça o login na primeira conversa que usar o ANYMARKET.

Codex CLI (OpenAI)

Abra o arquivo ~/.codex/config.toml (no Windows: %USERPROFILE%\.codex\config.toml) e adicione:

[mcp_servers.anymarket]
url = "https://mcp.anymarket.com.br/mcp"

Reinicie o Codex CLI. Depois de conectado, use /mcp para conferir que o ANYMARKET aparece na lista.

ChatGPT (Connectors)

No ChatGPT desktop, vá em Settings → Beta features → Connectors → Add custom connector e preencha:

  • Name: ANYMARKET
  • URL: https://mcp.anymarket.com.br/mcp
  • Auth: OAuth (siga as instruções que aparecem na tela — a autorização é feita pelo próprio ANYMARKET)

Salve, marque o conector como ativo e escolha o modo Agent na conversa.

Gemini CLI (Google)

Abra o arquivo ~/.gemini/settings.json (no Windows: %USERPROFILE%\.gemini\settings.json) e adicione:

{
"mcpServers": {
"anymarket": {
"httpUrl": "https://mcp.anymarket.com.br/mcp",
"timeout": 30000,
"trust": false
}
}
}

Reinicie o Gemini CLI e liste os comandos disponíveis com /tools.

Testando se funcionou

Depois de conectar, peça ao assistente:

"Liste os 5 produtos mais recentes do ANYMARKET."

Se aparecer a lista, está tudo certo. Se quiser conferir com qual conta você está logado, peça:

"Me mostra em qual organização do ANYMARKET eu estou conectado."

Boas práticas

  • Use linguagem clara. Quanto mais específico o pedido (SKU, nome do produto, período), melhor o resultado.
  • Comece com poucos itens. Ao pedir listagens, peça primeiro um número pequeno (por exemplo, "os 5 primeiros") para ver o formato antes de solicitar volumes maiores.
  • Precisa alterar algo? Como o MCP hoje é somente para consulta, qualquer alteração (cadastro, edição, publicação, ajuste de preço ou estoque) ainda precisa ser feita direto no painel do ANYMARKET.

Problemas comuns

O que aconteceProvável motivoO que fazer
O assistente não reconhece comandos do ANYMARKETConfiguração não foi salva ou o assistente não foi reiniciadoConfira o arquivo de configuração e reinicie o assistente
Aparece erro de "não autorizado"Sua sessão expirouFaça login de novo no assistente quando ele pedir
Aparece erro de permissão em algum recursoSua organização não tem acesso àquela consultaPeça ao administrador da conta ANYMARKET para revisar suas permissões
Mensagem de "muitas requisições"Você fez muitos pedidos em pouco tempoEspere alguns segundos e tente novamente com um volume menor
O login não abre no navegadorSeu assistente está desatualizadoAtualize para a versão mais recente do assistente
Pediu para alterar/criar algo e o assistente não fezO MCP hoje é somente leituraFaça a alteração pelo painel do ANYMARKET; ações de escrita serão liberadas em versões futuras

Precisa de ajuda?

Se algo não funcionar, entre em contato com a equipe responsável pelo ANYMARKET na sua empresa — eles têm acesso ao servidor e podem verificar se está tudo rodando corretamente.