Dokumentacja dla programistów

Dynamiczne połączenia

O API monday.comDokumentacja API
Aktualizacja 2026-10-22

Pozwól użytkownikom poprosić administratora o zatwierdzenie połączenia zewnętrznej usługi z ich kontem monday.com. Gdy wymagane jest zatwierdzenie administratora, połączenie nie zostanie nawiązane, dopóki administrator nie zaakceptuje prośby.

Wczesny dostęp. Ten proces jest dostępny we wczesnym dostępie. Istniejące tokeny dostępu mogą działać jeszcze przez maksymalnie 24 godziny po cofnięciu zgody przez administratora. Administratorzy nie otrzymują powiadomień e-mail o nowych prośbach. Sprawdzaj je ręcznie w sekcji Administracja monday (monday administration) → Łączniki (Connectors) → Łączniki dynamiczne (Dynamic Connectors).

Przegląd

Serwer MCP monday pozwala asystentom AI, agentom i innym klientom MCP pracować z danymi monday.com w imieniu uwierzytelnionego użytkownika.

Uprawnienie do hostowanego MCP (hosted MCP permission) włącza zestaw zatwierdzonych wcześniej agentów zewnętrznych, takich jak Claude i ChatGPT. Agenci ci łączą się w standardowy dla siebie sposób. Zobacz Zgodni klienci MCP.

Dynamiczne połączenia pozwalają administratorowi konta zatwierdzać dodatkowe połączenia i ich identyfikatory URI przekierowania. Niektórzy z tych klientów korzystają z dynamicznej rejestracji klienta (DCR), aby automatycznie zarejestrować klienta OAuth podczas łączenia.

Każdy deweloper może umożliwić klientom dodanie połączenia w ten sposób. Klient rozpoczyna łączenie, a administrator jego konta sprawdza identyfikatory URI przekierowania i zatwierdza połączenie dla konta. Po zatwierdzeniu użytkownicy przechodzą standardowy proces autoryzacji OAuth. Dopóki prośba czeka na zatwierdzenie, połączenie nie zostaje nawiązane.

Ten proces zatwierdzania rozszerza mechanizm DCR opisany w artykule Udostępnianie integracji MCP publicznie. We wczesnym dostępie ci klienci mogą zarejestrować się przez DCR i przejść do ekranu zatwierdzania. Użytkownicy proszą o zatwierdzenie połączenia przez administratora. Administrator konta sprawdza identyfikatory URI przekierowania i decyduje, czy zatwierdzić połączenie dla konta.

Zanim nawiążesz połączenie

Skonfiguruj klienta MCP zgodnie z instrukcjami z przewodnika Integracja z serwerem MCP monday:

  • Adres URL serwera: https://mcp.monday.com/mcp
  • Transport: HTTP ze strumieniowaniem
  • Uwierzytelnianie w tym procesie: OAuth 2.0 z DCR

Użytkownik nawiązujący połączenie musi też mieć dostęp do MCP na koncie.

Zatwierdzanie połączeń i dostęp do MCP to osobne ustawienia. Zatwierdzenie dynamicznego połączenia nie przyznaje użytkownikowi dostępu do MCP ani nie rozszerza jego dostępu do danych monday.com. Działania MCP nadal podlegają uprawnieniom uwierzytelnionego użytkownika.

Poproś o zatwierdzenie połączenia

  • Kliknij „Połącz” („Connect”) z monday.com w kliencie MCP.
  • Jeśli administrator nie zatwierdził wcześniej tego źródła jako połączenia dynamicznego, połączenie wymaga zatwierdzenia. Na ekranie autoryzacji pojawi się komunikat Wymagane zatwierdzenie administratora (Admin approval required). Sprawdź wyświetlone adresy URL przekierowania.

Dynamiczne połączenia - ilustracja 1

Wybierz Poproś o zatwierdzenie (Request approval).

Na ekranie pojawi się potwierdzenie Prośba wysłana do administratorów (Request sent to your admins). Skontaktuj się z administratorem i poinformuj go, że czeka na niego prośba.

Gdy administrator zatwierdzi prośbę, ponownie rozpocznij łączenie w kliencie MCP.

Sprawdź ekran autoryzacji i wybierz Autoryzuj (Authorize), aby dokończyć łączenie.

Dynamiczne połączenia - ilustracja 2

Dopóki prośba czeka na zatwierdzenie, połączenie nie zostaje nawiązane. Po zatwierdzeniu przez administratora połącz się ponownie i dokończ autoryzację.

Brak powiadomień e-mail we wczesnym dostępie. Wysłana prośba pojawi się na stronie administracji. Administratorzy mogą ją sprawdzić w sekcji Administracja monday → Łączniki → Łączniki dynamiczne → Oczekujące prośby (Pending requests).

Jeśli nie możesz wybrać opcji Poproś o zatwierdzenie ze względu na swoją rolę, skontaktuj się z administratorem. To, czy możesz wysłać nową prośbę, zależy od uprawnień przypisanych do Twojej roli. Nie wpływają one na możliwość korzystania z już zatwierdzonego połączenia, o ile masz wymagane uprawnienia do MCP i danych.

