monday.com zapewnia pełny dostęp do swojej platformy bez interfejsu graficznego za pośrednictwem serwerów MCP, interfejsu GraphQL API i typowanych SDK. Każde narzędzie AI zgodne z MCP może połączyć się z platformą natywnie.

Na tej stronie opisujemy możliwości platformy, sposób współdziałania jej elementów oraz informacje dotyczące uwierzytelniania, limitów zapytań i tworzenia kont agentów.

monday.com to elastyczna platforma pracy z AI, która obejmuje zarządzanie projektami, CRM, programowanie i obsługę klienta. Korzysta z niej ponad 250 000 organizacji. Platforma opiera się na elastycznym modelu danych obejmującym tablice, elementy i kolumny, udostępnia pełny interfejs GraphQL API i zawiera natywną warstwę AI do obsługi agentów, przepływów pracy i pracy wspomaganej przez AI.

Przegląd architektury

monday.com udostępnia dwa serwery MCP, które obsługują różne etapy cyklu pracy dewelopera, a także bezpośredni dostęp do API na potrzeby zaawansowanych zastosowań.

	Platform MCP	Apps MCP
Cel	Odczytywanie i zapisywanie danych monday.com	Zarządzanie aplikacjami monday.com
Możliwości	Wyszukiwanie tablic, tworzenie elementów, aktualizowanie kolumn, zarządzanie użytkownikami, wykonywanie zapytań GraphQL	Szkieletowanie aplikacji, tworzenie funkcji, wdrażanie, promowanie wersji, przeszukiwanie dokumentacji dla deweloperów
Transport	Hostowany zdalnie (Streamable HTTP)	Lokalnie przez npx
Uwierzytelnianie	OAuth 2.1	Osobisty token API
Konfiguracja	"url": "https://mcp.monday.com/mcp"	npx @mondaydotcomorg/monday-api-mcp -t <token> --mode apps

Platform MCP to główny interfejs integracji. Opiera się na interfejsie monday.com GraphQL API i udostępnia uporządkowane narzędzia do typowych operacji. Apps MCP jest przeznaczony do tworzenia aplikacji. Obsługuje cały cykl ich życia i umożliwia wyszukiwanie semantyczne w całej dokumentacji dla deweloperów monday.com.

Oba serwery mogą działać jednocześnie w tej samej sesji IDE. Platform MCP obsługuje dane, a Apps MCP - kod.

Bezpośredni dostęp do API

W zastosowaniach wymagających pełnego zakresu API - takich jak operacje zbiorcze, złożone zagnieżdżone zapytania lub bezpośrednie sprawdzanie schematu - można bezpośrednio korzystać z interfejsu monday.com GraphQL API:

curl -X POST https://api.monday.com/v2 \
  -H "Authorization: <your_token>" \
  -H "Content-Type: application/json" \
  -H "API-Version: 2026-07" \
  -d '{"query": "{ boards (limit: 5) { id name } }"}'

Platform MCP obsługuje też wykonywanie surowych zapytań GraphQL za pomocą narzędzia all_monday_api. Wersją API można sterować przez nagłówki konfiguracyjne MCP.

---

Łączenie z monday.com

Łączenie zewnętrznych agentów

Możesz dodać własnego agenta do monday.com jako pełnoprawnego uczestnika. Połączone agenty uwierzytelniają się za pomocą własnego tokenu API i działają w zakresie uprawnień przyznanych przez administratora konta.

Obsługiwane tryby połączenia:

Zarządzany dostawca (np. Claude Managed Agent) - podaj klucz API i identyfikator agenta. monday.com koordynuje wywołania dostawcy i udostępnia agentowi narzędzia platformy (tablice, elementy, aktualizacje itd.) - te same możliwości, które mają wbudowani agenci.

Własny agent (webhook) - podaj URL zwrotny. monday.com wysyła do Twojego punktu końcowego dane zdarzenia, aby uruchomić agenta (za pomocą automatyzacji lub przypisania). Agent przetwarza dane i odpowiada, wykonując działania. Pełny opis obsługi webhooków, weryfikacji podpisu i odpowiadania na czacie znajdziesz w przewodniku Tworzenie zewnętrznego agenta.

