pidkljuchennja_clickup_do_claude_code_cherez_mcp [wiki.hostingcloud.com.ua]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Підключення ClickUp до Claude Code через MCP ======

Ця інструкція описує, як підключити ClickUp до Claude Code через протокол MCP (Model Context Protocol), щоб агент міг напряму читати задачі, створювати підзадачі та рухати статуси по канбану без ручного копіювання даних.

===== Передумови =====

  * Встановлений **Node.js** (потрібен для CLI Claude Code)
  * Обліковий запис у робочому просторі ClickUp компанії
  * Доступ до терміналу (PowerShell на Windows, bash на Linux/macOS)

===== Крок 1. Встановлення Claude Code CLI =====

Якщо команда ''claude'' ще не працює в терміналі — встановіть CLI одним із способів.

**Варіант A — через npm:**

<code powershell>
npm install -g @anthropic-ai/claude-code
</code>

**Варіант B — офіційний інсталятор (Windows PowerShell):**

<code powershell>
irm https://claude.ai/install.ps1 | iex
</code>

Після встановлення **перезапустіть термінал** і перевірте версію:

<code powershell>
claude --version
</code>

===== Крок 2. Додавання ClickUp як MCP-сервера =====

У корені проєкту виконайте:

<code powershell>
claude mcp add --transport http clickup https://mcp.clickup.com/mcp
</code>

За замовчуванням сервер додається лише для поточного проєкту, локально (не потрапляє в git). Якщо потрібен доступ із усіх проєктів на цій машині:

<code powershell>
claude mcp add --transport http --scope user clickup https://mcp.clickup.com/mcp
</code>

Якщо потрібно, щоб конфігурація була спільною для команди — використайте ''--scope project''. Це створює файл ''.mcp.json'' у корені репозиторію (можна комітити в git, секретів там немає — авторизація в будь-якому разі відбувається окремо для кожного користувача).

===== Крок 3. Авторизація (OAuth) =====

  - Запустіть Claude Code: ''claude''
  - Виконайте команду ''/mcp''
  - Оберіть **clickup** → **Authenticate**
  - У браузері, що відкриється, увійдіть під своїм акаунтом ClickUp і підтвердіть доступ

Якщо працюєте на віддаленому хості без браузера:

<code powershell>
claude mcp login clickup --no-browser
</code>

і вставте отриманий callback-URL вручну.

===== Крок 4. Перевірка з'єднання =====

<code powershell>
claude mcp list
</code>

Очікуваний результат:

<code>
clickup: https://mcp.clickup.com/mcp (HTTP) - ✓ Connected
</code>

Або перевірте прямо всередині сесії Claude Code:

<code>
перевір задачу <ID_задачі> в ClickUp
</code>

===== Крок 5. Налаштування робочого контексту (CLAUDE.md) =====

Щоб агент не перепитував ID щоразу, додайте у файл ''CLAUDE.md'' в корені репозиторію блок із ключовими даними проєкту, наприклад:

<code markdown>
## ClickUp — <назва проєкту>

- Workspace ID: `...`
- Простір: `...`
- Список (kanban): `...`
- Головна задача: `...`
- Виконавець за замовчуванням: `...`

### Статуси канбану (по порядку)
new → analysis → ... → done

### Правила роботи з ClickUp
- Нові підзадачі створювати з parent: ...
- Статус за замовчуванням — new, якщо явно не вказано інше
- Рух статусу виконувати через ClickUp MCP (clickup_update_task), а не лише словесно в чаті
</code>

Цей файл автоматично підхоплюється Claude Code на старті кожної сесії в цьому репозиторії — контекст ClickUp більше не потрібно повторювати вручну.

===== Крок 6 (опційно). Звʼязок статусу з Git-комітами =====

ClickUp має нативну інтеграцію з GitHub: якщо додати в commit message, назву гілки або PR тег ''#taskID[статус]'', задача автоматично переходить у вказаний статус — без жодних додаткових викликів MCP.

<code powershell>
git commit -m "#869f730za[in progress] опис змін"
</code>

Це варто прописати як правило в ''CLAUDE.md'', щоб Claude Code сам додавав такий тег на ключових етапах роботи над задачею.

===== Усунення несправностей =====

^ Симптом ^ Причина / рішення ^
| ''claude'' не розпізнається як команда | CLI не встановлено або не потрапив у PATH — перезапустіть термінал (іноді й саму VSCode) після встановлення |
| ''claude mcp list'' показує сервер, але без позначки Connected | Авторизація не пройдена або застаріла — виконайте ''/mcp'' → **clickup** → **Authenticate** ще раз |
| Помилка EBUSY під час оновлення CLI через npm | Закрийте всі вікна VSCode перед повторним ''npm install -g @anthropic-ai/claude-code@latest'' |

===== Джерела =====

  * [[https://mcp.clickup.com/mcp|ClickUp MCP сервер]]
  * [[https://code.claude.com/docs/en/mcp|Документація Claude Code — MCP]]