Documentação do Konektor

Visão geral

O Konektor é uma central de inteligência e operação assistida para consultorias de Mercado Livre. Além da tela web e do aplicativo Desktop, o produto expõe duas superfícies de integração para IA: um conjunto de GPT Actions somente leitura e um servidor MCP (Model Context Protocol) híbrido, que agentes como Claude e Codex podem investigar e, com aprovação humana, usar para propor operações.

As duas superfícies compartilham a mesma regra: nenhum agente aprova a própria proposta, nem a de outro agente. Escritas de verdade sempre passam por proposta, aprovação humana, execução e auditoria — nenhuma exceção nasce de uma integração de IA.

GPT Actions (somente leitura)

O GPT privado da consultoria acessa o Konektor por um conjunto de ações REST documentadas em /openapi.json (OpenAPI). Essa superfície é somente leitura: nenhuma ação escreve em conta de cliente, campanha ou anúncio.

A autenticação usa uma chave de tenant emitida pelo próprio dono do workspace, na tela de administração. Ela resolve o workspace inteiro, sempre com escopo analytics:read.

MCP para agentes de IA

O MCP é a superfície para agentes como Claude Code, Claude Desktop, o conector do claude.ai e o Codex. Diferente do GPT Actions, o MCP também permite propor operações — a execução continua exigindo aprovação humana pela tela do produto.

Guia completo de instalação, escopos e solução de problemas: MCP para agentes de IA →.

Segurança e limites, no geral

Alguns limites valem para toda integração de IA no Konektor, não só o MCP:

• Nenhum agente recebe senha, token de acesso ou token de renovação do Mercado Livre.
• Dados de comprador (nome, endereço, telefone, documentos, mensagens) não são enviados a nenhum modelo de IA.
• Dados fiscais, como NCM, são sempre rascunho com fonte indicada — nunca aplicados sem validação humana.
• Números que aparecem em respostas de IA são calculados pelo backend; o modelo interpreta, não calcula.
• Cada workspace é isolado; uma consultoria nunca enxerga dado de outra.

Suporte

Para dúvidas sobre integrações, credenciais ou qualquer comportamento inesperado, escreva para contato.rosiak@gmail.com. Nunca inclua senha, token completo ou dado de comprador no e-mail — se precisar identificar uma credencial, use apenas o final que aparece na tela (o "hint").