Połączone agenty:

• Można przypisywać do elementów i wspominać o nich w aktualizacjach.
• Mogą mieć dostęp do obszarów roboczych i tablic konfigurowany przez administratora.
• Korzystają z kredytów AI, których zużycie jest widoczne na pulpicie użycia konta.
• Podlegają uprawnieniom na poziomie konta, którymi zarządzają administratorzy.

Platform MCP

Hostowany Platform MCP nie wymaga lokalnej konfiguracji. Dodaj adres URL serwera i uwierzytelnij się przez OAuth, gdy pojawi się odpowiedni monit.

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

Instrukcje konfiguracji dla poszczególnych klientów znajdziesz w omówieniu MCP. Zawiera ono konfiguracje dla Cursor, Claude, VS Code, ChatGPT, Copilot Studio, Mistral, Gemini CLI, Perplexity i Figma Make.

Apps MCP (lokalnie)

Aby dodać funkcje do tworzenia aplikacji, uruchom Apps MCP razem z Platform MCP:

{
  "mcpServers": {
    "monday-apps-mcp": {
      "command": "npx",
      "args": ["@mondaydotcomorg/monday-api-mcp", "-t", "<your_token>", "--mode", "apps"]
    }
  }
}

Pełną listę narzędzi znajdziesz w dokumentacji Apps MCP.

---

Możliwości platformy

Model danych

monday.com organizuje pracę w następującej hierarchii: Obszary robocze > Tablice > Grupy > Elementy > Podelementy. Każdy element ma wartości kolumn określonego typu. Interfejs API i narzędzia MCP działają w obrębie całej tej hierarchii.

Narzędzia Platform MCP

Obszar	Operacje
Tablice	Tworzenie, wyszukiwanie, duplikowanie, pobieranie schematu (kolumn, grup, ustawień)
Elementy	Tworzenie, aktualizowanie wartości kolumn, przenoszenie między grupami, wyszukiwanie z użyciem filtrów
Kolumny	Tworzenie, pobieranie informacji o typie (schemat JSON i reguły walidacji)
Użytkownicy i zespoły	Wyświetlanie listy, wyszukiwanie uprawnień
Dokumenty	Tworzenie, odczytywanie i aktualizowanie WorkDocs
Wyszukiwanie	Wyszukiwanie tablic, dokumentów i folderów na koncie
Powiadomienia	Tworzenie powiadomień dla użytkowników
Aktualizacje	Publikowanie i odczytywanie aktualizacji elementów (komentarzy)
Obszary robocze	Tworzenie, wyświetlanie listy, zarządzanie
GraphQL	Wykonywanie dowolnych zapytań i mutacji za pomocą narzędzia all_monday_api

Wartości kolumn używają typowanego formatu JSON. W przypadku nieznanych typów narzędzie get_column_type_info zwraca oczekiwany schemat i reguły walidacji. Pełną dokumentację znajdziesz w opisie typów kolumn.

Pełny katalog narzędzi znajdziesz na stronie Dostępne narzędzia monday MCP.

Narzędzia Apps MCP

Obszar	Operacje
Zarządzanie aplikacjami	Tworzenie aplikacji, wyświetlanie ich listy i pobieranie wersji
Funkcje	Tworzenie funkcji (widoków tablicy, widżetów, integracji, własnych kolumn i bloków przepływu pracy)
Wdrażanie	Sprawdzanie stanu wdrożenia, promowanie wersji
Środowisko	Ustawianie i wyświetlanie listy zmiennych środowiskowych
Pamięć	Wyszukiwanie i eksportowanie danych z pamięci aplikacji
Dokumentacja	Wyszukiwanie semantyczne w całej dokumentacji dla deweloperów - funkcjach aplikacji, OAuth, SDK, Vibe Design System, monday-code i blokach przepływu pracy

Umiejętności agentów

monday.com udostępnia oficjalne umiejętności agentów, które uczą agentów obsługujących umiejętności - takich jak Claude Code, Cursor, Codex i OpenCode - prawidłowej pracy z monday.com, w tym z tablicami, elementami, dokumentami i formularzami, za pośrednictwem Platform MCP.

