Підключення API-токенів і MCP-клієнтів
Створюйте токени інтеграції, налаштовуйте MCP-клієнт і використовуйте доступні інструменти завдань і коментарів.
Перед початком
Увійдіть і відкрийте профіль. Для MCP потрібен сумісний клієнт; для API та Python SDK — клієнт розробника.
Планування робочого процесу
API-токени автентифікують інтеграцію без інтерактивного входу браузера. Називайте токени зрозуміло, щоб пізніше визначати й відкликати їх. Строк і активність керують тривалістю доступу. Токен працює в межах прав облікового запису й не обходить участь у просторі чи обмеження проєкту.
MCP надає сумісному помічнику визначений набір інструментів, а не необмежене керування. Спочатку отримайте простір, дошку й колонки для правильних ID. Власні завдання дають контекст, зміна колонки оновлює етап, а коментар записує оновлення в обговорення. Перевіряйте налаштування клієнта й набір інструментів перед іншими операціями.
Приклад
Попросіть підключений клієнт отримати дошки простору, ваші високопріоритетні завдання дошки випуску та додати текстовий коментар до вибраного завдання. Для переміщення спочатку отримайте ID цільової колонки.
Покрокові інструкції / 1
Створіть токен інтеграції
Відкрийте «Профіль → API-токени» й створіть іменований токен, наприклад «Помічник розробки».
Задайте активність і необов’язкову дату завершення та скопіюйте токен у приватні налаштування клієнта.
У списку можна перейменувати токен, змінити доступні параметри, вимкнути або видалити його, коли доступ більше не потрібен.
Очікуваний результат: Клієнт має окремі облікові дані, які можна вимкнути чи відкликати.
Покрокові інструкції / 2
Підключіть і використайте MCP-клієнт
Відкрийте «Профіль → MCP» і скопіюйте адресу. Додайте її як HTTP MCP-сервер у налаштуваннях клієнта.
Налаштуйте Authorization: Bearer <your-api-token> зі створеним токеном. Назви полів залежать від клієнта.
Отримайте простори, потім дошки та колонки. Використовуйте повернуті ID для власних завдань або переміщення між колонками.
Використовуйте інструменти коментарів для читання обговорення чи додавання текстового оновлення. Перевірте результат у застосунку.
Очікуваний результат: MCP-клієнт працює з підтримуваними інструментами в межах ваших прав.
Приклад
MCP endpoint: https://tasker.fit/api/mcp/
Authorization: Bearer <your-api-token>
companies_list → boards_list → board_columns_list
my_board_tasks
task_column_change
task_comments_list
task_comment_create
Адреса MCP та інструкції автентифікації
Справжній інтерфейс Tasker.fit із вигаданими демонстраційними даними. Дані реальних клієнтів не показано.
Довідник функцій
API-токени
Створюйте іменовані bearer-токени для інтеграцій і MCP-клієнтів. У профілі доступні список токенів і копіювання значення.
Активність і строк токена
Активуйте чи вимикайте токен і задавайте необов’язкову дату завершення дії. Так ви контролюєте тривалість доступу інтеграції.
Редагування й відкликання токена
Змінюйте назву та доступні параметри або видаляйте непотрібний токен. Після видалення він перестає працювати.
Підключення MCP-клієнта
Підключайте сумісний MCP-клієнт через адресу Tasker.fit і bearer-токен. Профіль містить інструкції щодо підключення й автентифікації.
Пошук просторів і дошок через MCP
Використовуйте MCP-інструменти для отримання доступних просторів, дошок і колонок. Їхні ідентифікатори потрібні для подальшої роботи.
Власні завдання через MCP
Отримуйте призначені вам завдання вибраної дошки. Інструмент підтримує пошук, пріоритет, тип і параметри сторінок.
Зміна колонки через MCP
Переміщуйте завдання в іншу колонку через відповідний MCP-інструмент. Зміни використовують чинні права доступу до завдань.
Коментарі через MCP
Читайте коментарі завдання або додавайте коментар із простим текстом. Обговорення залишається в історії відповідного завдання.
Python SDK
Python SDK надає типізовані моделі, методи сервісу й допоміжні засоби пагінації. Він охоплює простори, дошки, завдання, коментарі, чеклісти, файли, токени, запрошення та підписки.
Поради й вирішення проблем
- Зберігайте bearer-токени як паролі. Не додавайте їх до публічного коду, знімків документації чи спільних чатів. Відкликайте непотрібні токени.
- Реалізовані MCP-інструменти охоплюють пошук просторів, власні завдання, зміну колонок і коментарі. Загального створення завдань через MCP наразі немає.
Поширені запитання
Чому MCP-клієнт відхиляє токен?
Перевірте активність, строк і заголовок Bearer. Використовуйте повну адресу /api/mcp/ та підтримуваний клієнтом HTTP-транспорт.
Чи може MCP створювати будь-яке завдання?
Загальне створення завдань не належить до реалізованих MCP-інструментів. Використовуйте вебінтерфейс або відповідну операцію API чи SDK.