MCP OData Connect

Conecte suas IAs diretamente ao OData Connect da plataforma Mercado Eletrônico. Consultas de procurement, rastreamento de pedidos e análises financeiras via linguagem natural — para sub-agentes Genius e ferramentas externas como Claude e Cursor.

---

O MCP OData Connect expõe as ferramentas do OData Connect do Mercado Eletrônico via Model Context Protocol (MCP). Agentes de IA podem consultar requisições de compra, pedidos, cotações, contratos, notas fiscais e outras entidades usando linguagem natural, sem montar chamadas OData manualmente.

• 16 tools disponíveis
• 8 domínios cobertos
• 50+ entidades OData
• Autenticação com tokens dinâmicos

Como conectar

Selecione o tipo de agente abaixo e use a configuração indicada. O Client ID e o Client Secret são exatamente a Key e o Secret que você obtém no Partner's portal ao criar uma API Key (as mesmas credenciais usadas nas nossas APIs). Consulte Credenciais para criar e gerenciar suas chaves.

Sub-agentes Genius (plataforma ME)

Para agentes que rodam dentro da plataforma Mercado Eletrônico (sub-agentes nativos):

• Protocolo: HTTP · /mcp
• URL do servidor: https://mcp.mercadoe.rocks/mcp
• Autenticação: Repasse automático de headers

Configure na plataforma Mercado Eletrônico nos campos de MCP:

Campo	Valor
Servidor	https://mcp.mercadoe.rocks/mcp
Autenticação	Repasse automático de headers

Claude Desktop

No Claude Desktop (e em outras conexões via SSE), edite o arquivo de configuração MCP (no Windows: %APPDATA%\Claude\claude_desktop_config.json; no macOS: ~/Library/Application Support/Claude/claude_desktop_config.json). Adicione o servidor com a URL SSE e os headers obrigatórios: credenciais e ambiente (x-odata-env). Exemplo:

{
  "mcp_servers": {
    "me-odata": {
      "url": "https://mcp.mercadoe.rocks/mcp/sse",
      "headers": {
        "x-client-id": "SUA_KEY",
        "x-client-secret": "SEU_SECRET",
        "x-odata-env": "prod"
      }
    }
  }
}

Substitua SUA_KEY e SEU_SECRET pelo Client ID (Key) e Client Secret (Secret) do Partner's portal. O header x-odata-env é obrigatório em conexões SSE (Claude Desktop e similares); escolha um dos ambientes: trunk, stg, prod. Reinicie o Claude Desktop após alterar o arquivo.

cURL / HTTP (testes)

Para testar o endpoint HTTP diretamente (por exemplo com cURL), use a URL base e envie os headers de autenticação e o ambiente (x-odata-env):

curl -X POST "https://mcp.mercadoe.rocks/mcp" \
  -H "x-client-id: SUA_KEY" \
  -H "x-client-secret: SEU_SECRET" \
  -H "x-odata-env: prod" \
  -H "Content-Type: application/json" \
  -d '{"method":"tools/list"}'

Substitua SUA_KEY, SEU_SECRET e o valor de x-odata-env (ex.: prod, trunk, stg) conforme seu ambiente.

Autenticação

Dois mecanismos estão disponíveis, conforme o contexto do agente.

Mecanismo	Headers	Uso
Maior prioridade	x-access-token	Token JWT do usuário (obtido via plataforma/Genius)
Modo agente externo	x-client-id + x-client-secret	Gera token automaticamente (Claude, Cursor, etc.)
Obrigatório (SSE/externo)	x-odata-env	Ambiente OData. Em Claude Desktop e conexões SSE deve ser enviado. Valores: trunk, stg, prod

📘 Nota

No modo agente externo, Client ID = Key e Client Secret = Secret — os mesmos valores que você obtém no Partner's portal ao criar uma API Key (e que usa nas nossas APIs). Use a Key no header x-client-id e o Secret no header x-client-secret. Em conexões via SSE (Claude Desktop e similares), o header x-odata-env é obrigatório.

Ferramentas disponíveis

Todas as tools do OData Connect do Mercado Eletrônico estão acessíveis via linguagem natural:

Tool	Descrição
query_odata	Query universal em qualquer entidade OData com filtros avançados
get_requests	Requisições de compra com rastreamento de status
get_orders	Pedidos de compra com análise de ciclo de vida
get_procurement_flow	Rastreia o fluxo completo: Requisição → RFQ → Pedido → Fatura
get_order_detail	Visão 360° do pedido: itens, entregas e borgs em uma chamada
get_request_detail	Requisição completa com aprovadores e objetos de custo
get_request_items_tracking	Previsão de entrega real cruzando RFQs e logística
get_invoices	Notas fiscais para reconciliação financeira
get_contracts	Contratos com saldo, vínculos e aprovações
get_products	Catálogo de produtos com busca por descrição
get_rfqs	Cotações e respostas de fornecedores
global_search	Busca cross-domain de qualquer ID em múltiplos domínios

Para detalhes dos dados expostos via OData, consulte o OData feed e os Schemas.

---

Playground

Teste a conexão com o servidor MCP: Listar tools não exige credenciais; para Chamar uma tool, preencha Key e Secret do Partner's portal.

Listar tools

Clique para ver as tools disponíveis.

A resposta aparecerá aqui ao listar tools ou chamar uma tool.