Zainstaluj wszystkie umiejętności:

Przejrzyj umiejętności i kod źródłowy w serwisie [GitHub](https://github.com/mondaycom/skills).

Umiejętności działają za pośrednictwem Platform MCP (`https://mcp.monday.com/mcp`, uwierzytelnianie przez OAuth), dlatego najpierw skonfiguruj ten serwer.

***

# Tworzenie kont agentów

Zewnętrzne agenty mogą programowo tworzyć konta monday.com za pomocą dedykowanego API rejestracji - bez użycia przeglądarki.

Pełną specyfikację opublikowano jako umiejętność agenta: <a href="https://monday.com/.well-known/agent-skills/signup-for-agents/SKILL.md" target="_blank">umiejętność rejestracji agentów monday.com</a>

## Przegląd procesu

Step 1: POST /signup-logic/agent-captcha/challenge/v1 -> get challengeToken Step 2: POST /signup-logic/agent-captcha/verify/v1 -> solve challenge, get verificationToken Step 3: POST /signup-logic/agent-signup/account/v1 -> create account, receive api_token Step 4: Use api_token with monday.com API -> create boards, items, invite members

**Podstawowy adres URL:** `https://signup-logic.monday.com`

## Najważniejsze zasady działania

* **Captcha HATCHA** - zadania dostosowane do agentów (konwersja z systemu binarnego na ASCII, odwracanie ciągów znaków, liczenie, sortowanie i działania matematyczne). Można je rozwiązać programowo w mniej niż 30 sekund.
* **Akceptacja warunków** - pole `agreed_to_terms: true` jest wymagane. Jeśli go zabraknie, API zwróci błąd z linkiem do warunków.
* **Obsługa adresu e-mail** - pomiń adres e-mail, aby otrzymać automatycznie wygenerowany adres `@monday-agent.com` (konto będzie od razu aktywne). Podaj prawdziwy adres e-mail, aby rozpocząć proces potwierdzania.
* **Odpowiedź** zawiera `api_token` (JWT z zakresem `me:write`), `account_url`, `board_id` automatycznie utworzonej tablicy oraz `skill_url` z instrukcjami korzystania z API.
* **Typ użytkownika** - konta są oznaczane jako `agent_signup_user`, co umożliwia stosowanie odrębnych zasad i analiz.

## Limity zapytań (rejestracja)

Na punkcie końcowym tworzenia konta obowiązuje limit 15 zapytań na 60 sekund z jednego adresu IP.

## Po utworzeniu konta

Agent otrzymuje token API i może od razu:

* Tworzyć tablice i elementy za pomocą [interfejsu GraphQL API](https://developer.monday.com/api-reference/reference).
* Zapraszać współpracowników za pomocą mutacji `invite_users` / `add_subscribers_to_board`.
* Łączyć się z [Platform MCP](doc:mondaycom-mcp), aby korzystać z uporządkowanego dostępu do narzędzi.

***

# Dokumentacja w formacie do odczytu maszynowego

## /llms.txt

Uporządkowany indeks całej dokumentacji dla deweloperów: <a href="https://developer.monday.com/llms.txt" target="_blank">developer.monday.com/llms.txt</a>. Narzędzia AI korzystają z niego, aby znajdować strony API, przewodniki i dokumentację bez przeszukiwania całej witryny.

## Markdown w postaci zwykłego tekstu

Dodaj `.md` do dowolnego adresu URL dokumentacji, aby pobrać czytelny kod Markdown:

https://developer.monday.com/api-reference/docs/build-on-monday-with-ai.md

## Wyszukiwanie semantyczne przez Apps MCP

Narzędzie `get_development_context` umożliwia wyszukiwanie z użyciem AI w całej dokumentacji dla deweloperów monday.com. Obejmuje funkcje [aplikacji](https://developer.monday.com/apps/docs/app-features), [zakresy OAuth](https://developer.monday.com/apps/docs/oauth), dokumentację SDK, [monday-code](https://developer.monday.com/apps/docs/monday-code-intro), Vibe Design System, [bloki przepływu pracy](https://developer.monday.com/apps/docs/workflows-triggers) i wskazówki dotyczące rozwiązywania problemów.

***

# Uwierzytelnianie i bezpieczeństwo

## OAuth 2.1

Platform MCP korzysta z OAuth 2.0 Authorization Code Grant. Dostawcą tożsamości jest monday.com.

1. Klient MCP przekierowuje użytkownika do `https://auth.monday.com/oauth2/authorize`.
2. Użytkownik zatwierdza wymagane [zakresy uprawnień](https://developer.monday.com/apps/docs/oauth#set-up-permission-scopes).
3. Klient wymienia kod autoryzacyjny na token dostępu.

Wszystkie wywołania narzędzi MCP są wykonywane w kontekście uwierzytelnionego użytkownika i podlegają jego uprawnieniom na platformie. Nie można uzyskać wyższych uprawnień.

## Strategia tokenów

* **Tokeny osobiste** odzwierciedlają uprawnienia użytkownika w interfejsie. Używaj ich podczas indywidualnego tworzenia rozwiązań.
* **Tokeny aplikacji** mają jawnie określone zakresy uprawnień (np. `boards:read`, `boards:write`). Używaj ich w aplikacjach produkcyjnych i agentach, które powinny mieć tylko niezbędne uprawnienia.
* Za zarządzanie cyklem życia tokenu (przechowywanie, rotację i unieważnianie) odpowiada deweloper.

## Model bezpieczeństwa

Cała komunikacja odbywa się przez TLS. Izolacja sesji użytkowników zapobiega wyciekowi kontekstu między klientami. Narzędzia MCP są definiowane i kontrolowane przez monday.com - klienci nie mogą ich modyfikować. Serwer MCP nie przechowuje ani nie zapisuje w logach tokenów OAuth. Szczegóły znajdziesz w [omówieniu bezpieczeństwa MCP](doc:monday-mcp-security-overview).

***

# Limity zapytań

Na platformie monday.com obowiązują następujące [limity zapytań](doc:rate-limits).

## Limity zależne od planu

| Limit                 | Free           | Pro            | Enterprise     |
| :-------------------- | :------------- | :------------- | :------------- |
| Złożoność            | 5M punktów/min  | 5M punktów/min  | 5M punktów/min  |
| Złożoność dla agentów | 20M punktów/min | 20M punktów/min | 20M punktów/min |
| Dzienne wywołania           | 1,000          | 10,000         | 25,000         |
| Zapytania/minutę        | 1,000          | 2,500          | 5,000          |
| Równoczesne żądania           | 40             | 100            | 250            |
| Limit dla adresu IP               | 5,000 żądań/10 s  | 5,000 żądań/10 s  | 5,000 żądań/10 s  |

Odczyty i zapisy mają osobne limity złożoności. Limit złożoności jest odnawiany w kroczącym 60-sekundowym oknie.

Agenci mogą mieć wyższe limity niż standardowy dostęp do API. Jeśli Twoje zastosowanie tego wymaga, skontaktuj się z pomocą techniczną.

## Złożoność w praktyce

Typowe zapytanie `items` obejmujące 10 kolumn i 50 elementów kosztuje kilka tysięcy punktów złożoności - znacznie mniej niż limit 5M na minutę. Dodaj pole `complexity` do dowolnego zapytania, aby sprawdzić dokładny koszt:

```graphql GraphQL
mutation {
  complexity {
    query
    before
    after
  }
  create_item(board_id: 1234567890, item_name: "test item") {
    id
  }
}

Automatyczne ponawianie prób w SDK

Zarówno SDK JavaScript (@mondaydotcomorg/api), jak i SDK Python (monday-api-python-sdk) automatycznie obsługują limity zapytań:

• HTTP 429: odczekuje i ponawia próbę.
• Błędy złożoności: czeka i ponawia próbę.
• Można skonfigurować maksymalną liczbę prób (domyślnie 4 w Pythonie).
• Uwzględnia nagłówki Retry-After.