schemeog-mcp 2.0.0 → 2.2.1

package/README.md

@@ -1,129 +1,221 @@
-# SchemeOG MCP Server v2.0
+# 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.
 
-## 5 команд — всё что нужно
+## 14 Commands
 
-| Команда | Описание |
-|---------|----------|
-| `list_schemas` | Список всех схем |
-| `get_schema` | Получить схему с данными |
-| `create_schema` | Создать новую схему |
-| `replace_schema` | Заменить содержимое схемы |
-| `delete_schema` | Удалить схему |
+### Schemas (5 commands)
 
-## Установка
+| 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 |
 
-### Через npx (рекомендуется)
+### Projects (5 commands)
+
+| 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 |
+
+### Tags (4 commands)
+
+| 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
+
+### Via npx (recommended)
 
 ```bash
-npx schemeog-cloud-mcp
+npx schemeog-mcp
 ```
 
-## Настройка
+## Setup
 
-### 1. Получи токен
+### 1. Get your token
 
-1. Открой https://scheme.smartlaunchhub.com
-2. Войди по email
-3. DevTools (F12) → Application → Local Storage
-4. Скопируй значение `token`
+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
 {
   "mcpServers": {
     "schemeog": {
       "command": "npx",
-      "args": ["-y", "schemeog-cloud-mcp"],
+      "args": ["-y", "schemeog-mcp"],
       "env": {
-        "SCHEMEOG_TOKEN": "твой-jwt-токен"
+        "SCHEMEOG_TOKEN": "schog_xxxxx..."
       }
     }
   }
 }
 ```
 
-## Примеры использования
-
-### Создать схему
-
-```
-Создай схему "User Registration Flow" с блоками:
-- Форма регистрации
-- Валидация
-- Сохранение в БД
-- Отправка email
-- Успех
-```
+## Schema Data Format
 
-AI сгенерирует:
+### Full schema example
 
 ```json
 {
   "name": "User Registration Flow",
+  "description": "User registration process",
   "elements": [
-    {"id": "1", "type": "block", "x": 100, "y": 100, "text": "Форма регистрации"},
-    {"id": "2", "type": "block", "x": 300, "y": 100, "text": "Валидация"},
-    {"id": "3", "type": "block", "x": 500, "y": 100, "text": "Сохранение в БД"},
-    {"id": "4", "type": "block", "x": 700, "y": 100, "text": "Отправка email"},
-    {"id": "5", "type": "block", "x": 900, "y": 100, "text": "Успех"}
+    {
+      "id": "start",
+      "type": "card",
+      "title": "Registration Form",
+      "color": "light_green",
+      "tags": ["user"],
+      "description": "User fills in email and password"
+    },
+    {
+      "id": "validate",
+      "type": "condition",
+      "title": "Validate Data",
+      "color": "light_yellow",
+      "tags": ["system", "check"],
+      "description": "Check email format and password strength"
+    },
+    {
+      "id": "save",
+      "type": "card",
+      "title": "Save to Database",
+      "color": "light_blue",
+      "tags": ["system"],
+      "description": "Create user record in database"
+    },
+    {
+      "id": "error",
+      "type": "card",
+      "title": "Validation Error",
+      "color": "light_red",
+      "tags": ["system", "error"],
+      "description": "Show validation errors to user"
+    },
+    {
+      "id": "success",
+      "type": "card",
+      "title": "Registration Complete",
+      "color": "light_green",
+      "tags": ["user"],
+      "description": "User successfully registered"
+    }
   ],
   "connections": [
-    {"from": "1", "to": "2"},
-    {"from": "2", "to": "3"},
-    {"from": "3", "to": "4"},
-    {"from": "4", "to": "5"}
+    {"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": "retry"}
+  ],
+  "tagsDictionary": [
+    {"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"}
   ]
 }
 ```
 
-### Обновить схему
+### Element (card or condition)
 
-```
-Добавь в схему блок "Обработка ошибок" после валидации
+```json
+{
+  "id": "unique_id",
+  "type": "card",
+  "title": "Card Title",
+  "color": "light_blue",
+  "tags": ["tag1", "tag2"],
+  "description": "Detailed description of the action or process"
+}
 ```
 
-AI получит текущую схему, добавит блок и связи, отправит обновление.
+**Element types:**
+- `card` — regular process/action card
+- `condition` — decision point (diamond shape)
 
-### Посмотреть схемы
+**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 |
 
-```
-Покажи мои схемы
-```
+**Border colors (`borderColor`):** `default`, `blue`, `green`, `orange`, `purple`, `red`, `teal`, `yellow`, `gray`, `black`
 
-## Формат данных
+**Important:** Do NOT specify `width`, `height`, `x`, `y` — they are calculated automatically!
 
