board-setup

ボードのセットアップ

適切な構成で monday.com ボードを作成・設定します。適切な列タイプ、意味のあるグループ、初期アイテムを設定します。monday.com では、ボードはチームがあらゆるワークフローを管理するための中心的な作業スペースです。プロジェクトの遂行、営業パイプライン、バグのトリアージ、コンテンツ制作、イベント計画などに利用できます。このスキルでは、チームの実際の働き方に合った、整理されたボードを構築するために必要なドメイン知識を提供します。

ワークフロー

ステップ 1：要件を把握する

作成を始める前に、ユーザーに次の点を確認します。

1. 何を管理しますか？（タスク、プロジェクト、バグ、見込み客、リクエスト、イベントなど）
2. 作業はどのような段階を経ますか？（例：未着手 > 進行中 > レビュー > 完了）
3. 各アイテムにどのような情報が必要ですか？（担当者、期限、優先度、ステータス、予算など）
4. このボードを利用する人は何人ですか？

「プロジェクトボードを作成して」のような簡潔なリクエストの場合は、ユースケースに基づいた妥当なデフォルトを適用し、作成前に構成を確認します。

ステップ 2：ボードの構成を設計する

要件に基づいて、次の項目を計画します。

• ボード名 - 明確で内容が分かりやすい名前
• グループ - ワークフローの段階、カテゴリ、期間を表します
• 列 - 各アイテムのデータフィールド（下記の「列タイプの選択」を参照）

ステップ 3：ボードを作成する

強くおすすめします：creationPrompt を使って、1 回の呼び出しでボードを作成してください。 create_board は自由記述の creationPrompt を受け取り、monday がそれに基づいてグループ、列、ラベルを設計します。これは呼び出しごとに構造を組み立てるよりも速く、信頼性も高く、途中で呼び出しが失敗したときに長い構築手順の後に残る、不完全なボードや重複した列も避けられます。プロンプトでは表現できない正確な構造をユーザーが必要としている場合を除き、新しいボードには毎回これを使ってください。

以下を指定して create_board を呼び出します。

• boardName：内容がわかる名前

• boardKind：チームメンバー全員に表示される "public"、または購読者のみに表示される "private"

• workspaceId（ユーザーがフォルダーを指定した場合は folderId も）

• creationPrompt：ステップ 2 の設計を平易な言葉で記述します。ボードで追跡する内容、ワークフローのステージ、各項目に必要なフィールド（優先度、ステージなどのラベルセットを含む）、初期項目を指定してください。プロンプトに自動化は含めないでください。プロンプトからは作成されません。自動化はそれぞれ後から create_automation で追加し、list_automations で確認してください。例：

  モバイルチーム向けのバグトラッカーです。バグは「新規」「トリアージ済み」「進行中」「修正済み」「検証済み」の順に進みます。各バグには、担当者、重要度（低、中、高、重大）、期限、再現手順、影響を受けるプラットフォーム（iOS、Android、Web）が必要です。初期項目：「Android でログインボタンが反応しない」「写真のアップロード時にクラッシュする」。

作成後、設計どおりのボードになっているか確認してください。 creationPrompt はほとんど正しく作成しますが、すべてが正しいとは限りません。get_board_info、get_board_items_page（includeColumns: true を指定）、list_automations を呼び出し、次の点を確認します。

1. グループの順序と top_group。 グループが順不同で返されたり、「完了」などの最終グループが先頭に配置されたりすることがあります。また、新しい項目は top_group に追加されます。update_group（ステップ 4 の relative_position_before を参照）を使って並べ替え、最初のワークフローステージが先頭になるようにします。
2. 列の種類。 フィールドの種類が異なる場合があります（例：ウェブサイトが link ではなく text として作成される）。create_column で正しい種類の列を追加し、値をコピーして、古い列は削除できることをユーザーに伝えます。
3. ラベル。 ラベルセットが誤っている、または不足している場合は修正します（「既存のステータス列のラベルを変更する」を参照）。
4. 初期項目。 指定した値をすべて確認します。空欄のままになっているものもあります。空欄を 1 回の update_items 呼び出しで入力します。
5. 依頼されていない自動化。 create_board は、誰も依頼していない自動化を追加することがあります。たとえば、ドロップダウンに対する monday AI の「分類」ルールは、新しい項目が追加されるたびに実行され、AI クレジットを使用します。追加された内容をユーザーに伝え、それぞれを無効にするか確認してください。ワークフローは manage_automations で無効にできますが、API から変更できないものもあります。その場合は、ボードの「自動化」パネルを案内してください。
6. 「名前」列のタイトル。設計で「取引」「アカウント」などが指定されている場合は、名前を変更します。

