Developer MCP

Integre a documentação e APIs diretamente no seu editor com o Model Context Protocol.

O que é o MCP?

O MCP (Model Context Protocol) permite que assistentes de IA como Cursor, GitHub Copilot e outros acessem diretamente a documentação e façam queries nas APIs do Acesso Comercial. Em vez de copiar exemplos da documentação, o assistente busca as informações automaticamente.

Para desenvolvedores: Configure o MCP no seu editor e peça ao assistente "como listar produtos na Storefront API?" — ele busca a resposta diretamente na nossa documentação oficial.

Instalação

Cursor

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

JSON

{
  "mcpServers": {
    "acesso-comercial": {
      "command": "npx",
      "args": ["-y", "@acessocomercial/mcp-server"],
      "env": {
        "STORE_HOSTNAME": "sua-loja",
        "OFFICE_API_TOKEN": "sk_live_..."
      }
    }
  }
}

Variáveis de Ambiente

Variável	Obrigatória	Descrição
`STORE_HOSTNAME`	Sim	Hostname da sua loja (ex: `minha-loja`).
`OFFICE_API_TOKEN`	Não	Token da Office API para queries de produtos. Necessário apenas para ferramentas da Office API.

Ferramentas Disponíveis

O MCP disponibiliza 5 ferramentas para o assistente de IA:

get_storefront_api_docs

Busca documentação da Storefront API por seção.

Parâmetros

section?: "authentication" | "cart" | "products" | "checkout" | "integration"

get_office_api_docs

Busca documentação da Office API por seção.

Parâmetros

section?: "authentication" | "products" | "mutations" | "queries"

query_storefront

Executa queries GraphQL na Storefront API.

Parâmetros

hostname: string    // Hostname da loja
query: string       // Query GraphQL
variables?: object  // Variáveis
token?: string      // Bearer token (opcional)

query_office

Executa queries e mutations na Office API.

Parâmetros

token: string       // Token sk_live_...
query: string       // Query ou mutation GraphQL
variables?: object  // Variáveis

get_graphql_schema

Faz introspection no schema GraphQL de qualquer API.

Parâmetros

api: "storefront" | "office"
hostname?: string   // Para storefront
token?: string      // Para office

Exemplos de Uso

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

"Como adicionar um produto ao carrinho na Storefront API?"
"Liste os 5 primeiros produtos da minha loja"
"Crie um produto chamado 'Camiseta Azul' com preço R$49,90 via Office API"
"Qual o schema GraphQL completo da Storefront API?"
"Como funciona a autenticação por token na Office API?"