Raporty i integracje
Integracja ClickUp i GitHub z Mantrego: token i synchronizacja
Integracja ClickUp w Mantrego: token pk_, identyfikator listy i synchronizacja zadań oraz GitHub z tokenem do odczytu zgłoszeń i pull requestów.
Spis treści
Integracja ClickUp w Mantrego pobiera zadania z wybranej listy ClickUp do sekcji Zadania i raportów realizacji. Konektor GitHub dodaje otwarte zgłoszenia i pull requesty wybranego repozytorium. Oba konektory głównie czytają dane.
Sprawdzone w wersji 0.6.2, 2026-10-07.
Zanim zaczniesz
- Rola Właściciel organizacji. Członek nie dodaje kont integracji.
- Limit planu: Free pozwala na 3 konta integracji.
- Każde konto integracji należy do jednego klienta, więc zadania i zgłoszenia trafiają do tego klienta.
Kroki
ClickUp
- W ClickUp kliknij swój awatar w prawym górnym rogu, wybierz Settings (Ustawienia), potem Apps (Aplikacje). W sekcji API Token kliknij Generate i skopiuj token. Osobisty token zaczyna się od pk_ i nie wygasa.
- Otwórz w ClickUp listę, z której chcesz importować zadania. Kliknij jej menu, wybierz Kopiuj link. Numer na końcu adresu to identyfikator listy.
- W Mantrego wejdź w Integracje, znajdź kartę ClickUp i kliknij Dodaj konto.
- Wpisz Nazwa połączenia, wybierz Klient, wklej Osobisty token ClickUp i Identyfikator listy ClickUp.
- Opcjonalnie zaznacz Synchronizuj automatycznie w tle i ustaw Odstęp synchronizacji (minuty). Kliknij Zapisz połączenie.
- Kliknij Sprawdź, a potem Synchronizuj. Zadania pojawią się w sekcji Zadania.
Jak działa synchronizacja ClickUp
- Zadania czytane są stronami (do 10 stron po 100), aż do ostatniej.
- Przy pełnym odczycie lokalne zadania ClickUp, które zniknęły z listy, są usuwane. Zadania z wpisami czasu zostają jako ukończone i zarchiwizowane i nie liczą się do zaległych, raportów realizacji ani automatyzacji.
- Mantrego zachowuje lokalne przypisanie do projektu, osobę odpowiedzialną i estymatę czasu. Pola z ClickUp mają pierwszeństwo przy konflikcie.
- Zadania demonstracyjne są pomijane przez reguły zewnętrzne.
Tworzenie zadań w ClickUp z Mantrego
Otwórz zadanie, wybierz Konto docelowe i kliknij Opublikuj w ClickUp. Działanie trafia do centrum Akceptacje. Właściciel klika tam Akceptuję ten zakres, a potem Wykonaj teraz. Reguła automatyzacji Utwórz zadanie w ClickUp działa tak samo (zobacz Jak ustawić automatyzacje).
GitHub
- W GitHubie wejdź w Settings, Developer settings, Personal access tokens, Fine-grained tokens i kliknij Generate new token.
- Nadaj nazwę i datę wygaśnięcia, wybierz właściciela zasobów oraz Only select repositories i wskaż repozytorium.
- W uprawnieniach ustaw Issues: Read oraz Pull requests: Read. Więcej nie jest potrzebne.
- W Mantrego wybierz kartę GitHub, kliknij Dodaj konto i wpisz Token dostępu GitHub oraz Repozytorium (właściciel/nazwa), na przykład mojafirma/sklep.
- Kliknij Zapisz połączenie, Sprawdź i Synchronizuj.
Mantrego czyta do 500 ostatnio zmienianych rekordów i rozpoznaje pull requesty po polu pull_request. Wyniki widać w Analityka, w zakładce Realizacja: Otwarte zgłoszenia GitHub i Otwarte pull requesty. Na pulpicie jest też panel Zgłoszenia GitHub.
Rozwiązywanie problemów
- Sprawdź nie przechodzi dla ClickUp. Sprawdź, czy token zaczyna się od pk_ i czy identyfikator listy to sam numer.
- Nie widać zadań w Zadaniach. Kliknij Synchronizuj i sprawdź filtr klienta w nagłówku strony.
- GitHub zwraca błąd dostępu. Token musi mieć dostęp do wskazanego repozytorium i odczyt Issues oraz Pull requests. Sprawdź datę wygaśnięcia tokenu.
- Zgłoszenia nie pojawiają się w raporcie. Raport realizacji pokazuje bieżący stan, niezależnie od zakresu dat raportu.
Ograniczenia
- GitHub jest tylko do odczytu. Mantrego nie scala pull requestów ani nie zmienia zgłoszeń.
- Do 500 rekordów z GitHuba i do 10 stron po 100 zadań z ClickUp.
- Zapis do ClickUp (nowe zadanie) zawsze wymaga akceptacji. Niepewny wynik zapisu nie jest ponawiany automatycznie.
- Usunięcie połączenia nie jest możliwe, gdy konto ma oczekujące operacje w Akceptacjach.
Powiązane artykuły
- Jak pracować z klientami, zadaniami, projektami i czasem pracy
- Jak ustawić automatyzacje: przypomnienia i terminy zadań
- ClickUp w agencji: kiedy wystarczy, a kiedy potrzebujesz czegoś obok
- Zarządzanie zadaniami w agencji
- Cennik
Najczęstsze pytania
- Czy Mantrego zmienia zadania w ClickUp?
- Czyta zadania z wybranej listy. Tworzenie zadania w ClickUp jest możliwe tylko po Twojej akceptacji w centrum Akceptacje, na przykład z poziomu zadania lub reguły automatyzacji.
- Co z zadaniami usuniętymi w ClickUp?
- Pełny odczyt usuwa lokalne zadania, których już nie ma na liście. Zadania z wpisami czasu zostają jako ukończone i zarchiwizowane.
- Czy Mantrego może scalić pull request w GitHubie?
- Nie. Konektor GitHub tylko czyta zgłoszenia i pull requesty.