ステップ 4～6 を使って不足分だけを補います。ボードを作り直してはいけません。修正した内容をユーザーに 1 行で伝えてください。

create_board が失敗したりタイムアウトしたりしても、すぐに再度呼び出さないでください。 ボードはすでに作成されている可能性があります。まずボード名で search を呼び出し、見つからない場合に限って再試行してください。再送するとボードが重複して作成されます。

creationPrompt を使わない場合は空のボードが作成されるため、ステップ 4～6 に従って構築してください。

ステップ 4：グループを作成する

creationPrompt によって必要なグループがすでに作成されている場合は、このステップをスキップしてください。

ワークフローの各段階またはカテゴリについて、create_group を呼び出します。

新しいグループはデフォルトグループより上に配置してください。 新しい monday ボードには、デフォルトで「Group Title」という名前の空のグループ（id topics）が用意されています。ワークフローのグループをボードの先頭に正しい順序で配置するには、各 create_group の呼び出しで positionRelativeMethod: "before_at" と relativeTo: "topics" を渡します。ワークフローの順序どおりにグループを作成してください（最初に作成したグループがボードの最初のグループとなり、新しいアイテムがデフォルトで追加される top_group になります）。

最後にデフォルトグループを整理してください。 ワークフローのグループが作成されたら、デフォルトの topics グループは不要な空グループとなり、ユーザーを混乱させます。all_monday_api を使って delete_group ミューテーションを呼び出し、削除してください：mutation { delete_group(board_id: <id>, group_id: "topics") { id } }。この操作を省略すると、ワークフローの下に空のグループが残ります。

all_monday_api を通じて update_group ミューテーションを使うと、グループの名前変更や並べ替えができます（change_group_title ミューテーションは存在せず、update_group は選択セットを指定しないと失敗します）：

• 名前変更：mutation { update_group(board_id: <id>, group_id: "<group_id>", group_attribute: title, new_value: "New name") { id title } }
• 別のグループより上に移動：group_attribute: relative_position_before, new_value: "<other_group_id>"（または relative_position_after）を指定し、{ id position } を選択します。

デフォルトの topics グループを最初のワークフローグループに名前変更する方法もあり、その場合は削除する必要はありません。

create_group が受け付けるのは、groupColor enum に記載された正確な 16 進値のみです。似た色合いの値は拒否されます。

よくあるグループのパターン：

ワークフローの段階別（最も一般的）：

• 「未着手」、「進行中」、「レビュー中」、「完了」

優先度別：

• 「緊急」、「高優先度」、「中」、「低優先度」

期間別：

• 「今週」、「来週」、「バックログ」

チーム／部門別：

• 「エンジニアリング」、「デザイン」、「プロダクト」、「QA」

カテゴリ別：

• 「バグ」、「機能」、「改善」、「技術的負債」

ステップ 5：列を追加する

creationPrompt を使用した場合は、get_board_info に不足していると表示された列のみを追加してください。それ以外の場合は、データフィールドごとに create_column を呼び出します。各列では、以下を指定します：

• boardId：ステップ 3 のボード ID
• title：表示名
• columnType：monday.com の列タイプ（「列タイプの選択」を参照）
• columnSettings：カスタムラベルが必要な列のラベル設定を JSON 文字列化したもの（下記の「ステータス列のカスタムラベル」を参照）

列は次の順序で追加してください（ボードの左から右）：

1. ステータス列（ワークフローの状態）
2. 人物列（担当者）
3. 日付列またはタイムライン列（期限／期間）
4. 優先度列（必要な場合）
5. その他のデータ列（テキスト、数値、リンクなど）

Name（最初の）列の名前を変更する。 update_column は name 列のタイトル変更を拒否します（「Name columns can only be updated with the width parameter」）。代わりに all_monday_api を使用してください：mutation { change_column_title(board_id: <id>, column_id: "name", title: "Task") { id title } }。これにより、テンプレートに合わせて「取引」、「バグ」、「リクエスト」などのラベルを付けられます。