-### Элемент
+### Connection
 
 ```json
 {
-  "id": "unique_id",
-  "type": "block",       // block, note, group
-  "x": 100,              // X координата
-  "y": 100,              // Y координата
-  "text": "Текст",       // содержимое
-  "width": 200,          // ширина (опционально)
-  "height": 100,         // высота (опционально)
-  "color": "#E3F2FD"     // цвет фона (опционально)
+  "from": "source_id",
+  "to": "target_id",
+  "label": "optional label",
+  "style": "solid"
 }
 ```
 
-### Связь
+**Line styles (`style`):** `solid`, `dashed`, `dotted`
+
+### Tags Dictionary (tagsDictionary)
 
 ```json
 {
-  "from": "id1",         // ID источника
-  "to": "id2",           // ID назначения
-  "label": "текст",      // подпись (опционально)
-  "style": "solid"       // solid, dashed, dotted
+  "tagsDictionary": [
+    {"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. 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:**
+```
+"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,17 +1,29 @@
 #!/usr/bin/env node
 
 /**
- * SchemeOG Cloud MCP Server v2.0
+ * SchemeOG MCP Server v2.2
  *
- * Минималистичный MCP сервер для работы со схемами.
- * 5 команд — максимум мощи, минимум сложности.
+ * MCP сервер для работы со схемами, проектами и тегами в SchemeOG Cloud.
  *
- * Команды:
+ * Команды для схем:
  * - list_schemas: Список всех схем
  * - get_schema: Получить схему с данными
  * - create_schema: Создать схему (с элементами и связями)
  * - replace_schema: Полностью заменить содержимое схемы
  * - delete_schema: Удалить схему
+ *
+ * Команды для проектов:
+ * - list_projects: Список проектов (папок)
+ * - create_project: Создать проект
+ * - update_project: Обновить проект
+ * - delete_project: Удалить проект
+ * - move_schema_to_project: Переместить схему в проект
+ *
+ * Команды для тегов:
+ * - list_tags: Список тегов схемы
+ * - add_tag: Добавить тег в схему
+ * - remove_tag: Удалить тег из схемы
+ * - tag_element: Присвоить/убрать тег с элемента
  */
 
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -24,16 +36,98 @@ import {
 // Конфигурация
 const API_BASE_URL = process.env.SCHEMEOG_API_URL || "https://scheme.smartlaunchhub.com";
 const AUTH_TOKEN = process.env.SCHEMEOG_TOKEN || "";
+const DOCS_URL = "https://scheme.smartlaunchhub.com/docs";
+const PROFILE_URL = "https://scheme.smartlaunchhub.com/profile";
+
+/**
+ * Коды ошибок MCP
+ */
+const ErrorCodes = {
+  AUTH_MISSING: "AUTH_MISSING",
+  AUTH_INVALID: "AUTH_INVALID",
+  AUTH_EXPIRED: "AUTH_EXPIRED",
+  NOT_FOUND: "NOT_FOUND",
+  VALIDATION_ERROR: "VALIDATION_ERROR",
+  RATE_LIMIT: "RATE_LIMIT",
+  SERVER_ERROR: "SERVER_ERROR",
+  NETWORK_ERROR: "NETWORK_ERROR",
+};
+
+/**
+ * Создать форматированную ошибку
+ */
+function createError(code, message, details = {}) {
+  const errorMessages = {
+    [ErrorCodes.AUTH_MISSING]: {
+      title: "🔑 Токен не указан",
+      hint: `Укажите SCHEMEOG_TOKEN в настройках MCP.\n\nПолучить токен: ${PROFILE_URL}\nДокументация: ${DOCS_URL}`,
+    },
+    [ErrorCodes.AUTH_INVALID]: {
+      title: "🔒 Неверный токен",
+      hint: `Токен невалидный или отозван.\n\nСоздайте новый токен: ${PROFILE_URL}`,
+    },
+    [ErrorCodes.AUTH_EXPIRED]: {
+      title: "⏰ Токен истёк",
+      hint: `Срок действия токена истёк.\n\nСоздайте новый токен: ${PROFILE_URL}`,
+    },
+    [ErrorCodes.NOT_FOUND]: {
+      title: "🔍 Не найдено",
+      hint: `Проверьте правильность ID.\n\nСписок схем: list_schemas\nСписок проектов: list_projects`,
+    },
+    [ErrorCodes.VALIDATION_ERROR]: {
+      title: "⚠️ Ошибка валидации",
+      hint: `Проверьте формат данных.\n\nДокументация: ${DOCS_URL}`,
+    },
+    [ErrorCodes.RATE_LIMIT]: {
+      title: "🚫 Превышен лимит запросов",
+      hint: "Подождите немного и повторите запрос.",
+    },
+    [ErrorCodes.SERVER_ERROR]: {
+      title: "💥 Ошибка сервера",
+      hint: `Попробуйте позже или обратитесь в поддержку.\n\nСтатус: ${API_BASE_URL}/status`,
+    },
+    [ErrorCodes.NETWORK_ERROR]: {
+      title: "🌐 Ошибка сети",
+      hint: "Проверьте подключение к интернету.",
+    },
+  };
+
+  const errorInfo = errorMessages[code] || { title: "Ошибка", hint: "" };
+
+  return {
+    code,
+    message: `${errorInfo.title}\n\n${message}${errorInfo.hint ? `\n\n${errorInfo.hint}` : ""}`,
+    details,
+  };
+}
 
 /**
  * Выполнить запрос к API SchemeOG
  */
 async function apiRequest(endpoint, options = {}) {
+  // Проверка токена перед запросом
+  if (!AUTH_TOKEN) {
+    const error = createError(
+      ErrorCodes.AUTH_MISSING,
+      "Переменная окружения SCHEMEOG_TOKEN не установлена."
+    );
+    throw new Error(error.message);
+  }
+
+  // Базовая валидация формата токена (schog_ - новый формат)
+  if (!AUTH_TOKEN.startsWith("schog_") || AUTH_TOKEN.length < 20) {
+    const error = createError(
+      ErrorCodes.AUTH_INVALID,
+      `Неверный формат токена. Токен должен начинаться с "schog_" и содержать минимум 20 символов.\n\nПолучен: ${AUTH_TOKEN.substring(0, 10)}...`
+    );
+    throw new Error(error.message);
+  }
+
   const url = `${API_BASE_URL}/api${endpoint}`;
 
   const headers = {
     "Content-Type": "application/json",
-    ...(AUTH_TOKEN && { "Authorization": `Bearer ${AUTH_TOKEN}` }),
+    "Authorization": `Bearer ${AUTH_TOKEN}`,
     ...options.headers,
   };
 
@@ -43,15 +137,67 @@ async function apiRequest(endpoint, options = {}) {
       headers,
     });
 
-    const data = await response.json();
+    // Попробуем распарсить JSON
+    let data;
+    try {
+      data = await response.json();
+    } catch {
+      data = { error: "Invalid JSON response" };
+    }
 
     if (!response.ok) {
-      throw new Error(data.message || data.error || `HTTP ${response.status}`);
+      // Определяем тип ошибки по статусу
+      let errorCode;
+      let errorMessage = data.message || data.error || `HTTP ${response.status}`;
+
+      switch (response.status) {
+        case 401:
+          errorCode = ErrorCodes.AUTH_INVALID;
+          errorMessage = "Токен отклонён сервером. Возможно, он отозван или недействителен.";
+          break;
+        case 403:
+          errorCode = ErrorCodes.AUTH_EXPIRED;
+          errorMessage = "Доступ запрещён. Проверьте права токена.";
+          break;
+        case 404:
+          errorCode = ErrorCodes.NOT_FOUND;
+          errorMessage = data.message || "Ресурс не найден. Проверьте ID схемы или проекта.";
+          break;
+        case 422:
+          errorCode = ErrorCodes.VALIDATION_ERROR;
+          errorMessage = data.message || "Неверный формат данных.";
+          if (data.errors) {
+            errorMessage += "\n\nДетали:\n" + JSON.stringify(data.errors, null, 2);
+          }
+          break;
+        case 429:
+          errorCode = ErrorCodes.RATE_LIMIT;
+          errorMessage = "Слишком много запросов.";
+          break;
+        default:
+          errorCode = response.status >= 500 ? ErrorCodes.SERVER_ERROR : ErrorCodes.VALIDATION_ERROR;
+      }
+
+      const error = createError(errorCode, errorMessage);
+      throw new Error(error.message);
     }
 
     return data;
   } catch (error) {
-    throw new Error(`API Error: ${error.message}`);
+    // Если это уже наша форматированная ошибка — пробрасываем
+    if (error.message.includes("🔑") || error.message.includes("🔒") ||
+        error.message.includes("🔍") || error.message.includes("⚠️") ||
+        error.message.includes("🚫") || error.message.includes("💥") ||
+        error.message.includes("🌐") || error.message.includes("⏰")) {
+      throw error;
+    }
+
+    // Ошибка сети
+    const networkError = createError(
+      ErrorCodes.NETWORK_ERROR,
+      `Не удалось подключиться к ${API_BASE_URL}\n\nДетали: ${error.message}`
+    );
+    throw new Error(networkError.message);
   }
 }
 
