commercetools MCP Essentials

Nota important: Commerce MCP es proporciona de forma gratuïta com a servei d'accés inicial. El nostre Acord de Nivell de Servei no s'aplica a Commerce MCP, i es proporciona en una base «tal com és».

El repositori conté tant un servidor MCP (que es pot integrar amb molts clients MCP) com els essencials d'agents que es poden utilitzar dins dels marcs d'agents.

commercetools Model Context Protocol

Configuració

Per executar el servidor MCP de commercetools amb npx, utilitzeu la següent comanda:

# Per configurar tots els eines disponibles
npx -y @commercetools/mcp-essentials --tools=all --clientId=CLIENT_ID --clientSecret=CLIENT_SECRET --projectKey=PROJECT_KEY --authUrl=AUTH_URL --apiUrl=API_URL

# Per configurar tots els eines només de lectura
npx -y @commercetools/mcp-essentials --tools=all.read --clientId=CLIENT_ID --clientSecret=CLIENT_SECRET --projectKey=PROJECT_KEY --authUrl=AUTH_URL --apiUrl=API_URL


# Per configurar eines específiques
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

Assegureu-vos de substituir CLIENT_ID, CLIENT_SECRET, PROJECT_KEY, AUTH_URL i API_URL amb els vostres valors reals. Si utilitzeu el paràmetre customerId, substituïu CUSTOMER_ID pel ID del client real. Alternativament, podeu establir API_KEY en les variables d'entorn.

Ús amb Claude Desktop

Afegiu el següent al vostre claude_desktop_config.json. Vegeu aquí per a més detalls.

{
  "mcpServers": {
    "commercetools": {
      "command": "npx",
      "args": [
        "-y",
        "@commercetools/mcp-essentials@latest",
        "--tools=all",
        "--clientId=CLIENT_ID",
        "--clientSecret=CLIENT_SECRET",
        "--authUrl=AUTH_URL",
        "--projectKey=PROJECT_KEY",
        "--apiUrl=API_URL"
      ]
    }
  }
}

Alternativa: Per utilitzar només els eines només de lectura, substituïu "--tools=all" per "--tools=all.read".

Eines disponibles

Opcions especials d'eina

• all – Habilita totes les eines disponibles (operacions de lectura, creació i actualització)
• all.read – Habilita totes les eines només de lectura (segur per a accés només de lectura)

Eines individuals

MCP Essentials

Els essencials d'agents de commercetools MCP permeten marcs d'agents com LangChain i Vercel's AI SDK i es poden passar com a llista d'eines. Per exemple:

TypeScript

Instal·lació

Utilitzeu el següent codi per instal·lar el paquet:

import { CommercetoolsAgentEssentials } from "@commercetools/agent-essentials/langchain";

const commercetoolsAgentEssentials = new CommercetoolsAgentEssentials({
  clientId: process.env.CLIENT_ID!,
  clientSecret: process.env.CLIENT_SECRET!,
  projectKey: process.env.PROJECT_KEY!,
  authUrl: process.env.AUTH_URL!,
  apiUrl: process.env.API_URL!,
  configuration: {
    actions: {
      products: {
        read: true,
        create: true,
        update: true,
      },
      project: {
        read: true,
      },
    },
  },
});

Requisits

• Node.js
• npm

Ús

Els essencials d'agents requereixen credencials d'API client (disponibles al vostre Merchant center). Important: Assegureu-vos que les credencials de l'API client tinguin els escopos necessaris alineats amb les accions que configureu en els essencials d'agents. Per exemple, si configureu products: { read: true }, el vostre client d'API ha de tenir l'escop view_products. A més, configuration us permet especificar els tipus d'accions que es poden realitzar amb els essencials d'agents.

Eines

Els essencials d'agents funcionen amb LangChain i Vercel's AI SDK i es poden passar com a llista