ステータス列のカスタムラベル

columnSettings を指定せずに作成した status 列には、常に monday のデフォルトラベル「Working on it」（オレンジ）、「Done」（緑）、「Stuck」（赤）が設定されます。主要なワークフローのステータス列であれば問題ありませんが、テンプレートで必要となるその他のステータス列には適しません。作成時にカスタムラベルを渡さないと、Priority、Severity、Stage、Risk のすべてに紛らわしいデフォルトラベルが設定されます。

次の形式の JSON 文字列として columnSettings を渡します。

{"labels": [{"label": "<name>", "color": "<color_token>", "index": <0..n>}, ...]}

各項目には label、color、index が必要です（その他のフィールドは省略可能です）。color トークンには、monday の StatusColumnColors 列挙型にある文字列を指定します。カテゴリ別の便利なトークンは次のとおりです。

• 落ち着いた色／低：sky、bright_blue、aquamarine、saladish
• 中程度／進行中：working_orange、egg_yolk、purple
• 高／警告：dark_orange、sunset、lipstick
• 重大／ブロック中：stuck_red、dark_red、bright_green（「approved」の場合のみ）
• 完了／成功：done_green、grass_green

以下のテンプレートで使用するラベルセットの例：

• Priority： [{"label":"Low","color":"sky","index":0},{"label":"Medium","color":"working_orange","index":1},{"label":"High","color":"dark_orange","index":2},{"label":"Critical","color":"stuck_red","index":3}]
• Severity： Priority と同じです。
• パイプラインのステージ（CRM）： ラベルセットは、名前付きグループ（Lead、Qualified、Proposal、Negotiation、Closed Won、Closed Lost）と一致させ、項目のステータスとグループを同期できるようにします。
• Risk： [{"label":"Low","color":"saladish","index":0},{"label":"Medium","color":"egg_yolk","index":1},{"label":"High","color":"dark_orange","index":2}]

ユーザーがワークフロー以外の意味を持つステータス列（「Priority」、「Severity」、「Risk」、「Stage」、「Health」、「Confidence」など）をリクエストした場合、指定がなければ Low／Medium／High／Critical の段階をデフォルトとして使用します。ユーザーが変更できるよう、使用したデフォルトを明示します。

主要なワークフローのステータス列には columnSettings を指定しないでください。デフォルトが多くのユーザーの期待に合っています。

形式と色。 フラットな {"labels": [...]} オブジェクトを送信します。get_column_type_info ではスキーマが settings キーでラップされていますが、そのラッパーをコピーしないでください。create_column は受け付けますが、update_column は拒否します。color には上記のリストにあるトークン（またはその数値）を指定してください。#00c875 のような 16 進カラーコードは拒否されます。

カスタムラベルを指定した create_column が INTERNAL_SERVER_ERROR を返した場合、 同じペイロードを再送信しないでください。columnSettings を指定せずに列を作成してから、update_column でラベルを設定します（以下を参照）。

既存のステータス列のラベルを変更する

update_column は列のラベルリスト全体を置き換えます。

1. 列の revision と現在の settings.labels を取得するため、列の filters.columns.ids を指定して get_board_info を呼び出します。
2. 維持するラベルをすべて送信します。それぞれに既存の id、label、color、index を指定してください。省略したラベルは削除されます。
3. 新しいラベルは id を付けずに追加します。任意の ID は拒否されます（「Label ids: 5 do not exist」）。新しいラベルでは、すでに使用されている色を再利用できます。
4. 以降の更新には、応答に含まれる新しい revision を使用します。

既存のラベルの色変更には対応していません。呼び出しは成功したと報告されますが、色は変わりません。色を変更するには、monday の列のラベルエディターから変更するようユーザーに伝えてください。

ステップ 6：初期項目を登録する（任意）

ユーザーが初期項目を指定し、ボードにまだ登録されていない場合は、項目ごとに create_item を呼び出すのではなく、1 回の create_items 呼び出しで作成します（1 回あたり最大 20 件）。タスク管理スキルの列値の書式設定ルールに従ってください。

ステップ 7：結果を提示する

何が作成されたかを平易な言葉で報告します。API 呼び出しの経緯は説明しません。MCP ツールから返された直接の URL を含めてください。

作成した内容を要約します。

作成したボード：[Board Name]

