Documentação

Seus agentes operando os marketplaces

O Marketplace Connect liga um assistente de IA — ou o seu próprio sistema — às APIs dos marketplaces brasileiros. Ler, decidir e executar dentro da loja, sem você abrir nove abas.

O que é

É um servidor MCP. Na prática: o seu assistente ganha ações de verdade — listar anúncios, mudar preço, responder pergunta de comprador, criar promoção, emitir nota. Ele não descreve o que fazer; ele faz.

São 1.052 ferramentas distribuídas em 9 marketplaces em produção. Você não precisa carregar todas — a seção conector do seu marketplace explica.

Qual caminho é o seu

Há dois, e eles não competem. A maioria começa pelo primeiro.

Conectar no Claude

1. Abra Conectores e escolha Adicionar conector personalizado.
2. Cole o endereço: https://mcp.tiops.com.br/mcp — ou o do seu marketplace, na tabela abaixo.
3. Autorize com a sua conta. É login, não chave: nada para copiar e colar.
4. Feche e abra a conversa. O assistente carrega as ferramentas no início da sessão.

Conectar no ChatGPT

1. Adicione o conector do Marketplace Connect.
2. Autorize com a sua conta. Pronto — são só esses dois passos.

A mesma conta vale nos dois assistentes, e as suas lojas aparecem nos dois.

Codex, Cursor e outros clientes MCP

Qualquer cliente compatível com MCP conecta no mesmo endereço. No Codex e no Cursor, procure a configuração de servidores MCP e aponte para https://mcp.tiops.com.br/mcp.

Ainda não temos vídeo do Codex. Se travar na configuração, peça ao seu assistente para abrir um chamado que a gente ajuda.

Conector do seu marketplace

O endereço completo carrega as 1.052 ferramentas de uma vez. Se você vende num marketplace só, existe um endereço que carrega apenas as dele — a IA erra menos de ferramenta e sobra mais espaço para a conversa.

Vende em mais de um? Pode adicionar vários conectores. Cada endereço já inclui as ações comuns — conta, plano, crédito, suporte e links — então um conector sozinho basta.

O que pedir primeiro

Depois de conectar, estas quatro mostram que está tudo de pé:

• "Lista minhas contas conectadas" — confirma o que o agente enxerga.
• "Quais anúncios meus estão sem estoque?"
• "Tem pergunta de comprador sem resposta?"
• "Como estão minhas vendas nos últimos 7 dias?"

Sua chave de API

Só é necessária no caminho da API. Pelo assistente, a autorização é por login e não existe chave para guardar.

Primeira chamada

Copie, troque SUA_CHAVE e rode. Ela lista as suas contas conectadas:

curl -X POST https://mcp.tiops.com.br/mcp \
  -H "x-api-key: SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"list_accounts","arguments":{}}}'

Voltou a sua lista de lojas? Está funcionando. Para descobrir o que mais dá para fazer, chame list_actions.

Formato da Requisição

POST https://mcp.tiops.com.br
Authorization: Bearer mc_live_XXXXXX
Content-Type: application/json

{
  "action": "nome_da_action",
  "params": { ... }
}

Resposta de sucesso

{
  "status": 200,
  "data": { ... }
}

Resposta de erro

{
  "error": "mensagem"
}

Quando dá erro

Travou em algo que não está aqui? Peça ao seu assistente para abrir um chamado — ele já manda o diagnóstico junto, e isso encurta muito o atendimento.

Referência

As ações abaixo valem tanto por API quanto pelo assistente — pelo assistente você não precisa saber o nome delas, mas às vezes ajuda pedir uma pelo nome.

Sistema

Mercado Livre — Anúncios

+60 ações ML — use list_actions para ver todas.

Mercado Livre Ads

⚠️ ML Ads: somente leitura no momento. Escrita aguardando liberação do Developer Partner.

Shopee — Produtos

Shopee — Pedidos

Shopee — Financeiro

Shopee Ads

PRO

Shopee Chat

Shopee Devoluções

Shein NOVO

43 ações Shein — use list_actions para ver todas. Use describe_action para ver parâmetros de cada.

Bling ERP

~60 ações Bling via erp_bling_* — use list_actions para todas.

Olist

178 ações Olist via erp_olist_* — use list_actions para todas.

Shopee Afiliados

Agentes IA

Cada agente tem acesso a um subconjunto de ações e contas. Tags controlam quais contas cada agente pode operar:

// Tags em marketplace_accounts
{ "name": "agente_vendas", "value": "1" }

// Agent só vê contas com tag correspondente
list_accounts → filtra por tags do agente

GPT Actions (ChatGPT)

Use o OpenAPI schema em docs/openapi/openapi-gpt.yaml para criar um GPT personalizado. Autenticação via API Key no header x-api-key.

POST https://mcp.tiops.com.br
x-api-key: mc_live_XXXXXX

{ "action": "shopee_sales_summary", "params": { "shopId": "123", "days": 30 } }

Multi-Account & Tags

Conecte múltiplas contas do mesmo marketplace. Use o param correto para cada conta:

list_accounts retorna param_to_use com os IDs corretos para cada conta.

Billing

Consulte preços e planos em marketplaces.tiops.com.br.

Erros

Avançado

Links medidos NOVO

Link cru não tem clique medido. Encurte antes de publicar em rede social, e-mail ou anúncio, e depois você sabe o que funcionou.

Para separar por canal, marque a origem ao divulgar — o mesmo link serve todos:

https://l.tiops.com.br/lancamento?o=instagram
https://l.tiops.com.br/lancamento?o=email

📋 Prompt Universal de Integração

You are building an integration with the Marketplace Connect API. Here's everything you need:

## API Endpoint
POST https://mcp.tiops.com.br
Auth header: x-api-key: mc_live_XXXXXX (or Authorization: Bearer mc_live_XXXXXX)

## Request Format
{ "action": "action_name", "params": { ... } }

## Key Discovery Actions
1. list_actions — get ALL 1052 available actions with descriptions
2. describe_action — get params/schema for any action: { "action": "describe_action", "params": { "action_name": "shopee_sales_summary" } }
3. list_accounts — get connected accounts with param_to_use for each

## Supported Marketplaces
- Mercado Livre (items, orders, ads, questions, shipping, catalog)
- Shopee (products, orders, ads, chat, returns, finance)
- Shein (products, orders, inventory, finance, shipping, compliance) — 43 actions
- Bling ERP (products, orders, stock, contacts, invoices) — 60+ actions
- Olist (orders, products, shipping, contacts) — 178 actions
- Shopee Affiliates (search, generate links)

## Multi-Account
Each account has a unique ID. Use param_to_use from list_accounts:
- Mercado Livre: meliUserId
- Shopee: shopId
- Shein: supplierId

## Response Format
Success: { "status": 200, "data": { ... } }
Error: { "error": "message" }

## How to Build
1. Call list_actions to discover available actions (cache this)
2. For any new action, call describe_action first to see required params
3. Call the action with proper params
4. Handle pagination where applicable (offset/limit or pageNum/pageSize)

## Available Agent Platforms
- Claude Desktop/Code: MCP Server URL https://mcp.tiops.com.br/mcp?key=YOUR_KEY
- ChatGPT: Use GPT Actions with OpenAPI schema
- OpenAI Codex: MCP config in ~/.codex/config.toml
- OpenClaw: MCP config
- Any HTTP client: POST to https://mcp.tiops.com.br with x-api-key header

Generate the integration code in the language/framework of your choice. Include auth, discovery, and at least 5 useful marketplace operations.