@@ -69,10 +215,7 @@ 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 || "",
+    type: el.type || "card",
     ...el
   }));
 }
@@ -89,14 +232,15 @@ function prepareConnections(connections) {
 }
 
 /**
- * 5 основных инструментов MCP
+ * Инструменты MCP
  */
 const TOOLS = [
+  // ========== СХЕМЫ ==========
   {
     name: "list_schemas",
     description: `Получить список всех схем пользователя.
 
-Возвращает: ID, название, описание, дату обновления каждой схемы.
+Возвращает: ID, название, описание, проект, дату обновления каждой схемы.
 
 Используй эту команду чтобы узнать какие схемы есть у пользователя.`,
     inputSchema: {
@@ -132,45 +276,63 @@ const TOOLS = [
     name: "create_schema",
     description: `Создать новую схему с элементами и связями.
 
-ВАЖНО: Генерируй сразу полную схему с elements и connections!
+ВАЖНО: Генерируй сразу полную схему с elements, connections и tagsDictionary!
 
 Параметры:
 - name: название схемы (обязательно)
 - description: описание
+- project_id: ID проекта (опционально)
 - elements: массив элементов
 - connections: массив связей
+- tagsDictionary: справочник тегов (опционально)
 
 Формат элемента:
 {
-  "id": "node1",           // уникальный ID (можно не указывать - сгенерируется)
-  "type": "block",         // block, note, group
-  "x": 100,                // координата X
-  "y": 100,                // координата Y
-  "text": "Текст блока",   // текст внутри
-  "width": 200,            // ширина (опционально)
-  "height": 100,           // высота (опционально)
-  "color": "#E3F2FD"       // цвет фона (опционально)
+  "id": "unique_id",       // уникальный 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
+  "borderColor": "blue",   // цвет обводки: default, blue, green, orange, purple, red, teal, yellow, gray, black
+  "tags": ["тег1"],        // массив названий тегов (опционально)
+  "description": "Описание процесса"  // подробное описание (опционально)
 }
 
+НЕ указывай x, y, width, height - рассчитываются автоматически!
+
 Формат связи:
 {
-  "from": "node1",         // ID элемента-источника
-  "to": "node2",           // ID элемента-назначения
+  "from": "source_id",     // ID элемента-источника
+  "to": "target_id",       // ID элемента-назначения
   "label": "подпись",      // текст на связи (опционально)
   "style": "solid"         // solid, dashed, dotted (опционально)
 }
 
-Пример: создать схему с 3 блоками и 2 связями:
+Формат тега (tagsDictionary):
 {
-  "name": "User Flow",
+  "id": "tag-1",           // уникальный ID тега
+  "name": "система",       // название тега (роль/актор)
+  "color": "#2196F3"       // цвет в HEX
+}
+
+Пример: создать схему регистрации:
+{
+  "name": "User Registration",
   "elements": [
-    {"id": "1", "type": "block", "x": 100, "y": 100, "text": "Login"},
-    {"id": "2", "type": "block", "x": 300, "y": 100, "text": "Dashboard"},
-    {"id": "3", "type": "block", "x": 500, "y": 100, "text": "Settings"}
+    {"id": "start", "type": "card", "title": "Форма регистрации", "color": "light_green", "tags": ["пользователь"]},
+    {"id": "validate", "type": "condition", "title": "Валидация", "color": "light_yellow", "tags": ["система"]},
+    {"id": "save", "type": "card", "title": "Сохранение в БД", "color": "light_blue", "tags": ["система"]},
+    {"id": "error", "type": "card", "title": "Ошибка", "color": "light_red", "tags": ["система"]},
+    {"id": "success", "type": "card", "title": "Успех", "color": "light_green", "tags": ["пользователь"]}
   ],
   "connections": [
-    {"from": "1", "to": "2", "label": "success"},
-    {"from": "2", "to": "3"}
+    {"from": "start", "to": "validate"},
+    {"from": "validate", "to": "save", "label": "OK"},
+    {"from": "validate", "to": "error", "label": "ошибка"},
+    {"from": "save", "to": "success"}
+  ],
+  "tagsDictionary": [
+    {"id": "tag-user", "name": "пользователь", "color": "#4CAF50"},
+    {"id": "tag-system", "name": "система", "color": "#2196F3"}
   ]
 }`,
     inputSchema: {
@@ -184,6 +346,10 @@ const TOOLS = [
           type: "string",
           description: "Описание схемы",
         },
+        project_id: {
+          type: "string",
+          description: "ID проекта для размещения схемы (опционально)",
+        },
         elements: {
           type: "array",
           description: "Массив элементов схемы",
@@ -191,13 +357,12 @@ const TOOLS = [
             type: "object",
             properties: {
               id: { type: "string" },
-              type: { type: "string", enum: ["block", "note", "group"] },
-              x: { type: "number" },
-              y: { type: "number" },
-              text: { type: "string" },
-              width: { type: "number" },
-              height: { type: "number" },
-              color: { type: "string" },
+              type: { type: "string", enum: ["card", "condition"] },
+              title: { type: "string" },
+              color: { type: "string", enum: ["white", "light_blue", "light_green", "light_yellow", "light_orange", "light_red", "light_purple", "light_gray", "light_pink", "light_teal"] },
+              borderColor: { type: "string", enum: ["default", "blue", "green", "orange", "purple", "red", "teal", "yellow", "gray", "black"] },
+              tags: { type: "array", items: { type: "string" } },
+              description: { type: "string" },
             },
           },
         },
@@ -215,6 +380,18 @@ const TOOLS = [
             required: ["from", "to"],
           },
         },
+        tagsDictionary: {
+          type: "array",
+          description: "Справочник тегов схемы",
+          items: {
+            type: "object",
+            properties: {
+              id: { type: "string" },
+              name: { type: "string" },
+              color: { type: "string" },
+            },
+          },
+        },
       },
       required: ["name"],
     },
@@ -285,14 +462,319 @@ const TOOLS = [
       required: ["schema_id"],
     },
   },
+
+  // ========== ПРОЕКТЫ ==========
+  {
+    name: "list_projects",
+    description: `Получить список всех проектов пользователя.
+
+Проекты - это папки для группировки схем.
+Возвращает: ID, название, описание, цвет, иконку и количество схем в каждом проекте.`,
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: "create_project",
+    description: `Создать новый проект (папку для схем).
+
+Параметры:
+- name: название проекта (обязательно)
+- description: описание проекта
+- color: цвет в формате HEX (например #FF5733)
+- icon: emoji иконка (например 📁, 🚀, 💡)`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: {
+          type: "string",
+          description: "Название проекта",
+        },
+        description: {
+          type: "string",
+          description: "Описание проекта",
+        },
+        color: {
+          type: "string",
+          description: "Цвет проекта в формате HEX",
+        },
+        icon: {
+          type: "string",
+          description: "Emoji иконка проекта",
+        },
+      },
+      required: ["name"],
+    },
+  },
+  {
+    name: "delete_project",
+    description: `Удалить проект.
+
+ВАЖНО: Схемы внутри проекта НЕ удаляются - они перемещаются в раздел "Общие".`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: {
+          type: "string",
+          description: "ID проекта для удаления",
+        },
+      },
+      required: ["project_id"],
+    },
+  },
+  {
+    name: "move_schema_to_project",
+    description: `Переместить схему в проект или убрать из проекта.
+
+Параметры:
+- schema_id: ID схемы (обязательно)
+- project_id: ID проекта. Если не указан или null - схема перемещается в "Общие" (без проекта)`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        schema_id: {
+          type: "string",
+          description: "ID схемы",
+        },
+        project_id: {
+          type: "string",
+          description: "ID проекта (или null для перемещения в Общие)",
+        },
+      },
+      required: ["schema_id"],
+    },
+  },
+  {
+    name: "update_project",
+    description: `Обновить проект - изменить название, описание, цвет или иконку.
+
+Параметры:
+- project_id: ID проекта (обязательно)
+- name: новое название
+- description: новое описание
+- color: новый цвет в формате HEX
+- icon: новая emoji иконка`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        project_id: {
+          type: "string",
+          description: "ID проекта",
+        },
+        name: {
+          type: "string",
+          description: "Новое название проекта",
+        },
+        description: {
+          type: "string",
+          description: "Новое описание проекта",
+        },
+        color: {
+          type: "string",
+          description: "Новый цвет проекта в формате HEX",
+        },
+        icon: {
+          type: "string",
+          description: "Новая emoji иконка проекта",
+        },
+      },
+      required: ["project_id"],
+    },
+  },
+
+  // ========== ТЕГИ ==========
+  {
+    name: "add_tag",
+    description: `Добавить новый тег в схему.
+
+Теги используются для категоризации элементов схемы.
+
+Параметры:
+- schema_id: ID схемы (обязательно)
+- name: название тега (обязательно)
+- color: цвет тега в формате HEX (например #4CAF50)`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        schema_id: {
+          type: "string",
+          description: "ID схемы",
+        },
+        name: {
+          type: "string",
+          description: "Название тега",
+        },
+        color: {
+          type: "string",
+          description: "Цвет тега в формате HEX",
+        },
+      },
+      required: ["schema_id", "name"],
+    },
+  },
+  {
+    name: "remove_tag",
+    description: `Удалить тег из схемы.
+
+Тег будет удалён из tagsDictionary и убран со всех элементов.
+
+Параметры:
+- schema_id: ID схемы (обязательно)
+- tag_id: ID тега для удаления (обязательно)`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        schema_id: {
+          type: "string",
+          description: "ID схемы",
+        },
+        tag_id: {
+          type: "string",
+          description: "ID тега для удаления",
+        },
+      },
+      required: ["schema_id", "tag_id"],
+    },
+  },
+  {
+    name: "tag_element",
+    description: `Присвоить или убрать тег с элемента.
+
+Параметры:
+- schema_id: ID схемы (обязательно)
+- element_id: ID элемента (обязательно)
+- tag_id: ID тега (обязательно)
+- action: "add" или "remove" (по умолчанию "add")`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        schema_id: {
+          type: "string",
+          description: "ID схемы",
+        },
+        element_id: {
+          type: "string",
+          description: "ID элемента",
+        },
+        tag_id: {
+          type: "string",
+          description: "ID тега",
+        },
+        action: {
+          type: "string",
+          enum: ["add", "remove"],
+          description: "Действие: add (добавить) или remove (убрать)",
+        },
+      },
+      required: ["schema_id", "element_id", "tag_id"],
+    },
+  },
+  {
+    name: "list_tags",
+    description: `Получить список всех тегов схемы.
+
+Параметры:
+- schema_id: ID схемы (обязательно)`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        schema_id: {
+          type: "string",
+          description: "ID схемы",
+        },
+      },
+      required: ["schema_id"],
+    },
+  },
 ];
 