• URL：[board URL]
• 種類：[public/private]

グループ：

1. To Do
2. In Progress
3. In Review
4. Done

列：

列	種類	用途
Status	Status	ワークフローの状態
Owner	People	アイテムの担当者
Due Date	Date	期限
Priority	Status	重要度
Notes	Text	追加情報

次に行うとよいことを 2～3 個提案します。

• 「始めやすいように、初期アイテムをいくつか追加しましょうか？」
• 「このボードにチームメンバーを招待しましょうか？」
• 「このプロジェクトを追跡するダッシュボードを作成しましょうか？」
• 「受付リクエスト用のフォームを設定しましょうか？」

列の種類の選択

適切な列の種類を選ぶことが重要です。ステータス列が必要な場面でテキスト列を使うと、フィルタリング、グループ化、自動化の機能を利用できなくなります。

列の種類の詳細については、references/column-types-guide.md を参照してください。

よくあるニーズに対応する簡単な選択ガイド：

必要なもの	列の種類	テキスト列ではなくこの種類を選ぶ理由
ワークフローの状態（To Do、In Progress、Done）	status	色分け、ステータスによるフィルタリング、自動化が可能
担当者	people	monday.com のユーザーと紐付けられ、作業量ビューを利用可能
期限	date	カレンダービュー、タイムラインビュー、期限超過の検出が可能
日付範囲（開始から終了まで）	timeline	タイムラインビューに期間をバーで表示
重要度	status（ラベルは「Priority」）	色分けされ、フィルタリングや並べ替えが可能
作業量の見積もり	numbers	合計、平均、数式による計算が可能
カテゴリータグ	dropdown	定義済みの選択肢から複数選択可能
はい／いいえのフラグ	checkbox	視覚的に切り替えられ、フィルタリング可能
自由記述のメモ	text	シンプルなテキスト入力
長い説明	long_text	書式設定に対応したリッチテキスト
ファイル添付	file	ファイルをアップロードし、インラインでプレビュー可能
ウェブリンク	link	表示テキスト付きのクリック可能な URL
メールアドレス	email	クリック可能な mailto リンク
電話番号	phone	クリック可能な tel リンク
予算／費用	numbers	通貨形式と数式に対応
評価	rating	1～5 の星で視覚的に評価
進捗	progress	サブアイテムまたはリンクされた列に基づく視覚的な進捗バー

プランの利用条件について

ほとんどの列の種類は、どの monday プランでも利用できます。利用が制限されている種類が 2 つあるため、スキルでは適切に対応する必要があります。

• 数式列 - Pro および Enterprise プランでのみ利用できます。ユーザーが Free／Basic／Standard プランを利用していて数式列（例：「数量と価格から合計金額を計算する列が欲しい」）を希望する場合は、利用条件を説明し、次のいずれかを提案します。
  • ユーザーが手動で更新する numbers 列
  • 別の場所で計算した値をユーザーが貼り付ける text 列
  • 代わりに docs／dashboards スキルの出力に数式計算を追加する
• ボードレベルの AI／自動化機能 - 一部はプランによって利用が制限されています。create_automation を使用して、1 回の呼び出しにつきトリガーを 1 つ作成し、list_automations で各設定を読み戻して、トリガーと条件がリクエストと一致していることを確認します。プランまたはトライアルが理由で呼び出しが拒否された場合は、自動化には有料プランが必要であることを伝え、ボードの Automations パネルを案内します。

ユーザーが自分のプランを把握していない場合は、まず標準の列を使ってボードを作成し、プランが対応していれば後から数式列を追加できると案内します。

用途別のボードテンプレート

プロジェクトトラッカー

• グループ： To Do、In Progress、In Review、Done
• 列： Status、Owner（people）、Due Date（date）、Priority（status、カスタムラベル Low／Medium／High／Critical）、Notes（text）

バグトラッカー

• グループ： 新規、トリアージ済み、進行中、修正済み、検証済み
• 列： ステータス、担当者（人）、重大度（ステータス、カスタムラベル：低／中／高／緊急）、期限（日付）、再現手順（long_text）、環境（ドロップダウン）

営業／CRM パイプライン

• グループ： リード、適格、提案、交渉、受注、失注
• 列： ステージ（ステータス、グループ名に対応するカスタムラベル：リード／適格／提案／交渉／受注／失注）、担当者（人）、会社（テキスト）、取引額（数値）、成約日（日付）、流入元（ドロップダウン）

