# trello-tools

MCP-сервер для Claude Code: карточки Trello, QA-документы и задания для фронта/бэка
через qa-docs-service. Распространяется как плагин из маркетплейса `gp-tools`.

## Установка

Нужен [uv](https://docs.astral.sh/uv/) — через него плагин ставит Python и зависимости
сам, при первом запуске:

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

В Claude Code:

```
/plugin marketplace add https://git.maxerton.live/maxerton/trello-mcp.git
/plugin install trello-tools@gp-tools
/plugin configure trello-tools@gp-tools
```

Последняя команда открывает форму с ключами. Её нужно выполнить, даже если при
установке ничего не спросили (например, ставил через `claude plugin install` в терминале).
Токены хранятся у тебя локально (`~/.claude/.credentials.json`), в репозиторий
ничего не попадает.

| Поле | Кому нужно |
|---|---|
| Trello API key, Trello token | всем, кто работает с карточками Trello |
| QA tasks token | фронту и бэку — доступ к заданиям `/tasks` (выдаёт владелец) |
| QA service API key | только владельцу, остальные оставляют пустым |
| QA service URL, Trello board, Trello lists | уже заполнены, менять не нужно |

Поменять ключи потом — той же `/plugin configure trello-tools@gp-tools`.
После настройки перезапусти Claude Code (или `/reload-plugins`).

### Claude Desktop

Во вкладке **Code** (локальная сессия): **+ → Plugins → Add plugin**, выбрать
`trello-tools`, scope — **user**. Маркетплейс добавляется там же или из терминала.

Формы с ключами Desktop не показывает, а `/plugin configure` в нём отвечает
`isn't available in this environment`. Ключи задаются один раз из терминала:
Desktop и терминальный Claude Code на одном компьютере читают одни и те же
настройки.

1. Поставь Claude Code CLI, если его ещё нет:
   macOS/Linux — `curl -fsSL https://claude.ai/install.sh | bash`,
   Windows (PowerShell) — `irm https://claude.ai/install.ps1 | iex`.
2. В терминале запусти `claude`, введи `/plugin configure trello-tools@gp-tools`
   и заполни форму.
3. Полностью перезапусти Claude Desktop.

Проверить, что всё задано: `claude plugin configure trello-tools@gp-tools` в
терминале покажет, какие поля `set`, а какие `not set`.

## Обновление

```
/plugin marketplace update gp-tools
/plugin update trello-tools@gp-tools
```

и перезапусти Claude Code.

## Для владельца

- Опубликовать новую версию — `git push`: каждый коммит считается новой версией.
- Если сервер зарегистрирован ещё и вручную (`claude mcp add trello-tools ...`),
  а плагин тоже установлен — инструменты задвоятся. Убрать ручную регистрацию:
  `claude mcp remove trello-tools -s local`.
- Локальная разработка по-прежнему через `.env` (см. `.env.example`) и `install.txt`.