You run a dedicated MCP server that lets Claude Desktop manage UnoPim Product Information Management data. It supports creating products and families, managing attributes, uploading media, and handling configurable products through natural language conversations, while handling authentication and remote access.

How to use

To use the UnoPim MCP Server with Claude Desktop, connect your MCP client to the server using either the remote HTTP endpoint or a local stdio shortcut. The HTTP option is the recommended default for Claude Desktop when you want remote access, while the local stdio option is useful when you run the server directly on your machine.

Typical workflows include creating product families and attributes, building configurable products with variants like color or size, and uploading media that automatically links to the correct product or category. You can perform actions such as creating products, adding variants, uploading images, and discovering the data model through the available tools. Start by establishing a connection to the HTTP endpoint, or run the local server and point your MCP client to the provided stdio command.

Example connection configuration (HTTP) to use from your MCP client:
```json
{
  "mcpServers": {
    "unopim": {
      "url": "https://your-server.azurewebsites.net/mcp"
    }
  }
}

This configures a remote HTTP MCP server named unopim with the provided URL. If you prefer a local runtime, the client can be configured to start the server as a stdio process.

## How to install

Prerequisites: Node.js and npm are required to build and run the MCP server

1. Install dependencies

npm install

2. Build the project

npm run build

3. Configure environment variables (examples shown; replace with your values)

export UNOPIM_BASE_URL="http://your-unopim:8000" export UNOPIM_CLIENT_ID="your_client_id" export UNOPIM_CLIENT_SECRET="your_client_secret" export UNOPIM_USERNAME="api-user@email.com" export UNOPIM_PASSWORD="password"

4. Start the HTTP server (recommended for Claude Desktop remote access)

node dist/index-http.js

Optional: expose the server via ngrok for remote access

ngrok http 3000

## Configuration and usage notes

You can also run the server in local stdio mode if you prefer to start it directly from your environment. The configuration below shows how to run the server using a local node command and pass the required environment variables.

{ "mcpServers": { "unopim": { "command": "node", "args": ["dist/index-http.js"], "env": { "UNOPIM_BASE_URL": "https://your-unopim.com", "UNOPIM_CLIENT_ID": "your_client_id", "UNOPIM_CLIENT_SECRET": "your_client_secret", "UNOPIM_USERNAME": "api-user", "UNOPIM_PASSWORD": "password" } } } }

## Claude Desktop configuration examples

Remote HTTP mode (Azure/Cloud) is the recommended setup for Claude Desktop. Use the remote URL to connect from Claude.

{ "mcpServers": { "unopim": { "url": "https://your-server.azurewebsites.net/mcp" } } }

Remote SSE mode (alternative) is available if you choose server-sent events for the connection.

{ "mcpServers": { "unopim": { "url": "https://your-server.azurewebsites.net/sse" } } }

Local (stdio) mode uses a local command to start the MCP server, with environment variables configured as shown.

{ "mcpServers": { "unopim": { "command": "node", "args": ["/path/to/unopim-mcp/dist/index.js"], "env": { "UNOPIM_BASE_URL": "https://your-unopim.com", "UNOPIM_CLIENT_ID": "your_client_id", "UNOPIM_CLIENT_SECRET": "your_client_secret", "UNOPIM_USERNAME": "api-user", "UNOPIM_PASSWORD": "password" } } } }

## Media and data handling notes

Upload product media via URL or base64. Each media upload automatically links to the corresponding product or category and updates the UI immediately with the new image.

## Available tools

### unopim\_get\_schema

Fetch complete data model from UnoPim to understand available attributes, families, categories, and products.

### unopim\_get\_attributes

List all attributes with their types for configuring products and variants.

### unopim\_get\_families

List all product families defined in UnoPim.

### unopim\_get\_family\_schema

Get detailed schema for a specific product family.

### unopim\_create\_attribute

Create a new attribute (text, select, boolean, price, etc.).

### unopim\_create\_attribute\_options

Create options for select-type attributes.

### unopim\_get\_attribute\_options

Retrieve options for a select attribute.

### unopim\_get\_attribute\_groups

List attribute groups.

### unopim\_create\_attribute\_group

Create an attribute group.

### unopim\_create\_family

Create a new product family.

### unopim\_update\_family

Update an existing product family.

### unopim\_get\_categories

Fetch the category tree.

### unopim\_create\_category

Create a new category.

### unopim\_get\_products

List products with filtering.

### unopim\_get\_product

Get a single product by SKU.

### unopim\_create\_product

Create a simple product.

### unopim\_update\_product

Update an existing product.

### unopim\_upsert\_product

Create or update a product.

### unopim\_smart\_create\_product

Auto-validate and create a product against its family schema.

### unopim\_bulk\_create\_products

Batch create multiple products.

### unopim\_create\_configurable\_product

Create a configurable parent product with variants.

### unopim\_add\_variant

Add a variant to a configurable product.

### unopim\_update\_configurable\_product

Update a configurable product.

### unopim\_upload\_product\_media

Upload and auto-link media to a product.

### unopim\_upload\_category\_media

Upload and auto-link media to a category.