コンテンツカレンダー

• グループ： アイデア、制作中、レビュー中、公開済み
• 列： ステータス、作成者（人）、公開日（日付）、コンテンツタイプ（ドロップダウン）、チャネル（ドロップダウン）、リンク（リンク）

イベント計画

• グループ： 計画、ロジスティクス、マーケティング、当日、イベント後
• 列： ステータス、担当者（人）、タイムライン（タイムライン）、予算（数値）、優先度（ステータス）、メモ（テキスト）

スプリントボード

• グループ： バックログ、スプリント［現在］、進行中、完了
• 列： ステータス、担当者（人）、ストーリーポイント（数値）、スプリント（ドロップダウン）、期限（日付）、タイプ（ステータス）

リクエスト／受付

• グループ： 新規リクエスト、レビュー中、承認済み、進行中、完了
• 列： ステータス、依頼者（人）、割り当て先（人）、優先度（ステータス）、期限（日付）、リクエストタイプ（ドロップダウン）、説明（long_text）

エラーの防止と対処

• 権限が原因で create_board が失敗した場合は、ユーザーが管理者権限を持つ既存のワークスペースを使うよう提案するか、使用するワークスペースを尋ねます。
• 列タイプが拒否された場合（例：Pro プラン以外での数式）、プランによる制限を説明し、代替の列タイプを提案します。
• 作成前に名前の重複を検出します。 monday では同じワークスペース内に同じ名前のボードを複数作成できますが、これは使い勝手を損なう落とし穴です。create_board を呼び出す前に、対象のワークスペースを指定して、要求されたボード名で search を呼び出します。同じ名前のボードがすでに存在する場合は、既存のボードを使うか、接尾辞を付けて作成するか（例：「Board Name (2)」）、別の名前を選ぶかをユーザーに尋ねます。この確認を省略して重複を作成した場合は不合格です。
• columnSettings の JSON が不正な形式の場合、create_column はエラーを返します。ラベルの形式には、name->color マップではなく、{label, color, index} オブジェクトの配列が必要です。上記の「ステータス列のカスタムラベル」を参照してください。
• 保存済みビューの日付フィルター（create_view_table／update_view_table）では、アイテムのフィルターとは異なる値を指定します。between にはプレーンな YYYY-MM-DD 形式の日付を2つ、greater_than／lower_than には "TODAY" を、within_the_next／within_the_last には ["DAYS", 7] を使います。ビューでは ["EXACT", "<date>"] を指定した any_of は拒否されます。get_column_type_info のガイドラインに記載されていても同様です。このガイドラインは get_board_items_page のフィルターを対象としています。

使用するツール

• search - create_board の前にボード名の重複を確認し、失敗した create_board がボードを作成していないか確認します
• get_column_type_info - 使用可能な列の種類とそのスキーマを把握します（ステータス列の columnSettings の形式を含みます）
• create_board - ボードを作成します。1 回の呼び出しで monday が構成を作成できるよう、creationPrompt の指定を推奨します
• create_group - ボードにグループを追加します
• create_column - 正しい種類と、Priority／Severity／Stage／Risk などに対応するカスタムの columnSettings を指定して列を追加します
• update_column - 既存のステータス列のラベルを変更します（ラベルの全リストと既存の ID を指定します）
• get_board_info - update_column の前に、列の revision と現在のラベルを読み取ります
• create_items - 初期アイテムを 1 回の呼び出しで追加します（任意）
• create_view_table - フィルター付きの保存済みテーブルビューを作成します（任意）
• get_board_items_page - creationPrompt の後に、初期アイテムの値を確認します
• update_items - 生成されたボードで空欄になっている初期アイテムの値を入力します
• create_automation - ボードの作成後に、依頼された各オートメーションを追加します
• list_automations - 新しいオートメーションを確認し、create_board が追加した未依頼のオートメーションを特定します
• manage_automations - 未依頼または誤ったオートメーションを無効化します
• all_monday_api - デフォルトの topics グループを削除し、グループの名前変更や並べ替え（update_group）、Name 列の名前変更（change_column_title）を行います

追加リソース

• references/column-types-guide.md - monday.com のすべての列の種類、各種類の用途、設定オプションを網羅したガイド