Łączenie aplikacji AI z PlanRadar przez MCP (Beta)

Przegląd

Proszę połączyć aplikację AI, taką jak ChatGPT, Claude, Claude Code, Codex lub LangDock, z PlanRadar. Następnie mogą Państwo zadawać aplikacji AI pytania o swoje projekty własnymi słowami, we wszystkich projektach jednocześnie, i zlecać jej zmiany, na przykład aktualizację zadania lub dodanie komentarza.

Aplikacja AI działa jako Państwo. Widzi tylko to, co Państwo widzą w PlanRadar, i robi tylko to, na co pozwala Państwa użytkownik.

Połączenie korzysta z Model Context Protocol (MCP). Nie muszą Państwo wiedzieć, jak działa MCP: wystarczy skopiować jeden adres URL z PlanRadar do aplikacji AI i zalogować się swoim użytkownikiem PlanRadar.

Dostęp i uprawnienia

• Tylko Państwa projekty. Aplikacja AI widzi tylko projekty, których są Państwo członkiem, i tylko to, co pozwala zobaczyć Państwa rola w danym projekcie.
• Jeden przełącznik dla całego konta. Administrator konta włącza MCP raz dla całego konta. Nie ma ustawienia dla poszczególnych użytkowników. Każdy użytkownik sam łączy i odłącza swoją aplikację AI.
• Zmiany są Państwa. Każda zmiana wprowadzona przez aplikację AI jest widoczna w PlanRadar jako wprowadzona przez Państwa, na przykład w historii zadania, tak jak zmiana wprowadzona samodzielnie.

Włączanie MCP dla konta

Administrator konta robi to raz dla całego konta. Ustawienie jest widoczne dopiero wtedy, gdy PlanRadar włączy wersję beta dla Państwa konta.

Aby włączyć MCP:

1. Proszę kliknąć Ustawienia
2. Proszę kliknąć Konto
3. Proszę kliknąć Ustawienia konta
4. Proszę zaznaczyć Włącz MCP

Kopiowanie adresu URL serwera MCP

Każdy użytkownik potrzebuje adresu URL serwera MCP, aby połączyć swoją aplikację AI.

Aby skopiować adres URL:

1. Proszę kliknąć Ustawienia
2. Proszę kliknąć Profil
3. Proszę kliknąć Połączone aplikacje AI
4. W sekcji Adres URL serwera MCP proszę kliknąć Kopiuj

Dla większości kont adres URL to https://www.planradar.com/mcp. Konta w innej instancji PlanRadar mają własny adres, dlatego zawsze proszę używać adresu URL wyświetlanego na tej stronie.

Łączenie aplikacji AI

Każdą aplikację AI łączy się w ten sam sposób: dodają Państwo PlanRadar z adresem URL serwera MCP, logują się swoim użytkownikiem PlanRadar i potwierdzają na stronie PlanRadar.

Gdy aplikacja AI zapyta o sposób uwierzytelniania, proszę wybrać OAuth 2.0 with Dynamic Client Registration i pozostawić pola client ID i client secret puste. PlanRadar zarejestruje aplikację za Państwa.

Jeśli aplikacją AI zarządza Państwa firma, administrator tej aplikacji może najpierw musieć zezwolić na PlanRadar lub go dodać. Każda karta informuje, kiedy jest to potrzebne.

Co pokazuje strona PlanRadar

Zanim aplikacja AI otrzyma dostęp, PlanRadar pokazuje, co będzie mogła robić. Proszę to przeczytać przed kliknięciem Połącz:

• Może wyświetlać: Twoje zadania, projekty, plany, formularze, pliki i raporty.
• Może: na przykład tworzyć i aktualizować zadania i komentarze oraz dodawać pliki do Dokumentów.
• Nie może: usuwać czegokolwiek.

Strona informuje też, dokąd trafiają Państwa dane: to, co odczytuje aplikacja AI, jest wysyłane do firmy, która za nią stoi, i tam przetwarzane. Na przykład to, co odczytuje ChatGPT, jest wysyłane do OpenAI.

Jeśli aplikacji AI nie ma na liście PlanRadar, strona oznacza ją jako Niezweryfikowane przez PlanRadar. Proszę łączyć tylko aplikacje, którym Państwo ufają. Claude Code i Codex działają na Państwa własnym komputerze, więc zawsze mają to oznaczenie.

Co może robić aplikacja AI

Aplikacja AI pracuje na tych samych danych, które Państwo widzą w PlanRadar, w projektach, których są Państwo członkiem.

Może odczytywać:

• Państwa projekty i przegląd statusu każdego projektu
• Zgłoszenia: wyszukiwać je, odczytywać ich szczegóły, historię i załączniki, sprawdzać, co zmieniło się od danej daty, i je podsumowywać
• Formularze (typy zadań) i użytkowników projektu
• Dokumenty: wyświetlać listę plików i je przeszukiwać, odczytywać tekst pliku i pobierać link do pobrania
• Lokalizacje i plany
• Prośby o akceptację
• Raporty projektu: wyświetlać ich listę i je odczytywać
• Harmonogram (tylko odczyt)

