Dokumentacja dla programistów

Kontroluj dostęp do MCP za pomocą własnej aplikacji OAuth

Aktualizacja 2026-10-08

Domyślnie połączenie asystenta AI, takiego jak Claude, z monday.com odbywa się przez nasz hostowany łącznik MCP. Użytkownicy klikają Połącz (Connect), logują się i gotowe. To najszybszy sposób na rozpoczęcie pracy, ale nie daje żadnego wyboru: po włączeniu łącznika każdy użytkownik, który może się zalogować, może połączyć się z dowolnego klienta obsługującego MCP. Połączenie dziedziczy przy tym pełne uprawnienia tego użytkownika w monday.com.

Jeśli Twoja organizacja potrzebuje ściślejszej kontroli - na przykład chce zezwolić tylko na Claude, a nie na inne narzędzia AI, ograniczyć dostęp do określonej grupy użytkowników albo kontrolować, jakie działania może wykonywać połączenie MCP - możesz zastąpić hostowany łącznik własną aplikacją OAuth. Zachowasz te same funkcje MCP, a jednocześnie zyskasz kontrolę nad tym, kto i co może się łączyć oraz jakie zakresy uprawnień dotyczą połączenia.

To również właściwe rozwiązanie, jeśli tworzysz integrację MCP przeznaczoną dla użytkowników lub udostępniasz ją prywatnie w swojej organizacji. Integracje publicznie dostępne powinny zamiast tego korzystać z dynamicznej rejestracji klientów.

W tym przewodniku znajdziesz instrukcje konfiguracji. Instrukcje dla konkretnych klientów znajdziesz tutaj:

Te same dane logowania działają z innymi klientami MCP obsługującymi niestandardowe łączniki OAuth.

Jak to działa

Zamiast korzystać ze wspólnego, hostowanego łącznika monday.com:

Rejestrujesz własną aplikację OAuth na platformie deweloperskiej monday.com i uzyskujesz identyfikator klienta (Client ID) oraz klucz tajny klienta (Client Secret).
Wyłączasz hostowany łącznik MCP dla swojego konta.
Przekazujesz dane logowania aplikacji tylko zatwierdzonym użytkownikom. Dodają oni monday.com jako niestandardowy łącznik w swoim agencie AI i wskazują ten sam punkt końcowy MCP.

Od tej pory połączenie kontroluje Twoja aplikacja, a nie wspólna, hostowana integracja.

Dlaczego warto to zrobić

Kontroluj zakresy uprawnień. Ustaw zakresy uprawnień OAuth dla swojej aplikacji - na przykład tylko boards:read albo bez dostępu do zapisu. Zakresy ograniczają działania, które może wykonywać połączenie MCP, nawet jeśli uwierzytelniony użytkownik ma szersze uprawnienia w monday.com.
Wybierz, kto może się łączyć. Połączenie mogą autoryzować tylko użytkownicy, którym przekazano identyfikator klienta i klucz tajny klienta. Pozostali nie uzyskają dostępu, nawet jeśli są zalogowani do monday.com.
Wybierz, co może się łączyć. Ogranicz dostęp do konkretnego klienta AI zamiast zezwalać na korzystanie z dowolnego narzędzia obsługującego MCP.
Odbieraj dostęp bez zakłóceń. Usuń dostęp pojedynczego użytkownika lub zmień klucz tajny klienta, aby odciąć dostęp wszystkim naraz - bez wpływu na pozostałe integracje.
Prowadź własny rejestr audytowy. Twoja aplikacja ma na platformie deweloperskiej własną listę autoryzowanych użytkowników i ich aktywności, niezależną od wspólnego, hostowanego łącznika.

Kompromis: Konfiguracja wymaga kilku dodatkowych kroków dla każdego użytkownika w porównaniu z połączeniem jednym kliknięciem. Musisz też bezpiecznie przechowywać i regularnie zmieniać klucz tajny klienta.

Konfiguracja

Krok 1: Utwórz aplikację OAuth w monday.com

Serwer monday MCP korzysta ze standardowego przepływu OAuth 2.0 Authorization Code Grant, w którym monday.com pełni rolę dostawcy tożsamości. To ten sam przepływ, którego używają wszystkie zewnętrzne integracje z API platformy.

Utwórz aplikację

Zaloguj się na swoje konto monday.com. Kliknij zdjęcie profilowe w prawym górnym rogu i wybierz Deweloperzy (Developers), aby otworzyć Centrum deweloperskie.
Kliknij + Utwórz aplikację (+ Create app) w prawym górnym rogu.
Wpisz Nazwę aplikacji (App Name) i Identyfikator aplikacji (App Slug), a następnie kliknij Utwórz aplikację (Create app).

Skonfiguruj ustawienia OAuth

Na lewym pasku bocznym w sekcji Tworzenie (Build) kliknij OAuth i uprawnienia (OAuth & Permissions).
Na karcie Zakresy (Scopes) wybierz tylko te zakresy uprawnień, których potrzebuje Twoja integracja. Ograniczają one działania, które może wykonywać połączenie MCP, nawet gdy użytkownik ma szersze uprawnienia w monday.com. Na czas testów dodaj wszystkie zakresy.
Przejdź na kartę Adresy URL przekierowania (Redirect URLs) i dodaj adres URL wywołania zwrotnego - adres, na który monday.com wysyła kody autoryzacyjne - a następnie kliknij Zapisz (Save).

