Utwórz dokument (Platform MCP)
Użyj tego narzędzia, aby utworzyć nowy dokument na swoim koncie monday.com. Dokumenty można tworzyć w dwóch miejscach: w obszarze roboczym jako samodzielne dokumenty albo jako załączniki do konkretnego elementu na tablicy za pomocą kolumny dokumentu. Po utworzeniu podana przez Ciebie treść w formacie Markdown zostanie automatycznie zaimportowana do dokumentu jako bloki.
Najpierw określ parametr location, ponieważ decyduje on o tym, które pozostałe parametry są wymagane. W przypadku dokumentów w obszarze roboczym podaj workspace_id. W przypadku dokumentów dołączanych do elementu podaj item_id. Użyj read_docs, aby odczytać dokument po utworzeniu, lub update_doc, aby go zmodyfikować.
Parametry
| Parametr | Typ | Wymagane | Opis |
|---|---|---|---|
| doc_name | string |
Tak | Nazwa wyświetlana nowego dokumentu. |
| markdown | string |
Tak | Treść w formacie Markdown, która podczas tworzenia zostanie zaimportowana do dokumentu jako bloki. |
| location | string |
Tak | Miejsce utworzenia dokumentu. Jedna z wartości: workspace (samodzielny dokument) lub item (dokument dołączony do elementu na tablicy). |
| workspace_id | number |
Tak (jeśli location=workspace) |
Identyfikator obszaru roboczego, w którym ma zostać utworzony dokument. Użyj list_workspaces, aby znaleźć identyfikatory obszarów roboczych. |
| doc_kind | string |
Nie | Widoczność dokumentu. Jedna z wartości: public, private lub share. Domyślnie: public. Używany tylko, gdy location=workspace. |
| folder_id | number |
Nie | Identyfikator folderu, w którym ma zostać umieszczony dokument. Używany tylko, gdy location=workspace. Użyj search z searchType FOLDERS, aby znaleźć identyfikatory folderów. |
| item_id | number |
Tak (jeśli location=item) |
Identyfikator elementu na tablicy, do którego ma zostać dołączony dokument. Używany tylko, gdy location=item. |
| column_id | string |
Nie | Identyfikator istniejącej kolumny dokumentu na tablicy elementu. Jeśli go nie podasz, automatycznie zostanie utworzona nowa kolumna dokumentu. Używany tylko, gdy location=item. |
Przykład
Utwórz publiczny dokument w obszarze roboczym 12406666 z początkową treścią w formacie Markdown:
{
"doc_name": "MCP Tool Test Doc",
"location": "workspace",
"workspace_id": 12406666,
"doc_kind": "public",
"markdown": "# Hello from MCP\n\nThis document was created via the `create_doc` tool.\n\n- Item one\n- Item two\n- Item three"
}
Narzędzie zwróciło doc_id: "41622523", object_id: "18412502542" oraz bezpośredni adres URL nowego dokumentu: https://monday.monday.com/docs/18412502542.
Odpowiednik programistyczny
Użyj GraphQL API, aby uzyskać ten sam rezultat:
mutation {
create_doc(
location: {
workspace: {
workspace_id: 12406666
kind: public
}
}
) {
id
object_id
url
}
}
Pełną dokumentację znajdziesz w sekcji Docs.