Dokumentacja dla programistów›O API monday.com›Pokaż tabelę (Platform MCP UI)
Dokumentacja dla programistów

Pokaż tabelę (Platform MCP UI)

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

To wewnętrzny komponent interfejsu. Serwer Platform MCP wywołuje go automatycznie - nie wywołuj go bezpośrednio.

show-table wyświetla tablicę jako interaktywną tabelę w interfejsie czatu. Dzięki temu użytkownicy mogą przeglądać dane na tablicy i wchodzić z nimi w interakcję bez opuszczania rozmowy. Serwer MCP automatycznie wywołuje to narzędzie, gdy użytkownik prosi o wyświetlenie, przeglądanie lub wizualizację tablicy w formie tabeli.

Możesz opcjonalnie przekazać reguły filtrowania, aby ograniczyć liczbę wyświetlanych elementów. Jeśli używasz filtrów, najpierw wywołaj get_board_info, aby pobrać boardContextToken wymagany do poprawnego działania filtrowania. Po każdej aktualizacji elementu serwer automatycznie ponownie wywoła show-table, aby odświeżyć widok.

Parametry

Parametr Typ Wymagany Opis
boardId string Tak ID tablicy, która ma zostać wyświetlona jako tabela.
currentlySelectedItemIdForShowingUpdates string Nie ID elementu, którego aktualizacje mają być rozwinięte w widoku tabeli.
filters array Nie Tablica reguł filtrowania do zastosowania. Każdy filtr wymaga columnId i compareValue. Możesz też podać opcjonalne parametry operator (domyślnie any_of) i compareAttribute. Wymaga wcześniejszego wywołania get_board_info.
filtersOperator string Nie Określa sposób łączenia wielu filtrów. Możesz użyć "and" (wszystkie filtry muszą być spełnione) lub "or" (wystarczy spełnienie dowolnego filtra). Domyślnie: "and".

Obsługiwane operatory filtrowania: any_of, not_any_of, is_empty, is_not_empty, greater_than, greater_than_or_equals, lower_than, lower_than_or_equal, between, contains_text, not_contains_text, contains_terms, starts_with, ends_with, within_the_next, within_the_last

Przykład

Wyświetl tablicę jako tabelę:

{
  "boardId": "12406666"
}

Wyświetl tę samą tablicę, pokazując tylko elementy, których kolumna statusu ma wartość „Done”:

{
  "boardId": "12406666",
  "filters": [
    {
      "columnId": "status",
      "compareValue": 1,
      "operator": "any_of"
    }
  ],
  "filtersOperator": "and"
}

Odpowiednik programistyczny

Możesz pobrać dane tablicy bezpośrednio za pomocą interfejsu monday.com GraphQL API, używając zapytania boards z items_page:

query {
  boards(ids: [12406666]) {
    name
    columns { id title type }
    items_page(limit: 50) {
      items {
        id
        name
        column_values { id text value }
      }
    }
  }
}

Pełną listę opcji filtrowania znajdziesz w dokumentacji zapytania Items monday.com API.