Ten przewodnik pokazuje, jak połączyć własnego klienta MCP - asystenta AI, platformę agentową lub funkcję produktu - z hostowanym serwerem MCP monday.com. Wybierz metodę uwierzytelniania i skorzystaj z powiązanego przewodnika, aby skonfigurować połączenie.

Przegląd

Hostowany serwer MCP to zalecany sposób łączenia się z monday.com. Nie wymaga lokalnej konfiguracji, aktualizuje się automatycznie i obsługuje całą infrastrukturę.

• Adres serwera: https://mcp.monday.com/mcp
• Transport: Streamable HTTP
• Uwierzytelnianie: OAuth 2.0 lub token Bearer z osobistym tokenem API

Wybór metody uwierzytelniania

Metoda uwierzytelniania zależy od tego, co tworzysz:

Zastosowanie	Przewodnik	Czy wymagana jest rejestracja
Użytek osobisty i testowanie	Uwierzytelnianie za pomocą tokena API	Nie
Dostęp prywatny lub kontrolowany przez organizację (kontrola nad tym, kto się łączy, z którego klienta korzysta i które zakresy uprawnień ograniczają działania MCP)	Kontrolowanie dostępu MCP za pomocą własnej aplikacji OAuth	Nie
Integracja dostępna publicznie	Udostępnianie integracji publicznie (DCR)	Tak - zarejestruj integrację

---

Konfiguracja zaawansowana

Określanie wersji API

Serwer MCP wykonuje wywołania narzędzi za pomocą interfejsu GraphQL API monday.com. Możesz przypiąć konkretną wersję API, używając nagłówka Api-Version:

{
  "mcpServers": {
    "monday-mcp": {
      "url": "https://mcp.monday.com/mcp",
      "headers": {
        "Api-Version": "2026-07"
      }
    }
  }
}

Dostępne narzędzia

Serwer MCP monday.com udostępnia ponad 60 narzędzi do odczytu i zapisu danych monday.com. Aby wyświetlić wszystkie dostępne narzędzia i ich aktualne parametry, użyj polecenia MCP tools/list lub zapoznaj się z dokumentacją narzędzi Platform MCP.

Zestaw narzędzi może się z czasem zmieniać - narzędzia mogą być dodawane, aktualizowane lub wycofywane. Używaj tools/list, aby mieć pewność, że Twój klient korzysta z aktualnych schematów.

Limity liczby żądań

Wywołania narzędzi MCP są wliczane do dziennego limitu wywołań API na Twoim koncie, tak samo jak bezpośrednie żądania API. Uwzględnij to w procesach agentowych, które mogą wykonywać wiele wywołań.

---

Zabezpieczenia i uprawnienia

• Dostęp przypisany do użytkownika: Wszystkie działania wykonywane przez MCP są przypisywane do użytkownika, który autoryzował dostęp. Dostęp zależy od uprawnień tego użytkownika w monday.com - użytkownicy mogą korzystać tylko z tych obszarów roboczych, tablic i elementów, do których mają już dostęp.
• Bezpieczeństwo tokenów: Przechowuj bezpiecznie sekrety klienta i wszystkie tokeny (nigdy nie umieszczaj ich w systemie kontroli wersji), używaj HTTPS we wszystkich żądaniach, prawidłowo odnawiaj tokeny i unieważniaj je, gdy nie są już potrzebne.
• Brak przechowywania tokenów: Serwer MCP nie przechowuje ani nie rejestruje tokenów OAuth klientów. Za zarządzanie cyklem życia tokenów - ich przechowywanie, rotację i unieważnianie - odpowiadasz Ty.

Pełny opis architektury zabezpieczeń - izolację tenantów, zagrożenia na poziomie AI i zgodność z OWASP MCP Top 10 - znajdziesz w omówieniu zabezpieczeń MCP.

---

Częste problemy

Problemy z uwierzytelnianiem

1. Sprawdź, czy adres URL przekierowania jest dokładnie taki sam w ustawieniach aplikacji i żądaniu autoryzacji.
2. Upewnij się, że identyfikator klienta i jego klucz tajny są poprawne.
3. Sprawdź, czy wymagane zakresy uprawnień są włączone na stronie aplikacji OAuth i uprawnienia (OAuth & Permissions).

Problemy z połączeniem

1. Sprawdź, czy adres URL serwera MCP to https://mcp.monday.com/mcp, a nie https://mcp.monday.com/sse - SSE jest przestarzały i nieobsługiwany.
2. Sprawdź, czy w nagłówku Authorization został podany prawidłowy token dostępu lub token API.
3. Sprawdź, czy token dostępu nie wygasł.
4. Jeśli konfiguracja klienta używa mcp-remote z adresem URL /sse, zastąp ją bezpośrednią konfiguracją Streamable HTTP wskazującą na https://mcp.monday.com/mcp.

---

Powiązane materiały:

• Uwierzytelnianie za pomocą tokena API
• Kontrolowanie dostępu MCP za pomocą własnej aplikacji OAuth
• Udostępnianie integracji publicznie (DCR)
• Kompatybilni klienci MCP
• Dokumentacja narzędzi Platform MCP
• Omówienie zabezpieczeń MCP
• Dokumentacja OAuth