Pobierz metadane sprintów (Platform MCP)
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,ACTIVElubCOMPLETEDtimeline- planowane datyfromitostart_date/end_date- faktyczne daty rozpoczęcia i zakończenia (wartość null w przypadku zaplanowanych sprintów)is_completed- wartość logicznadocument_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.