Może zmieniać:

• Tworzyć i aktualizować zadania, w tym odpowiedzi na listy kontrolne
• Dodawać komentarze do zadań
• Przypisywać zadania
• Tworzyć projekty, formularze i widoki filtrów
• Przesyłać pliki do Dokumentów
• Zapraszać osoby do Państwa konta przez e-mail. Dołączają jako użytkownicy wewnętrzni
• Eksportować zadania do PDF lub Excel, z linkiem do pobrania

Nie może niczego usuwać.

Co można z nią robić

Ponieważ aplikacja AI widzi wszystkie Państwa projekty jednocześnie, mogą Państwo zadawać pytania, które w PlanRadar wymagałyby wielu kliknięć. Proszę pytać własnymi słowami, we własnym języku. Na przykład:

Odpowiedzi ze wszystkich projektów

• „Który podwykonawca ma najwięcej zaległych zadań we wszystkich moich projektach?”
• „Zrób tabelę z jednym wierszem na projekt: otwarte zadania, zaległe zadania i najbliższy kamień milowy z harmonogramu.”
• „Co zmieniło się w zadaniach w moich projektach od poniedziałku?”

Pisanie raportów i aktualizacji

• „Podsumuj postęp prac w budynku B w tym tygodniu dla inwestora.”
• „Na jakim etapie jest budynek A, co jest zaległe i co blokuje zakończenie? Napisz to jako krótkie podsumowanie dla zarządu.”
• „Napisz informację o stanie prac dla nabywcy mieszkania 24. Pomiń nazwiska wewnętrzne.”
• „Opisz nasze formularze, ich pola i statusy jako krótki przewodnik dla nowych kierowników budowy.”

Porównywanie i sprawdzanie

• „Porównaj raport tygodniowy z zeszłego tygodnia z tegotygodniowym i wypisz, co się zmieniło.”
• „Przeczytaj oba raporty z przeglądu instalacji elektrycznej w Dokumentach i przypisz każdą usterkę do zadania. Wypisz usterki, które nie mają jeszcze zadania.”

Aktualizowanie zadań z czatu

• „Ustaw zadanie 4 na Zrealizowane, dodaj komentarz, że wymieniono samozamykacz drzwi, i przesuń termin na piątek.”
• „Utwórz zadanie w budynku B: brak uszczelnienia ogniochronnego w szachcie R3, poziom 3, termin w przyszły piątek.”

Łączenie z aplikacją AI

• Proszę korzystać z funkcji samej aplikacji AI: „Pokaż zaległe zadania według podwykonawców jako wykres słupkowy”, „Wyeksportuj wynik jako plik Excel”, „Zamień to podsumowanie na PDF”.
• Proszę łączyć PlanRadar z innymi konektorami, z których Państwa firma już korzysta w tej aplikacji AI, na przykład z SharePoint: „Porównaj otwarte zadania w budynku B z listą usterek w SharePoint.”

Ważne informacje

• Aplikacja AI nie może niczego usuwać.
• Harmonogram jest tylko do odczytu. Aplikacja AI nie może przesuwać ani zmieniać pozycji w harmonogramie.
• Aplikacja AI zaprasza osoby do Państwa konta, a nie do konkretnego projektu. Dodanie ich do projektu oraz ustawienie roli i uprawnień odbywa się w PlanRadar.
• Nowe formularze utworzone z czatu mogą mieć tylko proste pola: krótki tekst, długi tekst, data, tak/nie i użytkownik. Listy kontrolne i listy proszę dodawać w PlanRadar.
• Nie może utworzyć bezpośredniego linku do pozycji zadania na planie.
• Pliki przesyłane z czatu mogą mieć do 25 MB na jedno przesłanie.
• Każde połączenie może wysłać ograniczoną liczbę żądań na minutę. Powyżej tego limitu aplikacja AI otrzymuje komunikat „Too many requests on this connection. Retry in N seconds.”
• Linki do pobrania wygasają: po 15 minutach dla dokumentów i plików zadań, po 60 minutach dla eksportów zadań i raportów projektu oraz po 2 godzinach dla planów. Jeśli link przestanie działać, proszę poprosić aplikację AI o nowy.
• Odpowiedzi zależą od używanej aplikacji AI. Przed podjęciem działań proszę sprawdzić ważne liczby w PlanRadar.

Odłączanie aplikacji AI

Swoją aplikację AI mogą Państwo odłączyć w dowolnym momencie. Natychmiast traci ona dostęp, a później można ją połączyć ponownie.

Aby odłączyć aplikację AI:

1. Proszę kliknąć Ustawienia
2. Proszę kliknąć Profil
3. Proszę kliknąć Połączone aplikacje AI
4. Proszę kliknąć Odłącz obok aplikacji
5. Proszę kliknąć Odłącz, aby potwierdzić

Rozwiązywanie problemów