Planfix MCP

MCP (Model Context Protocol) umożliwia asystentom AI i innym zgodnym aplikacjom korzystanie z danych Planfix za pośrednictwem standardowego protokołu.

Po nawiązaniu połączenia klient otrzymuje wyłącznie jawnie przyznane możliwości i działa w imieniu zalogowanego Pracownika. Nadal obowiązują standardowe uprawnienia dostępu w Planfix: asystent AI nie może wyświetlać ani zmieniać niczego, co jest niedostępne dla tego użytkownika.

Dostępne działania zależą od klienta MCP, przyznanych uprawnień i bieżącej wersji serwera. Na przykład klient może wyszukiwać Zadania i kontakty, odczytywać ich szczegóły oraz dodawać komentarze, jeśli przyznano odpowiednie uprawnienia.

Wymagania

konto Pracownika w Planfix;
klient MCP obsługujący Streamable HTTP i OAuth.

Adres serwera MCP

Użyj tego adresu URL serwera MCP:

https://mcp.planfix.com/mcp

Adres URL jest taki sam dla każdego konta Planfix. Nie dodawaj do niego nazwy konta ani nie wysyłaj osobnego nagłówka konta. Konto jest wybierane podczas autoryzacji OAuth.

Łączenie dowolnego klienta MCP

Otwórz ustawienia serwera MCP w kliencie.
Dodaj nowy serwer, używając transportu Streamable HTTP.
Wprowadź nazwę, na przykład Planfix, i adres URL MCP.
Zapisz ustawienia i rozpocznij uwierzytelnianie OAuth.
W otwartym oknie przeglądarki wybierz konto Planfix. Możesz wyszukać je według nazwy, adresu URL lub adresu e-mail.
Sprawdź nazwę aplikacji i żądane uprawnienia, a następnie potwierdź połączenie.

Jeśli aplikacja nie została jeszcze dopuszczona na koncie, Planfix poinformuje, że wymagana jest zgoda administratora. Administrator konta lub administrator techniczny może zatwierdzić aplikację. Jeśli administrator jest jednocześnie osobą, która ją łączy, może zatwierdzić aplikację i nawiązać połączenie w ramach jednej czynności.

W przypadku połączenia Codex przez DCR żądania nie można przekazać administratorowi po rozpoczęciu logowania, dlatego wcześniej wybierz odpowiedni scenariusz z następnej sekcji.

Łączenie Codex

Wybierz odpowiednią opcję w zależności od tego, czy jesteś administratorem konta, z którym chcesz nawiązać połączenie.

Jeśli jesteś administratorem: połącz przez DCR

Ta opcja jest dostępna dla administratora konta lub administratora technicznego. Podczas logowania będą oni mogli zatwierdzić automatycznie zarejestrowaną aplikację i nawiązać z nią połączenie.

Dodaj serwer MCP:

codex mcp add planfix --url https://mcp.planfix.com/mcp

Rozpocznij logowanie OAuth i jawnie wybierz DCR jako metodę rejestracji klienta:

codex mcp login planfix --oauth-client-registration dcr

Codex otworzy przeglądarkę. Wybierz konto Planfix, którego jesteś administratorem, sprawdź żądane uprawnienia i kliknij Zezwól i połącz.

Aplikacja zarejestrowana przez DCR zawsze wymaga jawnego zatwierdzenia przez konto. Zwykły Pracownik nie powinien rozpoczynać tego scenariusza: obecnie żądania połączenia przez DCR nie można odroczyć i przekazać administratorowi do osobnego zatwierdzenia.

Parametr --oauth-client-registration dcr dotyczy tylko tego logowania i nie jest zapisywany w pliku config.toml. Codex sam zapisze otrzymane dane połączenia OAuth.

Jeśli nie jesteś administratorem: połącz za pomocą client_id

Najpierw poproś administratora konta lub administratora technicznego o utworzenie aplikacji:

Otwórz Zarządzanie kontem → API → Aplikacje OAuth i MCP.
W bloku Aplikacje tego konta kliknij Utwórz aplikację.
Wprowadź nazwę, na przykład Codex.
Wybierz typ Klient publiczny. Codex nie wymaga klucza tajnego klienta.
Dodaj URI przekierowania http://127.0.0.1/callback.
Wybierz minimalny wymagany zakres uprawnień i zapisz aplikację.
Przekaż użytkownikowi uzyskany client_id.

Planfix publikuje issuer i obsługuje powiązanie z nim odpowiedzi autoryzacyjnej, dlatego nowy, wstępnie zarejestrowany klient Codex używa stałego adresu zwrotnego http://127.0.0.1/callback. Podczas logowania Codex dodaje tymczasowy port loopback; Planfix akceptuje taki port, jeśli host i ścieżka pozostają niezmienione.

Użytkownik dodaje serwer, podstawiając przekazany identyfikator:

codex mcp add planfix --url https://mcp.planfix.com/mcp --oauth-client-id CLIENT_ID

Codex wyświetli pełny adres URL zwrotny. W domyślnej konfiguracji wygląda on tak:

OAuth callback URL: http://127.0.0.1/callback

Jeśli z powodu niestandardowych ustawień Codex wyświetlany jest inny adres, poproś administratora o dodanie tego URI przekierowania do aplikacji.

Następnie uruchom:

codex mcp login planfix

Podanie parametru --oauth-client-id oznacza, że Codex użyje wstępnie zarejestrowanego klienta i nie rozpocznie CIMD ani DCR. Ustawienia zostaną zapisane mniej więcej tak:

