# CCV Shop MCP by usefulapi

> CCV Shop MCP by usefulapi is an MCP server. Read products, orders, customers and invoices; add internal order notes in CCV Shop. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/ccv-shop/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/ccv-shop
- **MCP Registry name:** io.usefulapi/ccv-shop
- **Listing updated:** 2026-11-13

## About

Read products, orders, customers and invoices; add internal order notes in CCV Shop.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http ccv-shop https://ccv-shop.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://ccv-shop.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ccv-shop": {
      "url": "https://ccv-shop.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ccv-shop": {
      "type": "http",
      "url": "https://ccv-shop.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ccv-shop": {
      "serverUrl": "https://ccv-shop.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "ccv-shop": {
      "type": "http",
      "url": "https://ccv-shop.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `ccvshop_list_products`: List the products of this webshop, filtered by product number, EAN or a part of the name. Returns items with ids, prices and stock. Uses GET /api/rest/v1/products/.
- `ccvshop_get_product`: Get one product by id, with its prices, stock, description and attributes. Uses GET /api/rest/v1/products/{id}/.
- `ccvshop_list_orders`: List orders of this webshop. Filter by order number, status, paid state or a creation date range (yyyy-mm-dd). Use this to find recent sales. Uses GET /api/rest/v1/orders/.
- `ccvshop_get_order`: Get one order by id: customer, totals, payment and delivery data. Uses GET /api/rest/v1/orders/{id}/.
- `ccvshop_list_order_rows`: List the order lines (products, quantities, prices) of one order. Uses GET /api/rest/v1/orders/{id}/orderrows/.
- `ccvshop_add_order_note`: Add an INTERNAL note to one order. The note is not emailed to the customer and does not change the order. Uses POST /api/rest/v1/orders/{id}/ordernotes/.
- `ccvshop_list_categories`: List the product categories of this webshop. Uses GET /api/rest/v1/categories/.
- `ccvshop_list_brands`: List the brands of this webshop. Uses GET /api/rest/v1/brands/.
- `ccvshop_list_suppliers`: List the suppliers of this webshop. Uses GET /api/rest/v1/suppliers/.
- `ccvshop_list_invoices`: List the invoices of this webshop. Uses GET /api/rest/v1/invoices/.
- `ccvshop_get_invoice`: Get one invoice by id. Uses GET /api/rest/v1/invoices/{id}/.
- `ccvshop_list_users`: List the customer accounts (users) of this webshop, optionally by approval status (pending or accepted). Uses GET /api/rest/v1/users/.
- `ccvshop_get_user`: Get one customer account (user) by id. Uses GET /api/rest/v1/users/{id}/.

## FAQ

### How do I add CCV Shop MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http ccv-shop https://ccv-shop.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/ccv-shop-mcp-by-usefulapi
