# Aatex Setup

> Первая настройка MCP-подключения к ЦУП ААТех. Применяй когда пользователь говорит "подключи MCP", "настрой ИИ", "проверь связь с ЦУП", "не работают инструменты aatex", или когда инструменты mcp__aatex-cup__* недоступны. Покрывает получение API-ключа, конфигурацию клиента, диагностику подключения.

- Skill: `awaik/aatex-setup` (Agent Skill)
- Install (CLI): `npx skillmds@latest add awaik/aatex-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/awaik/aatex-setup/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: awaik (https://skillmd.com/u/awaik)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/awaik/aatex-setup

---


# Настройка MCP ЦУП ААТех

## Когда использовать

- Первый запуск проекта (пользователь только скачал папку)
- Пользователь просит: «подключи MCP», «настрой ИИ», «проверь связь»
- Инструменты `mcp__aatex-cup__*` не видны / не отвечают
- После смены ключа, истечения токена, перезапуска клиента

## Диагностика: проверь до начала

1. **Есть ли файл `.mcp.json` в корне проекта или `~/.claude.json`?**
   - Если нет — нужна полная настройка
   - Если есть — проверь Authorization header

2. **Попробуй вызвать `list_spaces`:**
   - Работает → всё хорошо, покажи что ещё умеет
   - `401 Unauthorized` → ключ не валиден
   - `403` → ключ не от этой организации
   - Инструмент не найден → клиент не подгрузил MCP-сервер

## Шаги настройки

### Шаг 1. Получить ключ

Скажи пользователю:

> Чтобы я мог работать с ЦУП ААТех, нужен API-ключ. Получи его так:
>
> 1. Зайди на https://app.aatex.ru и выбери нужную организацию
> 2. Открой **Профиль → Подключить ИИ (MCP)**
> 3. Нажми **«Создать ключ»**
> 4. **Сразу скопируй его** — показывается только один раз
>
> Вставь ключ в чат, я настрою конфиг.

### Шаг 2. Сконфигурировать клиент

Создай `.mcp.json` в корне проекта:

```json
{
  "mcpServers": {
    "aatex-cup": {
      "type": "http",
      "url": "https://app.aatex.ru/mcp",
      "headers": {
        "Authorization": "Bearer ВСТАВЬ_КЛЮЧ_СЮДА"
      }
    }
  }
}
```

**Важно:** добавь `.mcp.json` в `.gitignore` если в проекте есть git — ключ не должен попасть в репозиторий.

### Шаг 3. Перезапустить клиента

- **Claude Code** — выйти и запустить заново в этой папке
- **Claude Desktop** — Settings → MCP → Reload (или перезапуск приложения)
- **Cursor** — Reload Window

После перезапуска должны появиться 57 инструментов `mcp__aatex-cup__*`.

### Шаг 4. Проверить связь

Вызови `list_spaces` — должен вернуть массив пространств. Если ответ непустой — всё работает, скажи пользователю что готов к задачам.

## Типичные ошибки

| Симптом | Причина | Что сделать |
|---------|---------|-------------|
| `Missing or invalid Authorization header` | Ключ не передан / кривой формат | Проверь что в конфиге `"Bearer ключ"`, а не просто `"ключ"` |
| `401 Unauthorized` + `Invalid or expired access token` | Ключ отозван или неправильный | Создай новый через UI |
| `Not a member of this organization` | Ключ от другой организации | Создай ключ в нужной орге |
| `403 Session belongs to another user` | Осталась сессия от прежнего пользователя | Перезапусти клиента полностью |
| Инструменты `mcp__aatex-cup__*` не видны | Клиент не подхватил конфиг | Проверь путь к `.mcp.json`, перезапусти |
| `File too large` | Загружается файл > 20 МБ | Используй UI или разбей на части |

## После настройки — подскажи пользователю

Когда всё работает, кратко объясни что ты умеешь:

> Готово! Я подключился к организации **{название из list_spaces ответа}**. Я могу:
>
> - Создавать и перемещать карточки, заказы, позиции
> - Искать и обновлять данные
> - Работать с контрагентами (CRM + ЕГРЮЛ)
> - Показывать аналитику по доскам (просроченные, загрузка команды)
> - Читать и отправлять сообщения в мессенджере
> - Загружать файлы и комментарии
>
> С чего начнём?

## Где искать дополнительную информацию

- CLAUDE.md в корне проекта — полный каталог инструментов и сценариев
- Другие скиллы `.claude/skills/aatex-*` для специализированных задач