Informacje o obszarze roboczym (Platform MCP)
Użyj tego narzędzia, aby uzyskać ogólny obraz zawartości obszaru roboczego. Zwraca maksymalnie 100 tablic, 100 dokumentów i 100 folderów, uporządkowanych według folderów, w których się znajdują. Elementy na najwyższym poziomie, które nie należą do żadnego folderu, są zwracane osobno w root_items. Przydaje się to do sprawdzenia układu obszaru roboczego przed przenoszeniem obiektów, tworzeniem folderów lub wyszukiwaniem konkretnych tablic.
Jeśli dla dowolnego typu obiektu (tablic, dokumentów lub folderów) zostanie zwróconych dokładnie 100 wyników, załóż, że istnieją dodatkowe elementy tego typu, których nie ma w odpowiedzi. Użyj bezpośrednio interfejsu GraphQL API, aby pobrać pełną listę stronicami.
Parametry
| Parametr | Typ | Wymagane | Opis |
|---|---|---|---|
| workspace_id | number |
Tak | Identyfikator obszaru roboczego, którego informacje chcesz pobrać. Użyj list_workspaces, aby znaleźć identyfikatory obszarów roboczych. |
Przykład
Pobierz pełną strukturę obszaru roboczego 12406666:
{
"workspace_id": 12406666
}
Odpowiedź zawiera metadane obszaru roboczego, tablicę folders (każdy folder zawiera swoje zagnieżdżone tablice i dokumenty) oraz obiekt root_items z tablicami i dokumentami, które nie znajdują się w żadnym folderze. Na przykład:
{
"workspace": {
"id": "12406666",
"name": "MCP TEST WORKSPACE",
"kind": "open",
"state": "active"
},
"folders": [
{
"id": "19028717",
"name": "Real estate agency management",
"boards": [
{ "id": "18392419211", "name": "Agent task management Board" }
],
"docs": []
}
],
"root_items": {
"boards": [
{ "id": "18394522211", "name": "Final Asset Library" }
],
"docs": [
{ "id": "35809248", "name": "test doc" }
]
}
}
Odpowiednik programistyczny
Aby uzyskać ten sam wynik, użyj GraphQL API:
query {
workspaces(ids: [12406666]) {
id
name
kind
state
boards {
id
name
folder_id
}
folders {
id
name
children {
id
name
}
}
}
}
Pełną dokumentację znajdziesz w sekcji Workspaces.