commercetools MCP Essentials

Um servidor MCP e kit de ferramentas para integração com as APIs da plataforma commercetools.

Documentação

[!IMPORTANT] O Commerce MCP é fornecido gratuitamente como um serviço de acesso antecipado. Nosso Contrato de Nível de Serviço não se aplica ao Commerce MCP, e ele é fornecido no estado em que se encontra ("as-is").

commercetools MCP Essentials

Este repositório contém tanto um servidor MCP (que você pode integrar com muitos clientes MCP) quanto essenciais de agente que podem ser usados em frameworks de agentes.

commercetools Model Context Protocol

Configuração

Para executar o servidor MCP do commercetools usando npx, use o seguinte comando:

Autenticação com Credenciais de Cliente (Padrão)

# To set up all available tools (authType is optional, defaults to client_credentials)
npx -y @commercetools/mcp-essentials --tools=all --clientId=CLIENT_ID --clientSecret=CLIENT_SECRET --projectKey=PROJECT_KEY --authUrl=AUTH_URL --apiUrl=API_URL

# Explicitly specify client_credentials (optional)
npx -y @commercetools/mcp-essentials --tools=all --authType=client_credentials --clientId=CLIENT_ID --clientSecret=CLIENT_SECRET --projectKey=PROJECT_KEY --authUrl=AUTH_URL --apiUrl=API_URL

# To set up all read-only tools
npx -y @commercetools/mcp-essentials --tools=all.read --clientId=CLIENT_ID --clientSecret=CLIENT_SECRET --projectKey=PROJECT_KEY --authUrl=AUTH_URL --apiUrl=API_URL

# To set up specific tools
npx -y @commercetools/mcp-essentials --tools=products.read,products.create --clientId=CLIENT_ID --clientSecret=CLIENT_SECRET --projectKey=PROJECT_KEY --authUrl=AUTH_URL --apiUrl=API_URL

Autenticação com Token de Acesso

# To set up all available tools with access token
npx -y @commercetools/mcp-essentials --tools=all --authType=auth_token --accessToken=ACCESS_TOKEN --projectKey=PROJECT_KEY --authUrl=AUTH_URL --apiUrl=API_URL

# To set up all read-only tools with access token
npx -y @commercetools/mcp-essentials --tools=all.read --authType=auth_token --accessToken=ACCESS_TOKEN --projectKey=PROJECT_KEY --authUrl=AUTH_URL --apiUrl=API_URL

Certifique-se de substituir CLIENT_ID, CLIENT_SECRET, PROJECT_KEY, AUTH_URL, API_URL e ACCESS_TOKEN pelos seus valores reais. Se estiver usando o parâmetro customerId, substitua CUSTOMER_ID pelo ID real do cliente. Alternativamente, você pode definir a API_KEY nas suas variáveis de ambiente.

Para visualizar informações sobre como desenvolver o servidor MCP, consulte este README.
Para visualizar informações sobre como executar localmente o servidor MCP inicializado, consulte este README.

[!IMPORTANT] Para carregar todas as ferramentas disponíveis, defina --tools=all e --isAdmin=true; todas as ferramentas disponíveis serão carregadas no servidor MCP. Para limitar o número de ferramentas carregadas, defina --tools=all.read para ferramentas somente leitura ou --tools=carts.read,quote.create,quote.read,.... Para desativar o carregamento dinâmico de ferramentas, defina dynamicToolLoadingThreshold para um valor muito alto, por exemplo, --dynamicToolLoadingThreshold=650.

Consulte nossa documentação pública oficial para um guia mais avançado e abrangente sobre como aproveitar ao máximo nossas ofertas de MCP.