+/**
+ * Валидация UUID формата
+ */
+function isValidUUID(str) {
+  if (!str || typeof str !== "string") return false;
+  // Принимаем разные форматы ID: UUID и cuid
+  return /^[a-zA-Z0-9_-]{10,}$/.test(str);
+}
+
+/**
+ * Валидация параметров команды
+ */
+function validateArgs(name, args) {
+  const errors = [];
+
+  // Валидация schema_id
+  if (["get_schema", "replace_schema", "delete_schema", "add_tag", "remove_tag", "tag_element", "list_tags"].includes(name)) {
+    if (!args.schema_id) {
+      errors.push("schema_id — обязательный параметр");
+    } else if (!isValidUUID(args.schema_id)) {
+      errors.push(`schema_id "${args.schema_id}" — неверный формат. Используйте ID из list_schemas`);
+    }
+  }
+
+  // Валидация project_id
+  if (["delete_project", "update_project"].includes(name)) {
+    if (!args.project_id) {
+      errors.push("project_id — обязательный параметр");
+    } else if (!isValidUUID(args.project_id)) {
+      errors.push(`project_id "${args.project_id}" — неверный формат. Используйте ID из list_projects`);
+    }
+  }
+
+  // Валидация name для создания
+  if (["create_schema", "create_project"].includes(name)) {
+    if (!args.name || typeof args.name !== "string" || args.name.trim().length === 0) {
+      errors.push("name — обязательный параметр (название)");
+    } else if (args.name.length > 100) {
+      errors.push("name — слишком длинное название (макс. 100 символов)");
+    }
+  }
+
+  // Валидация тегов
+  if (name === "add_tag") {
+    if (!args.name || typeof args.name !== "string") {
+      errors.push("name — обязательный параметр (название тега)");
+    }
+  }
+
+  if (name === "remove_tag" || name === "tag_element") {
+    if (!args.tag_id) {
+      errors.push("tag_id — обязательный параметр");
+    }
+  }
+
+  if (name === "tag_element") {
+    if (!args.element_id) {
+      errors.push("element_id — обязательный параметр");
+    }
+  }
+
+  // Валидация цвета
+  if (args.color && !/^#[0-9A-Fa-f]{6}$/.test(args.color)) {
+    errors.push(`color "${args.color}" — неверный формат. Используйте HEX: #RRGGBB (например #4CAF50)`);
+  }
+
+  return errors;
+}
+
 /**
  * Обработчики инструментов
  */
 async function handleTool(name, args) {
+  // Валидация параметров
+  const validationErrors = validateArgs(name, args);
+  if (validationErrors.length > 0) {
+    const error = createError(
+      ErrorCodes.VALIDATION_ERROR,
+      `Ошибки в параметрах:\n\n• ${validationErrors.join("\n• ")}`
+    );
+    throw new Error(error.message);
+  }
+
   switch (name) {
-    // ========== LIST SCHEMAS ==========
+    // ========== СХЕМЫ ==========
     case "list_schemas": {
       const result = await apiRequest("/schemas");
 
@@ -309,6 +791,8 @@ async function handleTool(name, args) {
         id: s.id,
         name: s.name,
         description: s.description || "",
+        projectId: s.projectId || null,
+        projectName: s.project?.name || "Общие",
         updatedAt: s.updatedAt,
         elementsCount: s.data?.elements?.length || 0,
         connectionsCount: s.data?.connections?.length || 0,
@@ -322,7 +806,6 @@ async function handleTool(name, args) {
       };
     }
 
-    // ========== GET SCHEMA ==========
     case "get_schema": {
       const { schema_id } = args;
       const result = await apiRequest(`/schemas/${schema_id}`);
@@ -336,6 +819,7 @@ async function handleTool(name, args) {
 
 ID: ${schema.id}
 Описание: ${schema.description || "(нет)"}
+Проект: ${schema.project?.name || "Общие"}
 Элементов: ${schema.data?.elements?.length || 0}
 Связей: ${schema.data?.connections?.length || 0}
 URL: ${API_BASE_URL}/canvas?id=${schema.id}
@@ -349,9 +833,8 @@ ${JSON.stringify(schema.data?.connections || [], null, 2)}`,
       };
     }
 
-    // ========== CREATE SCHEMA ==========
     case "create_schema": {
-      const { name, description, elements, connections } = args;
+      const { name, description, project_id, elements, connections } = args;
 
       const data = {
         elements: prepareElements(elements),
@@ -361,15 +844,18 @@ ${JSON.stringify(schema.data?.connections || [], null, 2)}`,
 
       const result = await apiRequest("/schemas", {
         method: "POST",
-        body: JSON.stringify({ name, description, data }),
+        body: JSON.stringify({ name, description, data, projectId: project_id }),
       });
 
+      const projectInfo = project_id ? `Проект: ${project_id}` : 'Проект: Общие';
+
       return {
         content: [{
           type: "text",
           text: `Схема "${result.schema.name}" создана!
 
 ID: ${result.schema.id}
+${projectInfo}
 Элементов: ${data.elements.length}
 Связей: ${data.connections.length}
 
@@ -380,7 +866,6 @@ URL: ${API_BASE_URL}/canvas?id=${result.schema.id}
       };
     }
 
-    // ========== REPLACE SCHEMA ==========
     case "replace_schema": {
       const { schema_id, name, description, elements, connections } = args;
 
@@ -423,7 +908,6 @@ URL: ${API_BASE_URL}/canvas?id=${schema_id}`,
       };
     }
 
-    // ========== DELETE SCHEMA ==========
     case "delete_schema": {
       const { schema_id } = args;
 
@@ -439,6 +923,253 @@ URL: ${API_BASE_URL}/canvas?id=${schema_id}`,
       };
     }
 
+    // ========== ПРОЕКТЫ ==========
+    case "list_projects": {
+      const result = await apiRequest("/projects");
+
+      if (!result.projects || result.projects.length === 0) {
+        return {
+          content: [{
+            type: "text",
+            text: `Проектов пока нет. Все схемы находятся в разделе "Общие" (${result.unassignedCount || 0} схем).\n\nСоздай проект с помощью create_project.`,
+          }],
+        };
+      }
+
+      const projectsList = result.projects.map(p => ({
+        id: p.id,
+        name: p.name,
+        description: p.description || "",
+        color: p.color,
+        icon: p.icon,
+        schemasCount: p.schemasCount || 0,
+      }));
+
+      return {
+        content: [{
+          type: "text",
+          text: `Найдено ${result.projects.length} проектов:\n\n${JSON.stringify(projectsList, null, 2)}\n\nСхем без проекта ("Общие"): ${result.unassignedCount || 0}`,
+        }],
+      };
+    }
+
+    case "create_project": {
+      const { name, description, color, icon } = args;
+
+      const result = await apiRequest("/projects", {
+        method: "POST",
+        body: JSON.stringify({ name, description, color, icon }),
+      });
+
+      return {
+        content: [{
+          type: "text",
+          text: `Проект "${result.project.name}" создан!\n\nID: ${result.project.id}`,
+        }],
+      };
+    }
+
+    case "delete_project": {
+      const { project_id } = args;
+
+      const result = await apiRequest(`/projects/${project_id}`, {
+        method: "DELETE",
+      });
+
+      return {
+        content: [{
+          type: "text",
+          text: result.message || "Проект удалён. Схемы перемещены в 'Общие'.",
+        }],
+      };
+    }
+
+    case "move_schema_to_project": {
+      const { schema_id, project_id } = args;
+
+      if (project_id) {
+        // Переместить в проект
+        const result = await apiRequest(`/projects/${project_id}/schemas/${schema_id}`, {
+          method: "PUT",
+        });
+        return {
+          content: [{
+            type: "text",
+            text: result.message || "Схема перемещена в проект.",
+          }],
+        };
+      } else {
+        // Убрать из проекта (в "Общие")
+        const result = await apiRequest(`/projects/null/schemas/${schema_id}`, {
+          method: "DELETE",
+        });
+        return {
+          content: [{
+            type: "text",
+            text: result.message || "Схема перемещена в 'Общие'.",
+          }],
+        };
+      }
+    }
+
+    case "update_project": {
+      const { project_id, name, description, color, icon } = args;
+
+      const updateBody = {};
+      if (name !== undefined) updateBody.name = name;
+      if (description !== undefined) updateBody.description = description;
+      if (color !== undefined) updateBody.color = color;
+      if (icon !== undefined) updateBody.icon = icon;
+
+      const result = await apiRequest(`/projects/${project_id}`, {
+        method: "PUT",
+        body: JSON.stringify(updateBody),
+      });
+
+      return {
+        content: [{
+          type: "text",
+          text: `Проект "${result.project.name}" обновлён!\n\nID: ${result.project.id}`,
+        }],
+      };
+    }
+
+    // ========== ТЕГИ ==========
+    case "add_tag": {
+      const { schema_id, name, color } = args;
+
+      // Получаем текущую схему
+      const currentResult = await apiRequest(`/schemas/${schema_id}`);
+      const currentData = currentResult.schema.data || { elements: [], connections: [], tagsDictionary: [] };
+
+      // Создаём новый тег
+      const newTag = {
+        id: generateId(),
+        name: name,
+        color: color || "#9E9E9E",
+      };
+
+      // Добавляем тег в tagsDictionary
+      const tagsDictionary = currentData.tagsDictionary || [];
+      tagsDictionary.push(newTag);
+
+      // Обновляем схему
+      await apiRequest(`/schemas/${schema_id}`, {
+        method: "PUT",
+        body: JSON.stringify({
+          data: { ...currentData, tagsDictionary },
+        }),
+      });
+
+      return {
+        content: [{
+          type: "text",
+          text: `Тег "${name}" добавлен!\n\nID: ${newTag.id}\nЦвет: ${newTag.color}`,
+        }],
+      };
+    }
+
+    case "remove_tag": {
+      const { schema_id, tag_id } = args;
+
+      // Получаем текущую схему
+      const currentResult = await apiRequest(`/schemas/${schema_id}`);
+      const currentData = currentResult.schema.data || { elements: [], connections: [], tagsDictionary: [] };
+
+      // Удаляем тег из tagsDictionary
+      const tagsDictionary = (currentData.tagsDictionary || []).filter(t => t.id !== tag_id);
+
+      // Удаляем тег со всех элементов
+      const elements = (currentData.elements || []).map(el => {
+        if (el.tags && Array.isArray(el.tags)) {
+          el.tags = el.tags.filter(t => t !== tag_id);
+        }
+        return el;
+      });
+
+      // Обновляем схему
+      await apiRequest(`/schemas/${schema_id}`, {
+        method: "PUT",
+        body: JSON.stringify({
+          data: { ...currentData, tagsDictionary, elements },
+        }),
+      });
+
+      return {
+        content: [{
+          type: "text",
+          text: `Тег удалён из схемы и со всех элементов.`,
+        }],
+      };
+    }
+
+    case "tag_element": {
+      const { schema_id, element_id, tag_id, action = "add" } = args;
+
+      // Получаем текущую схему
+      const currentResult = await apiRequest(`/schemas/${schema_id}`);
+      const currentData = currentResult.schema.data || { elements: [], connections: [], tagsDictionary: [] };
+
+      // Находим элемент и обновляем его теги
+      const elements = (currentData.elements || []).map(el => {
+        if (el.id === element_id) {
+          const tags = el.tags || [];
+          if (action === "add") {
+            if (!tags.includes(tag_id)) {
+              tags.push(tag_id);
+            }
+          } else if (action === "remove") {
+            const index = tags.indexOf(tag_id);
+            if (index > -1) {
+              tags.splice(index, 1);
+            }
+          }
+          el.tags = tags;
+        }
+        return el;
+      });
+
+      // Обновляем схему
+      await apiRequest(`/schemas/${schema_id}`, {
+        method: "PUT",
+        body: JSON.stringify({
+          data: { ...currentData, elements },
+        }),
+      });
+
+      const actionText = action === "add" ? "добавлен к" : "убран с";
+      return {
+        content: [{
+          type: "text",
+          text: `Тег ${actionText} элемента ${element_id}.`,
+        }],
+      };
+    }
+
+    case "list_tags": {
+      const { schema_id } = args;
+
+      // Получаем схему
+      const result = await apiRequest(`/schemas/${schema_id}`);
+      const tagsDictionary = result.schema.data?.tagsDictionary || [];
+
+      if (tagsDictionary.length === 0) {
+        return {
+          content: [{
+            type: "text",
+            text: "В схеме нет тегов.\n\nДобавь тег с помощью add_tag.",
+          }],
+        };
+      }
+
+      return {
+        content: [{
+          type: "text",
+          text: `Теги схемы (${tagsDictionary.length}):\n\n${JSON.stringify(tagsDictionary, null, 2)}`,
+        }],
+      };
+    }
+
     default:
       throw new Error(`Неизвестная команда: ${name}`);
   }
@@ -449,13 +1180,35 @@ URL: ${API_BASE_URL}/canvas?id=${schema_id}`,
  */
 async function main() {
   if (!AUTH_TOKEN) {
-    console.error("⚠️  SCHEMEOG_TOKEN не установлен. Укажите токен в переменной окружения.");
+    console.error(`
+⚠️  SCHEMEOG_TOKEN не установлен!
+
+Для работы MCP сервера необходим API токен.
+
+1. Получите токен: ${PROFILE_URL}
+2. Добавьте в настройки MCP:
+
+   "env": {
+     "SCHEMEOG_TOKEN": "schog_ваш-токен"
+   }
+
+Документация: ${DOCS_URL}
+`);
+  } else if (!AUTH_TOKEN.startsWith("schog_")) {
+    console.error(`
+⚠️  Неверный формат токена!
+
+Токен должен начинаться с "schog_".
+Получен: ${AUTH_TOKEN.substring(0, 10)}...
+
+Создайте новый токен: ${PROFILE_URL}
+`);
   }
 
   const server = new Server(
     {
       name: "schemeog-mcp",
-      version: "2.0.0",
+      version: "2.2.1",
     },
     {
       capabilities: {
@@ -485,7 +1238,7 @@ async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
 
-  console.error("SchemeOG MCP Server v2.0 запущен");
+  console.error("SchemeOG MCP Server v2.2 запущен");
 }
 
 main().catch(console.error);

package/package.json

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