schemeog-mcp 2.2.0 → 2.3.0

package/README.md

@@ -1,58 +1,58 @@
-# SchemeOG MCP Server v2.1
+# SchemeOG MCP Server v2.2
 
-MCP сервер для [SchemeOG Cloud](https://scheme.smartlaunchhub.com) — создавай диаграммы и схемы с помощью AI.
+MCP server for [SchemeOG Cloud](https://scheme.smartlaunchhub.com) — create diagrams and flowcharts with AI.
 
-## 14 команд для полного контроля
+## 14 Commands
 
-### Схемы (5 команд)
+### Schemas (5 commands)
 
-| Команда | Описание |
-|---------|----------|
-| `list_schemas` | Список всех схем |
-| `get_schema` | Получить схему с данными |
-| `create_schema` | Создать новую схему |
-| `replace_schema` | Заменить содержимое схемы |
-| `delete_schema` | Удалить схему |
+| Command | Description |
+|---------|-------------|
+| `list_schemas` | List all schemas |
+| `get_schema` | Get schema with data |
+| `create_schema` | Create new schema |
+| `replace_schema` | Replace schema content |
+| `delete_schema` | Delete schema |
 
-### Проекты (5 команд)
+### Projects (5 commands)
 
-| Команда | Описание |
-|---------|----------|
-| `list_projects` | Список проектов (папок) |
-| `create_project` | Создать проект |
-| `update_project` | Обновить проект |
-| `delete_project` | Удалить проект |
-| `move_schema_to_project` | Переместить схему в проект |
+| Command | Description |
+|---------|-------------|
+| `list_projects` | List projects (folders) |
+| `create_project` | Create project |
+| `update_project` | Update project |
+| `delete_project` | Delete project |
+| `move_schema_to_project` | Move schema to project |
 
-### Теги (4 команды)
+### Tags (4 commands)
 
-| Команда | Описание |
-|---------|----------|
-| `list_tags` | Список тегов схемы |
-| `add_tag` | Добавить тег в схему |
-| `remove_tag` | Удалить тег из схемы |
-| `tag_element` | Присвоить/убрать тег с элемента |
+| Command | Description |
+|---------|-------------|
+| `list_tags` | List schema tags |
+| `add_tag` | Add tag to schema |
+| `remove_tag` | Remove tag from schema |
+| `tag_element` | Assign/remove tag from element |
 
-## Установка
+## Installation
 
-### Через npx (рекомендуется)
+### Via npx (recommended)
 
 ```bash
 npx schemeog-mcp
 ```
 
-## Настройка
+## Setup
 
-### 1. Получи токен
+### 1. Get your token
 
-1. Открой https://scheme.smartlaunchhub.com
-2. Войди по email
-3. Перейди в Профиль
-4. Скопируй токен из секции "Claude Code Integration"
+1. Open https://scheme.smartlaunchhub.com
+2. Sign in with email
+3. Go to Profile
+4. Copy token from "Claude Code Integration" section
 
-### 2. Добавь в Claude Code / Cline
+### 2. Add to Claude Code / Cline
 
-В `~/.claude.json` (или настройки Cline):
+In `~/.claude.json` (or Cline settings):
 
 ```json
 {
@@ -68,199 +68,154 @@ npx schemeog-mcp
 }
 ```
 
-## Формат данных схемы
+## Schema Data Format
 
-### Полный пример схемы
+### Full schema example
 
 ```json
 {
   "name": "User Registration Flow",
-  "description": "Процесс регистрации пользователя",
+  "description": "User registration process",
   "elements": [
     {
       "id": "start",
       "type": "card",
-      "title": "Форма регистрации",
+      "title": "Registration Form",
       "color": "light_green",
-      "borderColor": "green",
-      "tags": ["пользователь"],
-      "description": "Пользователь заполняет форму с email и паролем"
+      "tags": ["user"],
+      "description": "User fills in email and password"
     },
     {
       "id": "validate",
       "type": "condition",
-      "title": "Валидация данных",
+      "title": "Validate Data",
       "color": "light_yellow",
-      "borderColor": "yellow",
-      "tags": ["система", "проверка"],
-      "description": "Проверка корректности email и сложности пароля"
+      "tags": ["system", "check"],
+      "description": "Check email format and password strength"
     },
     {
       "id": "save",
       "type": "card",
-      "title": "Сохранение в БД",
+      "title": "Save to Database",
       "color": "light_blue",
-      "borderColor": "blue",
-      "tags": ["система"],
-      "description": "Создание записи пользователя в базе данных"
+      "tags": ["system"],
+      "description": "Create user record in database"
     },
     {
       "id": "error",
       "type": "card",
-      "title": "Ошибка валидации",
+      "title": "Validation Error",
       "color": "light_red",
-      "borderColor": "red",
-      "tags": ["система", "ошибка"],
-      "description": "Показать пользователю ошибки валидации"
+      "tags": ["system", "error"],
+      "description": "Show validation errors to user"
     },
     {
       "id": "success",
       "type": "card",
-      "title": "Успешная регистрация",
+      "title": "Registration Complete",
       "color": "light_green",
-      "borderColor": "green",
-      "tags": ["пользователь"],
-      "description": "Пользователь успешно зарегистрирован"
+      "tags": ["user"],
+      "description": "User successfully registered"
     }
   ],
   "connections": [
-    {"from": "start", "to": "validate", "label": "отправка формы"},
-    {"from": "validate", "to": "save", "label": "данные корректны"},
-    {"from": "validate", "to": "error", "label": "ошибка"},
+    {"from": "start", "to": "validate", "label": "submit"},
+    {"from": "validate", "to": "save", "label": "valid"},
+    {"from": "validate", "to": "error", "label": "invalid"},
     {"from": "save", "to": "success"},
-    {"from": "error", "to": "start", "label": "исправить"}
+    {"from": "error", "to": "start", "label": "retry"}
   ],
   "tagsDictionary": [
-    {"id": "tag-user", "name": "пользователь", "color": "#4CAF50"},
-    {"id": "tag-system", "name": "система", "color": "#2196F3"},
-    {"id": "tag-check", "name": "проверка", "color": "#FF9800"},
-    {"id": "tag-error", "name": "ошибка", "color": "#F44336"}
+    {"id": "tag-user", "name": "user", "color": "#4CAF50"},
+    {"id": "tag-system", "name": "system", "color": "#2196F3"},
+    {"id": "tag-check", "name": "check", "color": "#FF9800"},
+    {"id": "tag-error", "name": "error", "color": "#F44336"}
   ]
 }
 ```
 
-### Элемент (card или condition)
+### Element (card or condition)
 
 ```json
 {
   "id": "unique_id",
   "type": "card",
-  "title": "Название карточки",
+  "title": "Card Title",
   "color": "light_blue",
-  "borderColor": "blue",
-  "tags": ["тег1", "тег2"],
-  "description": "Подробное описание действия или процесса"
+  "tags": ["tag1", "tag2"],
+  "description": "Detailed description of the action or process"
 }
 ```
 
-**Типы элементов:**
-- `card` — обычная карточка процесса/действия
-- `condition` — точка принятия решения (ромб)
+**Element types:**
+- `card` — regular process/action card
+- `condition` — decision point (diamond shape)
 
-**Доступные цвета фона (`color`):**
-| Цвет | Назначение |
-|------|------------|
-| `white` | Базовый белый |
-| `light_blue` | Основные процессы |
-| `light_green` | Старт и успех |
-| `light_yellow` | Проверки и условия |
-| `light_orange` | Предупреждения |
-| `light_red` | Ошибки и критичное |
-| `light_purple` | Решения |
-| `light_gray` | Завершение |
-| `light_pink` | Дополнительные процессы |
-| `light_teal` | Специальные операции |
+**Available colors (`color`):**
+| Color | Purpose |
+|-------|---------|
+| `white` | Default white |
+| `light_blue` | Main processes |
+| `light_green` | Start and success |
+| `light_yellow` | Checks and conditions |
+| `light_orange` | Warnings |
+| `light_red` | Errors and critical |
+| `light_purple` | Decisions |
+| `light_gray` | Completion |
+| `light_pink` | Additional processes |
+| `light_teal` | Special operations |
 
-**Цвета обводки (`borderColor`):**
-`default`, `blue`, `green`, `orange`, `purple`, `red`, `teal`, `yellow`, `gray`, `black`
+**Border colors (`borderColor`):** `default`, `blue`, `green`, `orange`, `purple`, `red`, `teal`, `yellow`, `gray`, `black`
 
-**Важно:** НЕ указывай `width`, `height`, `x`, `y` — они рассчитываются автоматически!
+**Important:** Do NOT specify `width`, `height`, `x`, `y` — they are calculated automatically!
 
-### Связь (connection)
+### Connection
 
 ```json
 {
   "from": "source_id",
   "to": "target_id",
-  "label": "подпись (опционально)",
+  "label": "optional label",
   "style": "solid"
 }
 ```
 
-**Стили линий (`style`):** `solid`, `dashed`, `dotted`
+**Line styles (`style`):** `solid`, `dashed`, `dotted`
 
-### Справочник тегов (tagsDictionary)
+### Tags Dictionary (tagsDictionary)
 
 ```json
 {
   "tagsDictionary": [
-    {"id": "tag-1", "name": "система", "color": "#2196F3"},
-    {"id": "tag-2", "name": "пользователь", "color": "#4CAF50"},
-    {"id": "tag-3", "name": "проверка", "color": "#FF9800"}
+    {"id": "tag-1", "name": "system", "color": "#2196F3"},
+    {"id": "tag-2", "name": "user", "color": "#4CAF50"},
+    {"id": "tag-3", "name": "check", "color": "#FF9800"}
   ]
 }
 ```
 
-**Теги = роли/акторы.** Указывают КТО выполняет действие:
-- `система`, `пользователь`, `администратор`
-- `клиент`, `менеджер`, `бот`
-- `муж`, `жена`, `ребёнок` (для личных схем)
+**Tags = roles/actors.** Indicate WHO performs the action:
+- `system`, `user`, `admin`
+- `client`, `manager`, `bot`
 
-## Примеры использования
+## Schema Methodology
 
-### Создать схему
+Schema = complete tree of **ACTIONS** and **CONSEQUENCES**:
 
-```
-Создай схему "Авторизация пользователя" с этапами:
-1. Ввод логина/пароля (пользователь)
-2. Проверка в базе (система)
-3. Успех или ошибка
-```
-
-### Обновить схему
-
-```
-Добавь в схему блок "Двухфакторная аутентификация" между проверкой и успехом
-```
-
-### Работа с проектами
-
-```
-Создай проект "Backend API" с иконкой 🚀 и синим цветом
-```
-
-```
-Перемести схему в проект Backend API
-```
-
-### Работа с тегами
-
-```
-Добавь тег "Critical" красного цвета в схему
-```
-
-```
-Пометь элемент "Валидация" тегом Critical
-```
-
-## Методология создания схем
-
-Схема = полное дерево **ДЕЙСТВИЙ** и **ПОСЛЕДСТВИЙ**:
-
-1. Каждое решение → показать ВСЕ возможные варианты
-2. Каждый вариант → показать ВСЕ последствия
-3. Использовать `condition` для точек принятия решений
-4. НЕ абстрактные размышления — КОНКРЕТНЫЕ пути развития
-5. Теги указывают КТО выполняет действие
+1. Each decision → show ALL possible options
+2. Each option → show ALL consequences
+3. Use `condition` for decision points
+4. NOT abstract thoughts — CONCRETE paths
+5. Tags indicate WHO performs the action
 
-**Пример:**
+**Example:**
 ```
-"Отправка формы" → condition "Валидация" →
-  ├── "Данные корректны" → "Сохранение" → "Успех"
-  └── "Ошибка" → "Показать ошибки" → "Исправить форму"
+"Submit Form" → condition "Validate" →
+  ├── "Data Valid" → "Save" → "Success"
+  └── "Error" → "Show Errors" → "Fix Form"
 ```
 
-## Ссылки
+## Links
 
 - [SchemeOG Cloud](https://scheme.smartlaunchhub.com)
 - [GitLab](https://gitlab.com/serter2069/schemeog-cloud)

package/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * SchemeOG MCP Server v2.1
+ * SchemeOG MCP Server v2.2
  *
  * MCP сервер для работы со схемами, проектами и тегами в SchemeOG Cloud.
  *
@@ -114,11 +114,11 @@ async function apiRequest(endpoint, options = {}) {
     throw new Error(error.message);
   }
 
-  // Базовая валидация формата токена
-  if (!AUTH_TOKEN.startsWith("sk-") || AUTH_TOKEN.length < 20) {
+  // Базовая валидация формата токена (schog_ - новый формат)
+  if (!AUTH_TOKEN.startsWith("schog_") || AUTH_TOKEN.length < 20) {
     const error = createError(
       ErrorCodes.AUTH_INVALID,
-      `Неверный формат токена. Токен должен начинаться с "sk-" и содержать минимум 20 символов.\n\nПолучен: ${AUTH_TOKEN.substring(0, 10)}...`
+      `Неверный формат токена. Токен должен начинаться с "schog_" и содержать минимум 20 символов.\n\nПолучен: ${AUTH_TOKEN.substring(0, 10)}...`
     );
     throw new Error(error.message);
   }
@@ -209,18 +209,208 @@ function generateId() {
 }
 
 /**
- * Подготовить элементы — добавить ID если нет
+ * Допустимые именованные цвета для элементов
+ */
+const VALID_COLORS = ["white", "light_blue", "light_green", "light_yellow", "light_orange", "light_red", "light_purple", "light_gray", "light_pink", "light_teal"];
+
+/**
+ * Маппинг HEX цветов к именованным (ближайшее соответствие)
+ */
+const HEX_TO_NAMED_COLOR = {
+  // Белые/серые
+  "#FFFFFF": "white", "#FFF": "white", "#FAFAFA": "white", "#F5F5F5": "light_gray",
+  "#E0E0E0": "light_gray", "#BDBDBD": "light_gray", "#9E9E9E": "light_gray",
+  "#CFD8DC": "light_gray", "#ECEFF1": "light_gray",
+
+  // Синие
+  "#E3F2FD": "light_blue", "#BBDEFB": "light_blue", "#90CAF9": "light_blue",
+  "#64B5F6": "light_blue", "#42A5F5": "light_blue", "#2196F3": "light_blue",
+  "#1E88E5": "light_blue", "#1976D2": "light_blue",
+
+  // Зелёные
+  "#E8F5E9": "light_green", "#C8E6C9": "light_green", "#A5D6A7": "light_green",
+  "#81C784": "light_green", "#66BB6A": "light_green", "#4CAF50": "light_green",
+  "#43A047": "light_green", "#388E3C": "light_green", "#DCEDC8": "light_green",
+
+  // Жёлтые
+  "#FFFDE7": "light_yellow", "#FFF9C4": "light_yellow", "#FFF59D": "light_yellow",
+  "#FFF176": "light_yellow", "#FFEE58": "light_yellow", "#FFEB3B": "light_yellow",
+  "#FDD835": "light_yellow", "#FBC02D": "light_yellow",
+
+  // Оранжевые
+  "#FFF3E0": "light_orange", "#FFE0B2": "light_orange", "#FFCC80": "light_orange",
+  "#FFB74D": "light_orange", "#FFA726": "light_orange", "#FF9800": "light_orange",
+  "#FB8C00": "light_orange", "#F57C00": "light_orange",
+  "#FFE5B4": "light_orange", "#FFCCBC": "light_orange", // персиковые
+
+  // Красные
+  "#FFEBEE": "light_red", "#FFCDD2": "light_red", "#EF9A9A": "light_red",
+  "#E57373": "light_red", "#EF5350": "light_red", "#F44336": "light_red",
+  "#E53935": "light_red", "#D32F2F": "light_red",
+  "#FCE4EC": "light_pink", "#F8BBD0": "light_pink", // розовые → light_pink
+
+  // Фиолетовые
+  "#F3E5F5": "light_purple", "#E1BEE7": "light_purple", "#CE93D8": "light_purple",
+  "#BA68C8": "light_purple", "#AB47BC": "light_purple", "#9C27B0": "light_purple",
+  "#8E24AA": "light_purple", "#7B1FA2": "light_purple",
+  "#D1C4E9": "light_purple", "#EDE7F6": "light_purple",
+
+  // Розовые
+  "#FCE4EC": "light_pink", "#F8BBD0": "light_pink", "#F48FB1": "light_pink",
+  "#F06292": "light_pink", "#EC407A": "light_pink", "#E91E63": "light_pink",
+
+  // Бирюзовые/Teal
+  "#E0F7FA": "light_teal", "#B2DFDB": "light_teal", "#80CBC4": "light_teal",
+  "#4DB6AC": "light_teal", "#26A69A": "light_teal", "#009688": "light_teal",
+  "#E0F2F1": "light_teal",
+};
+
+/**
+ * Конвертировать HEX цвет в ближайший именованный
+ */
+function hexToNamedColor(hex) {
+  if (!hex) return "white";
+
+  // Если уже именованный — проверяем и возвращаем
+  if (VALID_COLORS.includes(hex)) return hex;
+
+  // Нормализуем HEX
+  const normalizedHex = hex.toUpperCase().trim();
+
+  // Ищем точное соответствие
+  if (HEX_TO_NAMED_COLOR[normalizedHex]) {
+    return HEX_TO_NAMED_COLOR[normalizedHex];
+  }
+
+  // Если не нашли — пытаемся определить по оттенку
+  // Простой алгоритм: анализируем RGB компоненты
+  const match = normalizedHex.match(/^#?([A-F0-9]{2})([A-F0-9]{2})([A-F0-9]{2})$/i);
+  if (match) {
+    const r = parseInt(match[1], 16);
+    const g = parseInt(match[2], 16);
+    const b = parseInt(match[3], 16);
+
+    // Определяем доминирующий цвет
+    const max = Math.max(r, g, b);
+    const min = Math.min(r, g, b);
+    const brightness = (r + g + b) / 3;
+
+    // Белый/серый
+    if (max - min < 30) {
+      return brightness > 200 ? "white" : "light_gray";
+    }
+
+    // Красный доминирует
+    if (r === max && r > g + 20 && r > b + 20) {
+      return g > 150 ? "light_orange" : (b > 100 ? "light_pink" : "light_red");
+    }
+
+    // Зелёный доминирует
+    if (g === max && g > r + 20 && g > b + 20) {
+      return b > 150 ? "light_teal" : "light_green";
+    }
+
+    // Синий доминирует
+    if (b === max && b > r + 20 && b > g + 20) {
+      return r > 150 ? "light_purple" : "light_blue";
+    }
+
+    // Жёлтый (R и G высокие, B низкий)
+    if (r > 200 && g > 200 && b < 150) {
+      return "light_yellow";
+    }
+
+    // Оранжевый (R высокий, G средний, B низкий)
+    if (r > 200 && g > 100 && g < 200 && b < 150) {
+      return "light_orange";
+    }
+  }
+
+  // Fallback
+  return "light_blue";
+}
+
+/**
+ * Нормализовать элементы — исправить типы, цвета, удалить лишние поля
+ * Возвращает { elements, warnings }
+ */
+function normalizeElements(elements) {
+  if (!elements || !Array.isArray(elements)) return { elements: [], warnings: [] };
+
+  const warnings = [];
+
+  const normalized = elements.map((el, index) => {
+    const fixed = {
+      id: el.id || generateId(),
+    };
+
+    // Тип: block/note → card
+    if (el.type === "block" || el.type === "note" || el.type === "group") {
+      fixed.type = "card";
+      warnings.push(`Элемент ${index + 1}: type "${el.type}" → "card"`);
+    } else if (el.type === "condition" || el.type === "diamond") {
+      fixed.type = "condition";
+    } else {
+      fixed.type = el.type || "card";
+    }
+
+    // Title: text → title
+    if (el.text && !el.title) {
+      fixed.title = el.text;
+      warnings.push(`Элемент ${index + 1}: "text" → "title"`);
+    } else {
+      fixed.title = el.title || "";
+    }
+
+    // Цвет: HEX → именованный
+    if (el.color) {
+      if (el.color.startsWith("#")) {
+        const namedColor = hexToNamedColor(el.color);
+        fixed.color = namedColor;
+        warnings.push(`Элемент ${index + 1}: color "${el.color}" → "${namedColor}"`);
+      } else if (VALID_COLORS.includes(el.color)) {
+        fixed.color = el.color;
+      } else {
+        fixed.color = "white";
+        warnings.push(`Элемент ${index + 1}: неизвестный color "${el.color}" → "white"`);
+      }
+    } else {
+      fixed.color = "white";
+    }
+
+    // borderColor — оставляем если валидный
+    const validBorderColors = ["default", "blue", "green", "orange", "purple", "red", "teal", "yellow", "gray", "black"];
+    if (el.borderColor && validBorderColors.includes(el.borderColor)) {
+      fixed.borderColor = el.borderColor;
+    }
+
+    // Description
+    if (el.description) {
+      fixed.description = el.description;
+    }
+
+    // Tags
+    if (el.tags && Array.isArray(el.tags)) {
+      fixed.tags = el.tags;
+    }
+
+    // НЕ копируем: x, y, width, height — они автоматические
+    if (el.x !== undefined || el.y !== undefined || el.width !== undefined || el.height !== undefined) {
+      warnings.push(`Элемент ${index + 1}: x/y/width/height удалены (рассчитываются автоматически)`);
+    }
+
+    return fixed;
+  });
+
+  return { elements: normalized, warnings };
+}
+
+/**
+ * Подготовить элементы — нормализовать и добавить ID
+ * Возвращает { elements, warnings }
  */
 function prepareElements(elements) {
-  if (!elements) return [];
-  return elements.map(el => ({
-    id: el.id || generateId(),
-    type: el.type || "block",
-    x: el.x || 0,
-    y: el.y || 0,
-    text: el.text || "",
-    ...el
-  }));
+  return normalizeElements(elements);
 }
 
 /**
@@ -259,11 +449,22 @@ const TOOLS = [
 Возвращает:
 - name: название схемы
 - description: описание
-- elements: массив элементов (блоки, заметки, группы)
+- elements: массив элементов (card или condition)
 - connections: массив связей между элементами
+- tagsDictionary: справочник тегов
+
+Формат элемента:
+{
+  "id": "unique_id",
+  "type": "card",           // card или condition
+  "title": "Название",      // заголовок
+  "color": "light_blue",    // ТОЛЬКО: white, light_blue, light_green, light_yellow, light_orange, light_red, light_purple, light_gray, light_pink, light_teal
+  "description": "Текст",   // описание
+  "tags": ["тег1"]          // массив тегов
+}
 
-Каждый элемент содержит: id, type, x, y, text, width, height, color
-Каждая связь содержит: id, from, to, label, style`,
+ВАЖНО: НЕ используй x, y, width, height — они рассчитываются автоматически!
+ВАЖНО: Цвета ТОЛЬКО именованные (light_blue), НЕ HEX (#FFFFFF)!`,
     inputSchema: {
       type: "object",
       properties: {
@@ -837,12 +1038,15 @@ ${JSON.stringify(schema.data?.connections || [], null, 2)}`,
     }
 
     case "create_schema": {
-      const { name, description, project_id, elements, connections } = args;
+      const { name, description, project_id, elements, connections, tagsDictionary } = args;
+
+      // Нормализуем элементы и получаем предупреждения
+      const { elements: normalizedElements, warnings } = prepareElements(elements);
 
       const data = {
-        elements: prepareElements(elements),
+        elements: normalizedElements,
         connections: prepareConnections(connections),
-        tagsDictionary: [],
+        tagsDictionary: tagsDictionary || [],
       };
 
       const result = await apiRequest("/schemas", {
@@ -852,6 +1056,16 @@ ${JSON.stringify(schema.data?.connections || [], null, 2)}`,
 
       const projectInfo = project_id ? `Проект: ${project_id}` : 'Проект: Общие';
 
+      // Формируем сообщение о предупреждениях
+      let warningsText = "";
+      if (warnings.length > 0) {
+        warningsText = `\n\n⚠️ Автоисправления (${warnings.length}):\n• ${warnings.slice(0, 10).join("\n• ")}`;
+        if (warnings.length > 10) {
+          warningsText += `\n• ...и ещё ${warnings.length - 10}`;
+        }
+        warningsText += `\n\n💡 Подсказка: используй type "card"/"condition", цвета light_blue/light_green/etc, НЕ указывай x/y/width/height`;
+      }
+
       return {
         content: [{
           type: "text",
@@ -864,7 +1078,7 @@ ${projectInfo}
 
 URL: ${API_BASE_URL}/canvas?id=${result.schema.id}
 
-Открой ссылку в браузере чтобы увидеть схему.`,
+Открой ссылку в браузере чтобы увидеть схему.${warningsText}`,
         }],
       };
     }
@@ -879,6 +1093,7 @@ URL: ${API_BASE_URL}/canvas?id=${result.schema.id}
 
       // Формируем обновление
       const updateBody = {};
+      let warnings = [];
 
       if (name) updateBody.name = name;
       if (description !== undefined) updateBody.description = description;
@@ -886,7 +1101,9 @@ URL: ${API_BASE_URL}/canvas?id=${result.schema.id}
       // Обновляем данные только если переданы
       const newData = { ...currentData };
       if (elements !== undefined) {
-        newData.elements = prepareElements(elements);
+        const normalized = prepareElements(elements);
+        newData.elements = normalized.elements;
+        warnings = normalized.warnings;
       }
       if (connections !== undefined) {
         newData.connections = prepareConnections(connections);
@@ -898,6 +1115,16 @@ URL: ${API_BASE_URL}/canvas?id=${result.schema.id}
         body: JSON.stringify(updateBody),
       });
 
+      // Формируем сообщение о предупреждениях
+      let warningsText = "";
+      if (warnings.length > 0) {
+        warningsText = `\n\n⚠️ Автоисправления (${warnings.length}):\n• ${warnings.slice(0, 10).join("\n• ")}`;
+        if (warnings.length > 10) {
+          warningsText += `\n• ...и ещё ${warnings.length - 10}`;
+        }
+        warningsText += `\n\n💡 Подсказка: используй type "card"/"condition", цвета light_blue/light_green/etc, НЕ указывай x/y/width/height`;
+      }
+
       return {
         content: [{
           type: "text",
@@ -906,7 +1133,7 @@ URL: ${API_BASE_URL}/canvas?id=${result.schema.id}
 Элементов: ${result.schema.data?.elements?.length || 0}
 Связей: ${result.schema.data?.connections?.length || 0}
 
-URL: ${API_BASE_URL}/canvas?id=${schema_id}`,
+URL: ${API_BASE_URL}/canvas?id=${schema_id}${warningsText}`,
         }],
       };
     }
@@ -1192,16 +1419,16 @@ async function main() {
 2. Добавьте в настройки MCP:
 
    "env": {
-     "SCHEMEOG_TOKEN": "sk-ваш-токен"
+     "SCHEMEOG_TOKEN": "schog_ваш-токен"
    }
 
 Документация: ${DOCS_URL}
 `);
-  } else if (!AUTH_TOKEN.startsWith("sk-")) {
+  } else if (!AUTH_TOKEN.startsWith("schog_")) {
     console.error(`
 ⚠️  Неверный формат токена!
 
-Токен должен начинаться с "sk-".
+Токен должен начинаться с "schog_".
 Получен: ${AUTH_TOKEN.substring(0, 10)}...
 
 Создайте новый токен: ${PROFILE_URL}
@@ -1211,7 +1438,7 @@ async function main() {
   const server = new Server(
     {
       name: "schemeog-mcp",
-      version: "2.1.0",
+      version: "2.3.0",
     },
     {
       capabilities: {
@@ -1241,7 +1468,7 @@ async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
 
-  console.error("SchemeOG MCP Server v2.1 запущен");
+  console.error("SchemeOG MCP Server v2.3 запущен");
 }
 
 main().catch(console.error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "schemeog-mcp",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "MCP Server for SchemeOG Cloud - Create and manage visual diagrams and flowcharts with AI assistance",
   "type": "module",
   "main": "index.js",