Na kontach, na których użytkownicy nie mogą prosić o zatwierdzenie, ekran będzie wyglądać tak:

Dynamiczne połączenia - ilustracja 3

Nawiąż połączenie jako administrator konta

Administrator konta może zatwierdzić nowe połączenie bezpośrednio na ekranie autoryzacji. Ekran informuje, że wybranie opcji Autoryzuj spowoduje również zatwierdzenie połączenia dla konta.

Przed autoryzacją sprawdź połączenie i jego adres URL przekierowania. Jeśli administrator wcześniej odrzucił połączenie, ponownie otwórz jego prośbę w panelu administracyjnym, zanim spróbujesz jeszcze raz.

Dynamiczne połączenia - ilustracja 4

Sprawdzaj połączenia i zarządzaj nimi

Otwórz Administracja monday → Łączniki → Łączniki dynamiczne.

Sprawdź oczekujące prośby

  1. Wybierz Oczekujące prośby.
  2. Sprawdź domenę połączenia, pełne adresy URL wywołania zwrotnego i podsumowanie dostępu.
  3. Wybierz Zatwierdź (Approve), aby zezwolić na połączenie, lub Odrzuć (Reject), aby odrzucić prośbę.
  4. Poinformuj osobę, która wysłała prośbę, o decyzji. Po zatwierdzeniu musi ponownie połączyć się z poziomu klienta MCP i dokończyć autoryzację.

Domena połączenia i adresy URL wywołania zwrotnego wskazują, dokąd zostanie wysłana odpowiedź na logowanie OAuth. Sprawdź, czy zgadzają się z usługą, którą chcesz zatwierdzić.

Zarządzaj istniejącymi zatwierdzeniami

Karta Połączenia (Connections) pokazuje rozpatrzone prośby i ich status. Użyj menu działań danego połączenia, aby nim zarządzać:

Status lub zmiana Dostępne działanie
Aktywne połączenie Cofnij dostęp (Revoke access)
Odrzucona prośba Otwórz ponownie prośbę (Reopen request), a następnie sprawdź ją ponownie
Połączenie z cofniętym dostępem Przywróć dostęp (Restore access)
Zatwierdzone połączenie z dodatkowymi adresami URL wywołania zwrotnego Zatwierdź nowe adresy URL (Approve new URLs)

Zatwierdzenie obejmuje dokładnie te adresy URL wywołania zwrotnego, które są wymienione dla połączenia na Twoim koncie. Każdy nowy adres URL wymaga zatwierdzenia, nawet jeśli domena została już wcześniej zatwierdzona. Nowe adresy URL są oznaczone jako Nowy (New), a przy połączeniu może pojawić się status Nowy adres URL oczekuje na zatwierdzenie (New URL pending).

Dynamiczne połączenia - ilustracja 5

Istniejące, zatwierdzone adresy URL wywołania zwrotnego pozostają zatwierdzone, gdy dodatkowe adresy czekają na sprawdzenie.

Wybierz, kto może prosić o zatwierdzenie połączeń zewnętrznych

W sekcji Prośby o połączenie (Connector requests) wybierz, kto może prosić o zatwierdzenie dodatkowych połączeń zewnętrznych. W planie Enterprise użyj opcji edycji, aby wybrać role konta, które mogą wysyłać prośby. Możesz uwzględnić także role niestandardowe.

Domyślnie członkowie mogą prosić o zatwierdzenie. Osoby przeglądające i goście nie mogą tego robić. Administratorzy konta mogą zatwierdzać połączenia bezpośrednio, a tego uprawnienia nie można wyłączyć za pomocą tego ustawienia.

W planach, które nie umożliwiają dostosowywania ról, obowiązują domyślne uprawnienia. To samo uprawnienie do wysyłania próśb jest dostępne również w uprawnieniach konta w panelu administracyjnym jako Poproś o zatwierdzenie aplikacji innych firm (Request approval for third-party apps).

Zmiana uprawnień do wysyłania próśb wpływa na nowe prośby i możliwość automatycznego zatwierdzania. Połączenia już zatwierdzone dla konta pozostają dostępne, z uwzględnieniem dostępu poszczególnych użytkowników do MCP i ich dotychczasowych uprawnień w monday.com.

Skonfiguruj automatyczne zatwierdzanie i połączenia lokalne

Ustawienie Działanie
Automatycznie zatwierdzaj nowe połączenia dynamiczne (niebezpieczne, używaj tylko podczas programowania) (Auto-approve new dynamic connectors (dangerous, use only for development)) Pozwala użytkownikom z uprawnieniem do wysyłania próśb łączyć się z nowymi połączeniami bez indywidualnego sprawdzania przez administratora. Połączenia nawiązane przez automatyczne zatwierdzanie nie są zapisywane na liście „Połączenia”.
Zezwalaj na połączenia hostowane lokalnie (Allow locally hosted connectors) Określa, czy można używać połączeń działających na urządzeniu użytkownika, które korzystają z lokalnych adresów wywołania zwrotnego. Takie połączenia są zarządzane jako kategoria, a nie zatwierdzane pojedynczo.

