Підключення ClickUp до Claude Code через MCP

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

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

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

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

npm install -g @anthropic-ai/claude-code

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

irm https://claude.ai/install.ps1 | iex

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

claude --version

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

claude mcp add --transport http clickup https://mcp.clickup.com/mcp

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

claude mcp add --transport http --scope user clickup https://mcp.clickup.com/mcp

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

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

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

claude mcp login clickup --no-browser

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

claude mcp list

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

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

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

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

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

## ClickUp — <назва проєкту>
 
- Workspace ID: `...`
- Простір: `...`
- Список (kanban): `...`
- Головна задача: `...`
- Виконавець за замовчуванням: `...`
 
### Статуси канбану (по порядку)
new → analysis → ... → done
 
### Правила роботи з ClickUp
- Нові підзадачі створювати з parent: ...
- Статус за замовчуванням — new, якщо явно не вказано інше
- Рух статусу виконувати через ClickUp MCP (clickup_update_task), а не лише словесно в чаті

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

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

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

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

• ClickUp MCP сервер
• Документація Claude Code — MCP