Visão geral

Autenticação

As credenciais são enviadas apenas na primeira requisição — a que inicia a sessão MCP. Não há rota separada de login; o próprio handshake MCP autentica o cliente.

Headers obrigatórios — 1ª requisição

Fluxo interno de autenticação

Ao receber as credenciais no handshake, cada servidor faz login na API correspondente e armazena o Bearer token em memória para a sessão. Em caso de resposta 401, o token é descartado e o login é refeito automaticamente.

// Body (JSON)
{
  "email": "<x-api-email>",
  "password": "<x-api-password>"
}

// Resposta
{ "token": "eyJ..." }

// Mutation GraphQL
mutation {
  login(params: {
    email: "<x-api-email>"
    password: "<x-api-password>"
    scope: ["offline_access"]
  }) { access_token }
}

// Resposta
{ "login": { "access_token": "eyJ..." } }

Gerenciamento de sessão

VM MCP — Visual Management

26 ferramentas para análise de indicadores de Visual Management, manuais de espaço, galerias de mídia e evidências de aprovação.

Indicadores

Grupos & Lojas

Manuais

Espaços

Galeria & Evidências

Checklist MCP

19 ferramentas para gestão de checklists, execuções e planos de ação. Internamente utiliza GraphQL (Hasura).

Listagens

Execuções de Checklist

Planos de Ação

Exemplos — cURL

Iniciar sessão VM MCP

curl -X POST https://mcp-vm.vitrineretail.app/mcp \
  -H "Content-Type: application/json" \
  -H "x-api-email: SEU_EMAIL" \
  -H "x-api-password: SUA_SENHA" \
  -D - \
  -d '{"jsonrpc":"2.0","method":"initialize","id":1,"params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"my-client","version":"1.0"}}}'

Chamar ferramenta com sessão ativa

curl -X POST https://mcp-vm.vitrineretail.app/mcp \
  -H "Content-Type: application/json" \
  -H "mcp-session-id: <SESSION_ID_RETORNADO>" \
  -d '{"jsonrpc":"2.0","method":"tools/call","id":2,"params":{"name":"listar_manuais","arguments":{}}}'

Buscar execuções — Checklist MCP

curl -X POST https://mcp-checklist.vitrineretail.com/mcp \
  -H "Content-Type: application/json" \
  -H "mcp-session-id: <SESSION_ID>" \
  -d '{"jsonrpc":"2.0","method":"tools/call","id":3,"params":{"name":"buscar_execucoes_checklist","arguments":{"checklist_ids":[42],"execution_state_id":5,"limit":100}}}'

Exemplos — JavaScript fetch

// 1. Iniciar sessão
const initRes = await fetch('https://mcp-vm.vitrineretail.app/mcp', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-email': process.env.VR_EMAIL,
    'x-api-password': process.env.VR_PASSWORD,
  },
  body: JSON.stringify({
    jsonrpc: '2.0', method: 'initialize', id: 1,
    params: {
      protocolVersion: '2024-11-05',
      capabilities: {},
      clientInfo: { name: 'my-client', version: '1.0' },
    },
  }),
});

const sessionId = initRes.headers.get('mcp-session-id');

// 2. Chamar ferramenta
const toolRes = await fetch('https://mcp-vm.vitrineretail.app/mcp', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'mcp-session-id': sessionId,
  },
  body: JSON.stringify({
    jsonrpc: '2.0', method: 'tools/call', id: 2,
    params: { name: 'indicadores_lojas', arguments: {
      startDate: '2025-01-01',
      endDate: '2025-01-31',
    } },
  }),
});

const data = await toolRes.json();
console.log(data.result.content[0].text);

Guia de Uso no ChatGPT, Claude e Gemini

Solução de problemas