Automatyczne zatwierdzanie może nadal zezwalać na połączenie po cofnięciu jego indywidualnego zatwierdzenia. Wyłącz tę opcję, jeśli chcesz, by każde połączenie wymagało osobnego zatwierdzenia administratora.

Zrozum komunikaty na ekranie zatwierdzania

Komunikat Co zrobić
Wymagane zatwierdzenie administratora Sprawdź połączenie i wybierz Poproś o zatwierdzenie, jeśli ta opcja jest dostępna.
Prośba wysłana do administratorów lub Prośba oczekuje na rozpatrzenie (Request pending) Skontaktuj się z administratorem i poczekaj na rozpatrzenie prośby. Po jej zatwierdzeniu połącz się ponownie z poziomu klienta MCP.
Prośba odrzucona (Request declined) Administrator odrzucił połączenie. Jeśli chcesz ponownie rozpatrzyć prośbę, skontaktuj się z nim.
Dostęp cofnięty (Access revoked) Skontaktuj się z administratorem, aby ponownie zatwierdził połączenie.
Niedostępne dla Twojej roli (Not available for your role) Twoja rola nie pozwala wysłać prośby o zatwierdzenie. Poproś administratora o sprawdzenie uprawnień przypisanych do Twojej roli.
Adres URL przekierowania wymaga ponownego zatwierdzenia (Redirect URL needs re-approval) Połączenie używa adresu URL wywołania zwrotnego, który nie został zatwierdzony. Poproś o zatwierdzenie nowego adresu URL.
Aplikacje lokalne są zablokowane (Local applications blocked) Ustawienia konta blokują połączenia lokalne. Skontaktuj się z administratorem.
Wygląda na to, że nie masz jeszcze dostępu (It looks like you don't have access yet) Użytkownik musi mieć dostęp do MCP na koncie. Zatwierdzenie dynamicznego połączenia nie przyznaje tego dostępu.

Powiadomienie o źródle pokazuje adresy URL przekierowania połączenia zewnętrznego, wyróżnia jego domenę i oznacza nowy adres URL, aby przed kontynuowaniem można było sprawdzić miejsce docelowe.

Ograniczenia wczesnego dostępu

Cofnięcie dostępu zaczyna obowiązywać przy odświeżeniu tokenu

Gdy administrator cofnie wcześniej udzieloną zgodę na połączenie, istniejące tokeny dostępu nie zostaną unieważnione od razu.

Zgoda jest sprawdzana ponownie przy kolejnym odświeżeniu tokenu. Jeśli zasady konta nie zezwalają już na dane połączenie, odświeżenie zostanie odrzucone. Istniejący token dostępu może działać do momentu wygaśnięcia, czyli maksymalnie 24 godziny po cofnięciu zgody.

Na przykład jeśli administrator cofnie zgodę tuż po wydaniu tokenu, połączenie może korzystać z niego jeszcze przez prawie 24 godziny. We wczesnym dostępie cofnięcie zgody zaczyna więc obowiązywać przy odświeżeniu tokenu.

Administratorzy muszą ręcznie sprawdzać prośby

Obecnie administratorzy nie otrzymują powiadomień e-mail o nowych prośbach o zatwierdzenie. Sprawdzaj ręcznie sekcję Administracja monday → Łączniki → Łączniki dynamiczne → Oczekujące prośby, w tym nowe adresy URL wywołania zwrotnego dodane do istniejących połączeń.

Informacje dla deweloperów klientów MCP

Możesz udostępnić klienta MCP i umożliwić klientom dodanie połączenia. Pomyślna rejestracja przez DCR rejestruje klienta. Administrator konta klienta zatwierdza połączenie i jego identyfikatory URI przekierowania na ekranie autoryzacji monday.com. Użytkownik kończy autoryzację po uzyskaniu zatwierdzenia.

To rozszerzenie korzysta ze standardowego procesu wykrywania OAuth, DCR i autoryzacji z użyciem kodu PKCE opisanego w artykule Udostępnianie integracji MCP publicznie. Zatwierdzenie przez administratora konta odbywa się podczas autoryzacji OAuth, po rejestracji klienta.

Zatwierdzenie konta i autoryzacja użytkownika muszą zostać zakończone, zanim zostaną wydane tokeny dostępu. Jeśli zatwierdzenie jest wymagane, prośbą zajmuje się ekran autoryzacji monday.com. Po uzyskaniu zatwierdzenia użytkownik musi rozpocząć nowe łączenie z poziomu klienta.

Dbaj o to, by adresy URL wywołania zwrotnego pozostawały niezmienne. Dodanie lub zmiana adresu URL może spowodować ponowne sprawdzenie połączenia. Jeśli odświeżenie tokenu zwróci błąd invalid_grant, ponieważ połączenie nie jest już zatwierdzone, poproś użytkownika, aby skontaktował się z administratorem konta.

Zatwierdzenie konta zezwala na dodatkowe połączenie i jego identyfikatory URI przekierowania na tym koncie. Agenci zewnętrzni zatwierdzeni wcześniej są objęci uprawnieniem do hostowanego MCP i korzystają ze standardowego dla siebie procesu łączenia.


Powiązane materiały: