Wykonaj zapytanie API (Platform MCP)
all_monday_api to najbardziej zaawansowane narzędzie na serwerze Platform MCP. Wykonuje dowolne surowe zapytanie lub mutację GraphQL w API monday.com, dając dostęp do wszystkich operacji obsługiwanych przez platformę. Użyj go, gdy żadne inne wyspecjalizowane narzędzie MCP nie obsługuje Twojego przypadku lub gdy chcesz precyzyjnie określić, które pola mają zostać zwrócone.
Zanim wywołasz to narzędzie, użyj get_graphql_schema, aby sprawdzić dostępne zapytania i mutacje, oraz get_type_details, aby poznać strukturę potrzebnych typów. Żądaj tylko pól, których potrzebujesz - pobieranie nadmiarowych danych zwiększa złożoność i spowalnia odpowiedzi.
Tworzenie skutecznych zapytań GraphQL wymaga znajomości schematu monday.com. Najpierw użyj get_graphql_schema i get_type_details, aby sprawdzić strukturę zapytania, a dopiero potem je wykonaj.
Parametry
| Parametr | Typ | Wymagane | Opis |
|---|---|---|---|
| query | string |
Tak | Pełny ciąg zapytania lub mutacji GraphQL do wykonania. |
| variables | string |
Tak | Ciąg JSON zawierający zmienne dla operacji GraphQL. Jeśli zapytanie nie używa zmiennych, przekaż "{}". |
Przykład
Pobierz identyfikatory i nazwy pierwszych 3 tablic na koncie:
{
"query": "query { boards(limit: 3) { id name } }",
"variables": "{}"
}
Zwrócona zostanie lista tablic, na przykład:
{
"boards": [
{ "id": "18412502571", "name": "MCP Docs Form Responses" },
{ "id": "18412502554", "name": "Subitems of Tickets" },
{ "id": "18412502553", "name": "Tickets" }
]
}
W przypadku mutacji ze zmiennymi - na przykład tworzącej element - przekaż wartości zmiennych jako zserializowany ciąg JSON:
{
"query": "mutation ($boardId: ID!, $groupId: String!, $name: String!) { create_item(board_id: $boardId, group_id: $groupId, item_name: $name) { id name } }",
"variables": "{\"boardId\": \"12345678\", \"groupId\": \"topics\", \"name\": \"New task\"}"
}
Odpowiednik programowy
all_monday_api to bezpośrednie proxy do API GraphQL monday.com. Te same zapytania i mutacje możesz wysyłać w żądaniu POST na adres https://api.monday.com/v2. Dołącz token API i zapytanie w treści żądania.
Pełną listę dostępnych zapytań, mutacji i typów znajdziesz w dokumentacji API monday.com.