Lista obszarów roboczych (Platform MCP)
Użyj tego narzędzia, aby pobrać listę obszarów roboczych dostępnych dla bieżącego użytkownika. Zwykle jest to pierwszy krok w każdym procesie, który dotyczy obszarów roboczych - ich identyfikator jest potrzebny do tworzenia folderów, pobierania zawartości obszaru roboczego lub przenoszenia obiektów. Narzędzie obsługuje stronicowanie i opcjonalne filtrowanie tekstem.
Uwaga: Wyniki są ograniczone do 100 obszarów roboczych na stronę. Jeśli na Twoim koncie jest ich więcej niż 100, użyj parametru page, aby pobrać całą listę. Filtr searchTerm obsługuje wyłącznie znaki alfanumeryczne.
Parametry
| Parametr | Typ | Wymagane | Opis |
|---|---|---|---|
| searchTerm | string |
Nie | Filtruje wyniki i zwraca obszary robocze, których nazwa pasuje do wyszukiwanego terminu. Obsługiwane są wyłącznie znaki alfanumeryczne. |
| limit | number |
Nie | Liczba obszarów roboczych zwracanych na stronę. Min.: 1, maks.: 100, domyślnie: 100. Ustaw mniejszą wartość, aby otrzymać krótszą odpowiedź. |
| page | number |
Nie | Numer strony do zwrócenia. Domyślnie: 1. Zwiększaj tę wartość, aby przeglądać długie listy obszarów roboczych. |
Przykład
Pobierz pierwszych 20 obszarów roboczych:
{
"limit": 20
}
Odpowiedź zawiera id, name, description (jeśli ustawiono) i url każdego obszaru roboczego. Na przykład obszar roboczy 12406666 zwrócił:
{
"id": "12406666",
"name": "MCP TEST WORKSPACE",
"description": "Workspace for demonstrating MCP tools and agent capabilities",
"url": "https://monday.monday.com/workspaces/12406666"
}
Odpowiedź zawiera też pole next_page, które wskazuje numer następnej strony, jeśli są dostępne kolejne wyniki.
Odpowiednik programistyczny
Użyj API GraphQL, aby uzyskać ten sam wynik:
query {
workspaces(limit: 20, page: 1) {
id
name
description
kind
state
}
}
Pełną dokumentację znajdziesz na stronie Obszary robocze.