Haravan 전자 상거래 OpenAPI MCP 서버 - Ktuñ ni AI 조수 v Algeriai Haravan 상점.

MCP (모델 컨텍스트 프로토콜) 서버 cho phép AI 조수 (Claude, Cursor, Trae) torganng tác tromorphc tiếp vąi Haravan APIs: 쿼넌 lý spresentn ph鶏m, nn hàng, kháchhàng, t nn kho, webhooks và nhiću h.

아래 영어.

---

# # B;t ☸ nhanh

d d d d d Cur Tra

Thêm vào 파일 캐비티 hình MCP :

Stories djung vąi Docker (HTTP 모드)

S d O

---

키요른 trúc 2 ląp

Smart Tools (7): Server-side pagination + 집계 코드 데이터 ląn 기본 도구 (63): 1:1 매핑 v☸ Haravan API cho detail/CRUD

---

스마트 도구

인포메이션 |------|-----------| | hrv_orders_summary | Tissueng DT, AOV, status/source/cancel 고장, 그래서 sánh k Writing tr 다운로드c | | hrv_top_products | 상단 N spresentn ph鶏m theo doanh thu + 변종 고장 | | hrv_order_cycle_time | 미디어/p90 타임-to-confirm/close, nn 붙어 | | [T3] | RFM 8 세그먼트 + 액션 제안 | | hrv_inventory_health | 프놈펜: out of stock / low / dead / Healthy | | hrv_stock_reorder_plan | DSR + 주문점 + 변형 당 qty 건 |

Haravan MCP

Haravan E-commerce OpenAPI MCP Server — Kết nối AI assistants với Haravan stores.

MCP (Model Context Protocol) server cho phép AI assistants (Claude, Cursor, Trae) tương tác trực tiếp với Haravan APIs: quản lý sản phẩm, đơn hàng, khách hàng, tồn kho, webhooks và nhiều hơn.

English below.

---

Bắt đầu nhanh

Sử dụng với Claude / Cursor / Trae

Thêm vào file cấu hình MCP:

{
  "mcpServers": {
    "haravan-mcp": {
      "command": "npx",
      "args": ["-y", "haravan-mcp", "mcp", "-t", ""]
    }
  }
}

Sử dụng với Docker (HTTP mode)

# Clone repo
git clone  && cd HaravanMCP

# Cấu hình token
cp docker/.env.example docker/.env
# Sửa docker/.env → điền HARAVAN_ACCESS_TOKEN

# Chạy
docker compose -f docker/docker-compose.yml up -d

# MCP endpoint: http://localhost:4567/mcp
# Health check: http://localhost:4567/health

Sử dụng với OAuth 2.0

# Bước 1: Login
npx haravan-mcp login -a  -s 

# Bước 2: Cấu hình MCP
{
  "mcpServers": {
    "haravan-mcp": {
      "command": "npx",
      "args": ["-y", "haravan-mcp", "mcp", "-a", "", "--oauth"]
    }
  }
}

---

Kiến trúc 2 lớp

Claude Skill Layer (AI reasoning, insights, formatting)
         │
         │ MCP Protocol
         ▼
MCP Server Layer (pagination, rate limiting, aggregation)
         │
         │ HTTPS + Bearer Token
         ▼
Haravan REST API (apis.haravan.com)

Smart Tools (7): Server-side pagination + aggregation cho data lớn Base Tools (63): 1:1 mapping với Haravan API cho detail/CRUD

---

Smart Tools

---

Base Tools (63 tổng)

---

Presets

# Smart tools only (dashboard/analytics)
haravan-mcp mcp -t  --tools "preset.smart"

# Default (smart + detail drill-down)
haravan-mcp mcp -t  --tools "preset.default"

# Full CRUD cho specific resources
haravan-mcp mcp -t  --tools "preset.products,preset.orders"

# Tất cả tools
haravan-mcp mcp -t  --tools "all"