[IMPORTANTE]
Nota importante: Commerce MCP se proporciona gratuitamente como servicio de acceso anticipado. Nuestro Acuerdo de Nivel de Servicio no se aplica a Commerce MCP, y se proporciona "tal cual".

mCP Essentials de commercetools

Este repositorio contiene tanto un servidor MCP (que se puede integrar con muchos clientes MCP) como elementos esenciales de agentes que se pueden utilizar desde marcos de trabajo de agentes.

commercetools Protocolo de contexto de modelo

Configuración

Para ejecutar el servidor MCP de commercetools utilizando npx, utilice el siguiente comando:

# Para configurar todas las herramientas disponibles npx -y @commercetools/mcp-essentials --tools=all --clientId=CLIENT_ID --clientSecret=CLIENT_SECRET --projectKey=PROJECT_KEY --authUrl=AUTH_URL --apiUrl=API_URL Para configurar todas las herramientas de sólo lectura npx -y @commercetools/mcp-essentials --tools=all.read --clientId=CLIENT_ID --clientSecret=CLIENT_SECRET --projectKey=PROJECT_KEY --authUrl=AUTH_URL --apiUrl=API_URL

# Para configurar herramientas específicas 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

Asegúrese de sustituir CLIENT_ID, CLIENT_SECRET, PROJECT_KEY, AUTH_URL y API_URL por sus valores reales. Si utiliza el parámetro customerId, sustituya CUSTOMER_ID por el ID real del cliente. Alternativamente, puede establecer la API_KEY en sus variables de entorno.

Utilización con Claude Desktop

Añada lo siguiente a su claude_desktop_config.json. Vea aquí para más detalles.

{ "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: Para utilizar sólo herramientas de sólo lectura, sustituya "--tools=all" por "--tools=all.read"

Herramientas disponibles

Opciones de herramientas especiales

Herramientas individuales

Para ver información sobre cómo desarrollar el servidor MCP, consulte este LÉAME.

MCP Essentials

MCP Essentials de commercetools permite que los marcos de agentes más populares, como LangChain, Vercel's AI SDK y Model Context Protocol (MCP), se integren con las API mediante llamadas a funciones. La biblioteca no es exhaustiva de toda la API commercetools. Incluye soporte para TypeScript y está construida directamente sobre el SDK [Node][node-sdk].

A continuación se incluyen instrucciones básicas, pero consulte el paquete TypeScript para obtener más información.

TypeScript

Instalación

No necesitas este código fuente a menos que quieras modificar el paquete. Si sólo quieres usar el paquete ejecuta

npm install @commercetools/agent-essentials

Requisitos

• Nodo 18+

Uso

La librería necesita ser configurada con las credenciales de cliente API de tu proyecto commercetools que está disponible en tu Merchant center.Importante: Asegúrate de que las credenciales de cliente API tienen los ámbitos necesarios alineados con las acciones que configuras en el agente essentials. Por ejemplo, si configura products: { read: true }, su cliente API debe tener el ámbito view_products. Además, la configuración le permite especificar los tipos de acciones que se pueden realizar utilizando los elementos esenciales del agente.

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: { leer: true, crear: true, actualizar: true, }, proyecto: { leer: true, }, }, }, })

Herramientas

El agente esencial trabaja con LangChain y Vercel's AI SDK y puede ser pasado como una lista de herramientas. Por ejemplo

import { AgentExecutor, createStructuredChatAgent } from "langchain/agents"; const tools = commercetoolsAgentEssentials.getTools(); const agent = await createStructuredChatAgent({ llm, tools, prompt, }); const agentExecutor = new AgentExecutor({ agent, tools, })

Protocolo de contexto de modelo

Commercetools MCP Essentials también permite configurar un servidor MCP propio. Por ejemplo

import { CommercetoolsAgentEssentials } from "@commercetools/agent-essentials/modelcontextprotocol"; import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"; const server = 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: { leer: true, }, carrito: { read: true, create: true, update: true, }, }, }); async function main() { const transport = new StdioServerTransport(); await server.connect(transport); console.error("Mi servidor MCP commercetools personalizado ejecutándose en stdio"); } main().catch((error) => { console.error("Error fatal en main():", error); process.exit(1); })

getHerramientas()

Devuelve el conjunto actual de herramientas disponibles que pueden ser usadas con LangChain, AI SDK, u otros marcos de agentes:

const tools = commercetoolsAgentEssentials.getTools()