maxerton
4dd2e58b86
Claude Code теперь согласует со stdio-серверами MCP 2026-07-28, где сервер не может сам слать запросы клиенту: ctx.elicit падал с NoBackChannelError, и trello_create_card не создавал карточки ни в терминале, ни в Desktop. Подтверждение переведено на Resolve/Elicit — SDK спрашивает через input_required или elicitation/create, смотря по версии протокола. SDK прячет от модели текст любых исключений, кроме ToolError, поэтому подсказки про незаданные ключи и 404 до неё не доходили. TrelloToolsServer отдаёт их текстом (HTTP-ошибки — без query, там ключи Trello). Ещё: - get_dev_task: перед реализацией ТЗ прочитать код, пересказать суть и предложить варианты или задать вопросы; - QA-документы по умолчанию на украинском; - README и подсказки в ошибках: в Claude Desktop /plugin configure нет, ключи задаются из терминала. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
74 lines
3.7 KiB
Markdown
74 lines
3.7 KiB
Markdown
# 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`.
|