Dokumentacja dla programistów›O API monday.com›Pobierz metadane sprintów (Platform MCP)
Dokumentacja dla programistów

Pobierz metadane sprintów (Platform MCP)

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

Użyj tego narzędzia, aby pobrać metadane sprintów z tablicy sprintów monday Dev. Zwraca uporządkowaną listę sprintów wraz z ich identyfikatorami, nazwami, osiami czasu, stanem ukończenia, datami rozpoczęcia i zakończenia, stanem aktywności oraz odwołaniami do dokumentów z podsumowaniem. Użyj zwróconych identyfikatorów sprintów jako danych wejściowych dla get_sprint_summary.

Aby wywołać to narzędzie, potrzebujesz identyfikatora tablicy sprintów. Jeśli go nie masz, użyj get_monday_dev_sprints_boards, aby znaleźć właściwy identyfikator.

Parametry

Parametr Typ Wymagany Opis
sprintsBoardId number Tak Identyfikator tablicy monday Dev zawierającej sprinty. Użyj get_monday_dev_sprints_boards, aby znaleźć ten identyfikator.
limit number Nie Liczba sprintów do pobrania. Od 1 do 100. Domyślnie: 25.

Przykład

Pobierz 5 najnowszych sprintów z tablicy sprintów:

{
  "sprintsBoardId": 8222767867,
  "limit": 5
}

Konto testowe zwróciło 5 sprintów. Każdy obiekt sprintu zawiera:

  • id - identyfikator elementu sprintu (np. "11889118342")
  • name - nazwa sprintu (np. "Sprint 40")
  • status - jedna z wartości: PLANNED, ACTIVE lub COMPLETED
  • timeline - planowane daty from i to
  • start_date / end_date - faktyczne daty rozpoczęcia i zakończenia (wartość null w przypadku zaplanowanych sprintów)
  • is_completed - wartość logiczna
  • document_object_id - odwołanie do dokumentu z podsumowaniem sprintu, jeśli taki istnieje

Na tablicy testowej było łącznie 40 sprintów z okresu od stycznia 2025 do lipca 2026.


Odpowiednik programistyczny

Tablice sprintów to standardowe tablice monday.com. Możesz pobrać elementy sprintów za pomocą GraphQL API:

query {
  boards(ids: [8222767867]) {
    items_page(limit: 25) {
      items {
        id
        name
        column_values {
          id
          text
          value
        }
      }
    }
  }
}

Narzędzie MCP mapuje wartości kolumn (oś czasu, stan, daty rozpoczęcia i zakończenia) na uporządkowany obiekt sprintu. Aby pobrać surowe dane kolumn, użyj zapytania boards z items_page. Informacje o opcjach stronicowania i filtrowania znajdziesz w dokumentacji Items Page.