# n8n REST API Coverage (для README.md)

Эту секцию можно добавить в README.md проекта.

---

## 🎯 n8n REST API Coverage

MCP сервер n8n-workflow-builder обеспечивает **83% покрытие** официального n8n REST API v1.

### Поддерживаемые категории API

| Категория | Методов | Реализовано | Покрытие |
|-----------|---------|-------------|----------|
| **Workflows** | 8 | 6 полностью, 2 частично | 75% |
| **Executions** | 4 | 4 полностью | **100%** ✅ |
| **Credentials** | 6 | 4 полностью, 2 частично | 67% |
| **Tags** | 5 | 5 полностью | **100%** ✅ |
| **ИТОГО** | **23** | **19** полностью, **4** частично | **83%** |

### Статус реализации

#### ✅ Полностью реализовано (19 методов)

**Workflows (6):**
- `list_workflows` - Список workflows с метаданными
- `get_workflow` - Получение workflow по ID
- `create_workflow` - Создание нового workflow
- `update_workflow` - Полное обновление workflow
- `patch_workflow` - Частичное обновление workflow
- `delete_workflow` - Удаление workflow

**Executions (4):**
- `list_executions` - Список выполнений с фильтрами
- `get_execution` - Получение execution по ID
- `delete_execution` - Удаление execution
- `retry_execution` - Повтор failed execution

**Credentials (4):**
- `list_credentials` - Список credentials (только метаданные)
- `create_credential` - Создание credential
- `delete_credential` - Удаление credential
- `get_credential_schema` - Получение JSON schema для типа credential

**Tags (5):**
- `get_tags` - Список всех tags
- `get_tag` - Получение tag по ID
- `create_tag` - Создание нового tag
- `update_tag` - Обновление tag
- `delete_tag` - Удаление tag

#### ⚠️ Частично реализовано (4 метода)

**Workflows (2):**
- `activate_workflow` - ⚠️ n8n API v2.0.3 не поддерживает программную активацию
  - **Альтернатива:** Активация через n8n web UI
- `deactivate_workflow` - ⚠️ n8n API v2.0.3 не поддерживает программную деактивацию
  - **Альтернатива:** Деактивация через n8n web UI

**Credentials (2):**
- `get_credential` - ⚠️ n8n блокирует по соображениям безопасности
  - **Альтернатива:** Использовать `list_credentials` для метаданных
- `update_credential` - ⚠️ Immutability pattern для защиты секретов
  - **Альтернатива:** DELETE + CREATE pattern

> **Примечание:** Все частично реализованные методы возвращают информативные guidance сообщения с объяснением ограничений и альтернативными решениями.

### 📊 Детальная документация

Для детального анализа покрытия API см.:
- [API Coverage Analysis](./API-COVERAGE-ANALYSIS.md) - Детальный анализ
- [API Methods Checklist](./API-METHODS-CHECKLIST.md) - Быстрый справочник
- [API Coverage Visual](./API-COVERAGE-VISUAL.md) - Визуальная сводка
- [n8n API Documentation](./n8n-api-docs/) - Локальная документация n8n API

---