Developer MCP

Crie e gerencie lojas usando qualquer agente de IA com o Model Context Protocol.

O que é o MCP?

O MCP (Model Context Protocol) é um protocolo aberto que permite que assistentes de IA se conectem diretamente a serviços externos. Com o MCP do Acesso Comercial, qualquer agente compatível — como ChatGPT, Claude, Cursor ou GitHub Copilot — pode criar lojas, gerenciar produtos, configurar frete, domínios e muito mais.

Para lojistas: Você não precisa saber programar. Basta conectar um agente de IA e pedir "crie minha loja online" — o agente faz todo o trabalho usando as ferramentas do MCP.

Criando sua Loja com IA

O fluxo para criar ou conectar uma loja via MCP funciona assim:

Conecte um agente MCP — Configure a URL do MCP no seu agente preferido (veja abaixo).
Peça para criar ou conectar uma loja — O agente chama connect_or_create_store e recebe uma URL de verificação + código.
Autentique no navegador — Abra a URL, insira o código e crie uma conta ou faça login.
Pronto! — O agente recebe um token de API e pode gerenciar sua loja completa: produtos, categorias, frete, cupons, pedidos, domínio e mais.

Modo teste: Novas lojas criadas via MCP iniciam em modo teste com o plano essential (sem pagamento). Você pode configurar tudo e só pagar quando estiver pronto para ir ao ar.

Configuração

O MCP do Acesso Comercial é acessível via URL. Qualquer cliente MCP compatível com o protocolo Streamable HTTP pode se conectar.

URL do Servidor

URL

https://office.acessocomercial.com/mcp/stream

Cursor

Adicione no arquivo .cursor/mcp.json do seu projeto:

JSON

{
  "mcpServers": {
    "acesso-comercial": {
      "url": "https://office.acessocomercial.com/mcp/stream"
    }
  }
}

Claude Desktop

Adicione nas configurações de MCP do Claude Desktop:

JSON

{
  "mcpServers": {
    "acesso-comercial": {
      "url": "https://office.acessocomercial.com/mcp/stream"
    }
  }
}

ChatGPT (Custom GPTs)

No builder de GPTs, adicione uma Action apontando para o endpoint MCP:

URL

https://office.acessocomercial.com/mcp/stream

Qualquer Cliente MCP

Qualquer cliente compatível com o protocolo MCP Streamable HTTP pode se conectar usando a URL acima. O servidor aceita requisições POST (mensagens JSON-RPC), GET (stream SSE) e DELETE (encerrar sessão).

Ferramentas Disponíveis

O MCP disponibiliza 19 ferramentas organizadas em categorias:

Onboarding

Ferramenta	Descrição
`connect_or_create_store`	Inicia o fluxo OAuth Device Flow para criar uma nova loja ou conectar a uma existente. Retorna URL e código de verificação.
`check_auth_status`	Verifica o status do fluxo de autenticação. Retorna "pending" ou o hostname e token quando completado.

Gerenciamento da Loja

Ferramenta	Descrição
`get_store_info`	Retorna informações da loja: nome, plano, modo teste, domínio e configurações.
`update_store`	Atualiza nome, descrição e texto "sobre" da loja.
`generate_api_token`	Gera um novo token de API para a loja.

Domínio

Ferramenta	Descrição
`setup_custom_domain`	Configura um domínio personalizado. Retorna instruções de nameserver.
`get_domain_status`	Verifica status de propagação DNS do domínio.

Catálogo e Operações

Ferramenta	Descrição
`manage_categories`	CRUD de categorias de produtos.
`manage_orders`	Listar, visualizar e atualizar pedidos.
`manage_coupons`	CRUD de cupons de desconto.
`manage_shipping`	Configurar zonas de frete e embalagens.
`manage_customers`	Listar e visualizar detalhes de clientes.

Templates

Ferramenta	Descrição
`upload_template`	Enviar um template personalizado para a loja.
`list_templates`	Listar templates disponíveis.
`publish_template`	Publicar um template na loja.
`preview_template`	Gerar URL de preview de um template.

GraphQL e Documentação

Ferramenta	Descrição
`query_storefront`	Executar queries GraphQL na Storefront API.
`query_office`	Executar queries e mutations na Office API (produtos, estoque, etc.).
`get_graphql_schema`	Introspection do schema GraphQL de qualquer API.
`get_storefront_api_docs`	Documentação da Storefront API por seção.
`get_office_api_docs`	Documentação da Office API por seção.

Integração

Ferramenta	Descrição
`get_integration_guide`	Guia de integração com código scaffold para o framework escolhido (Next.js, React, Vue, Astro).

Exemplos de Uso

Depois de configurar o MCP, você pode pedir ao agente:

"Crie uma loja para minha empresa de camisetas"
"Adicione 3 produtos com fotos à minha loja"
"Configure frete grátis para compras acima de R$100"
"Crie um cupom de 10% de desconto chamado BEMVINDO"
"Configure meu domínio personalizado minhacamisetaria.com.br"
"Liste os pedidos dos últimos 7 dias"
"Gere o código scaffold para meu frontend em Next.js"

Fluxo de Autenticação

O MCP usa o padrão OAuth 2.0 Device Authorization Grant:

O agente chama connect_or_create_store
Recebe uma URL de verificação e um código (ex: ABCD-1234)
O usuário abre a URL e insere o código
Na mesma página, faz login ou cria conta (suporta Google Sign-In)
O agente chama check_auth_status para obter o token
Com o token, todas as outras ferramentas ficam disponíveis

Modo Teste e Produção

Lojas criadas via MCP iniciam em modo teste com o plano essential:

200 produtos, 3 imagens por produto
5 itens em promoção, 3 funis, 10 cupons
Todas as funcionalidades disponíveis para desenvolvimento
Checkout e pagamentos reais desabilitados

Para ir ao ar: acesse o painel Office (office.acessocomercial.com), escolha um plano e ative o modo produção.