[mcp_servers.planfix]
url = "https://mcp.planfix.com/mcp"

[mcp_servers.planfix.oauth]
client_id = "CLIENT_ID"
callback_url = "http://127.0.0.1/callback"

Aplikacja Codex i rozszerzenie IDE

Aplikacja Codex, Codex CLI i rozszerzenie IDE korzystają z tej samej konfiguracji MCP na danym komputerze. Po nawiązaniu pierwszego połączenia przez CLI uruchom ponownie aplikację lub rozszerzenie. Serwer pojawi się w sekcji Ustawienia → Serwery MCP. Jeśli obok niego widoczny jest przycisk Uwierzytelnij, kliknij go i dokończ logowanie.

Aktywne serwery MCP można sprawdzić za pomocą polecenia /mcp w polu wprowadzania tekstu Codex.

Listę połączeń i ich status można wyświetlić za pomocą polecenia:

codex mcp list

Bieżące elementy interfejsu, polecenia i zasady wyboru adresu zwrotnego opisano w oficjalnej dokumentacji MCP OpenAI.

Jeśli inny klient MCP nie może zarejestrować się automatycznie

Nowoczesny klient MCP może zarejestrować się automatycznie przez CIMD lub DCR. Sama rejestracja nie przyznaje dostępu do konta: nadal obowiązują zasady konta i wymóg zatwierdzenia przez administratora.

Jeśli klient wymaga wcześniej określonego client_id, poproś administratora o utworzenie publicznej aplikacji dla konta:

Otwórz Zarządzanie kontem → API → Aplikacje OAuth i MCP.
W bloku Aplikacje tego konta utwórz aplikację.
Wybierz typ Klient publiczny.
Dodaj URI przekierowania wskazane przez klienta MCP.
Wybierz minimalny wymagany zakres uprawnień.
Przekaż użytkownikowi uzyskany client_id lub dodaj go do ustawień klienta.

Taka aplikacja będzie mogła łączyć się tylko z kontem, na którym ją utworzono. Szczegóły — w artykule Aplikacje OAuth i MCP w koncie.

Wiele kont

Każde połączenie jest powiązane z jednym kontem i jednym użytkownikiem.

Aby nawiązać połączenie przez DCR, dodaj kolejny serwer MCP pod inną nazwą i podczas logowania wybierz inne konto, którego jesteś administratorem.
Aplikacja utworzona na koncie i jej client_id działają tylko na koncie, na którym je utworzono. W przypadku innego konta jego administrator musi utworzyć osobną aplikację publiczną. Dodaj ją do Codex pod inną nazwą, używając nowego client_id.

Nie zmieniaj adresu URL MCP i nie dodawaj nazwy konta do żądań. Serwer rozpoznaje konto na podstawie wydanego tokenu OAuth.

Rozłączanie MCP

Aby cofnąć połączenie:

Otwórz swoją kartę użytkownika w Planfix.
Przejdź do Zarządzania sesjami.
Znajdź aplikację oznaczoną jako MCP i usuń sesję.
Usuń serwer w kliencie MCP lub go wyłącz, jeśli nie jest już potrzebny.

Usunięcie sesji unieważnia powiązane tokeny OAuth. Aby ponownie nawiązać połączenie, trzeba zalogować się i wyrazić zgodę.

Administrator może cofnąć dostęp aplikacji dla całego konta w sekcji Zarządzanie kontem → API → Aplikacje OAuth i MCP.

Bezpieczeństwo

Łącz tylko aplikacje, którym ufasz.
Przed zatwierdzeniem sprawdź nazwę aplikacji, właściciela, URI przekierowania i żądane uprawnienia.
Przyznawaj minimalne wymagane uprawnienia. Jeśli aplikacja ma tylko odczytywać dane, nie przyznawaj uprawnień do ich modyfikowania ani usuwania.
Nigdy nie wklejaj tokenu dostępu ani tokenu odświeżania do czatu, ustawień żądań ani dzienników.
Pamiętaj, że treść Zadań, kontaktów i komentarzy może być wysyłana do zewnętrznej usługi AI zgodnie z warunkami przetwarzania danych tej usługi.
Usuń połączenie w sekcji Zarządzanie sesjami, jeśli nie jest już używane lub go nie rozpoznajesz.

Rozwiązywanie problemów

Jeśli logowanie przez DCR wymaga zatwierdzenia przez administratora, zaloguj się jako administrator konta lub administrator techniczny i kliknij Zezwól i połącz. Zwykły Pracownik nie może przekazać rozpoczętego żądania DCR do osobnego zatwierdzenia.

Komunikat lub objaw	Co zrobić
Aplikacja jest zablokowana przez zasady konta	Administrator musi zatwierdzić konkretną aplikację lub zmienić zasady dotyczące aplikacji innych firm.
Po zalogowaniu klient ponownie prosi o autoryzację	Usuń połączenie z klienta i utwórz je ponownie. Upewnij się, że używasz dokładnego adresu URL MCP.
Wybrano niewłaściwe konto	Cofnij połączenie i zaloguj się ponownie, wybierając właściwe konto. Nie można przełączyć tokenu na inne konto.
Klient żąda `client_id`	Poproś administratora o utworzenie publicznej aplikacji dla konta i dodaj serwer MCP z parametrem `--oauth-client-id`.
Operacja jest niedostępna	Sprawdź przyznane zakresy uprawnień i własne uprawnienia dostępu użytkownika w Planfix.