Pobierz dane logowania

Na lewym pasku bocznym aplikacji przejdź do Ustawień ogólnych (General Settings).
Przewiń do sekcji Dane logowania aplikacji (App Credentials) i skopiuj Identyfikator klienta (Client ID) oraz Klucz tajny klienta (Client Secret).

UWAGA

Klucz tajny klienta jest poufny. Nigdy go nie udostępniaj ani nie umieszczaj w kodzie źródłowym, do którego inni mają dostęp. Jeśli kiedykolwiek zostanie ujawniony, możesz wygenerować nowy w ustawieniach aplikacji.

Krok 2: Wyłącz hostowany łącznik MCP

W ustawieniach administratora monday.com wyłącz wbudowany, hostowany łącznik MCP. To ważne: dopóki jest włączony, użytkownicy mogą ominąć Twoją aplikację i łączyć się dotychczasową metodą.

Krok 3: Dodaj niestandardowy łącznik do agenta

Skonfiguruj połączenie agenta AI z serwerem monday MCP za pomocą danych logowania aplikacji OAuth, a nie hostowanego łącznika z połączeniem jednym kliknięciem.

Możesz to zrobić na jeden z dwóch sposobów:

Skonfiguruj połączenie samodzielnie - jeśli tworzysz lub hostujesz własnego klienta MCP, przekaż adres URL serwera MCP oraz identyfikator i klucz tajny klienta do konfiguracji OAuth klienta. Informacje o działaniu uzgadniania tokenu znajdziesz w sekcji Przepływ autoryzacji (niestandardowi klienci MCP).
Użyj produktu obsługującego niestandardowe łączniki MCP - narzędzia takie jak Claude, ChatGPT, Copilot, Cursor i inni zgodni klienci MCP zazwyczaj umożliwiają dodanie nowego łącznika MCP i podanie danych logowania OAuth. Poszukaj ustawień takich jak Łączniki (Connectors), Niestandardowy łącznik (Custom connector) lub Dodaj serwer MCP (Add MCP server), a następnie wpisz:
Adres URL serwera MCP: https://mcp.monday.com/mcp
Identyfikator klienta OAuth i Klucz tajny klienta OAuth z kroku 1

Udostępniaj adres URL, identyfikator klienta i klucz tajny klienta tylko użytkownikom, którym chcesz przyznać dostęp.

Przykład: Claude

Zrzuty ekranu i instrukcje konfiguracji interfejsu Claude znajdziesz w artykule Integracja monday MCP z Claude przy użyciu aplikacji niestandardowej.

Przykład: Copilot Studio

Instrukcje konfiguracji narzędzia MCP w Copilot Studio, w tym adresy URL OAuth, URI przekierowania i zasady nazewnictwa, znajdziesz w artykule Integracja monday MCP z Copilot Studio przy użyciu aplikacji niestandardowej.

Krok 4: Sprawdź połączenie

Poproś jednego użytkownika o ukończenie przepływu OAuth i sprawdź, czy połączenie pojawia się w platformie deweloperskiej monday.com przy Twojej aplikacji, a nie przy hostowanym łączniku.

Przepływ autoryzacji (niestandardowi klienci MCP)

Jeśli tworzysz własnego klienta MCP, zamiast korzystać z interfejsu niestandardowego łącznika w produkcie, przepływ autoryzacji odbywa się zgodnie ze standardowym przepływem OAuth monday.com:

Klient MCP przekierowuje użytkownika na adres https://auth.monday.com/oauth2/authorize, przekazując identyfikator klienta.
Użytkownik zatwierdza wymagane zakresy uprawnień.
Klient wymienia kod autoryzacyjny na token dostępu.
Dołącz token dostępu w nagłówku Authorization żądań MCP:

Authorization: Bearer YOUR_ACCESS_TOKEN

Wszystkie wywołania narzędzi MCP są wykonywane w kontekście uwierzytelnionego użytkownika i ograniczone zarówno jego uprawnieniami na platformie, jak i zakresami włączonymi w aplikacji OAuth. Token MCP nie może przekroczyć żadnego z tych ograniczeń - nie przyznaje użytkownikowi uprawnień, których nie ma, ani nie umożliwia korzystania z uprawnień, o które aplikacja nie wystąpiła.

Które rozwiązanie wybrać?

Rozwiązanie	Najlepsze, gdy
Hostowany łącznik	Chcesz szybko wdrożyć rozwiązanie i akceptujesz, że każdy uwierzytelniony użytkownik może połączyć się z dowolnego klienta AI, korzystając ze wszystkich swoich uprawnień
Niestandardowa aplikacja OAuth	Chcesz ograniczyć działania MCP za pomocą zakresów aplikacji, precyzyjnie określić, kto może się łączyć, ograniczyć połączenie do konkretnego klienta albo niezależnie prowadzić rejestr audytowy i odbierać dostęp

Możesz korzystać z obu rozwiązań w swojej organizacji - na przykład używać hostowanego łącznika w ogólnych obszarach roboczych, a niestandardowej aplikacji w obszarach z poufnymi danymi.

Powiązane materiały:

Mam problem z tym tematem Źródło: developer.monday.com