Dokumentacja dla programistów›O API monday.com›Utwórz pulpit (Platform MCP)
Dokumentacja dla programistów

Utwórz pulpit (Platform MCP)

O API monday.comDokumentacja API
Aktualizacja 2026-09-06

Użyj tego narzędzia, aby utworzyć nowy pulpit w swoim obszarze roboczym monday.com. Pulpity to wizualne kontenery, które prezentują dane z tablic za pomocą widżetów - wykresów, liczników, osi czasu i innych elementów. Podczas tworzenia pulpitu musisz połączyć z nim co najmniej jedną tablicę (maksymalnie 50). Wszystkie dodane później widżety będą pobierać dane z połączonych tablic.

Po utworzeniu pulpitu użyj create_widget, aby dodać do niego wizualizacje. Najpierw użyj all_widgets_schema, aby sprawdzić dostępne typy widżetów i wymagane dla nich ustawienia.

Parametry

Parametr Typ Wymagane Opis
name string Tak Czytelna dla użytkownika nazwa pulpitu (znaki UTF-8).
workspace_id string Tak ID obszaru roboczego, do którego będzie należeć pulpit. Aby znaleźć identyfikatory obszarów roboczych, użyj list_workspaces lub workspace_info.
board_ids array Tak Lista identyfikatorów tablic (zapisanych jako ciągi znaków), które mają zostać połączone z pulpitem. Wymagane jest co najmniej 1, a maksymalnie można dodać 50. Wszystkie widżety na tym pulpicie będą pobierać dane z tych tablic.
kind string Nie Poziom widoczności: PUBLIC lub PRIVATE. Domyślnie ustawiona jest wartość PUBLIC.
board_folder_id string Nie Identyfikator folderu w obszarze roboczym, w którym ma się znaleźć pulpit. Jeśli go nie podasz, pulpit zostanie umieszczony w katalogu głównym obszaru roboczego.

Przykład

Utwórz publiczny pulpit połączony z tablicą do śledzenia projektów w obszarze roboczym 12406666:

{
  "name": "MCP Docs Test Dashboard",
  "workspace_id": "12406666",
  "board_ids": ["18394529013"],
  "kind": "PUBLIC"
}

Narzędzie zwróciło identyfikator pulpitu 37055164 i potwierdziło nazwę MCP Docs Test Dashboard. Pulpit jest już dostępny w obszarze roboczym i można dodawać do niego widżety.


Odpowiednik programistyczny

Aby uzyskać ten sam efekt, użyj GraphQL API:

mutation {
  create_board(
    board_name: "MCP Docs Test Dashboard"
    board_kind: public
    workspace_id: 12406666
    board_type: dashboard
  ) {
    id
    name
    url
  }
}

Pełną dokumentację znajdziesz w sekcji Tablice.