trello-automation

Rube MCP による Trello の自動化

Composio の Rube MCP 統合を通じて、Trello のボード管理、カード作成、チームのワークフローを自動化します。

ツールキットのドキュメント: composio.dev/toolkits/trello

前提条件

• Rube MCP が接続されている必要があります（RUBE_SEARCH_TOOLS が利用可能）
• RUBE_MANAGE_CONNECTIONS を通じて、ツールキット trello の Trello 接続が有効であること
• 現在のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

Rube MCP の取得: クライアントの設定で https://rube.app/mcp を MCP サーバーとして追加してください。API キーは不要です。エンドポイントを追加するだけで動作します。

1. RUBE_SEARCH_TOOLS の応答を確認し、Rube MCP が利用可能であることを確認します
2. ツールキット trello を指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクに従って Trello の認証を完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

主なワークフロー

1. ボードにカードを作成する

使用する場面: ユーザーが Trello ボードに新しいカード／タスクを追加したい場合

ツールの順序:

1. TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER - ボードを一覧表示して、対象のボード ID を探します［前提条件］
2. TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD - ボード上のリストを取得して、対象のリスト ID を探します［前提条件］
3. TRELLO_ADD_CARDS - 特定したリストにカードを作成します［必須］
4. TRELLO_ADD_CARDS_CHECKLISTS_BY_ID_CARD - カードにチェックリストを追加します［任意］
5. TRELLO_ADD_CARDS_CHECKLIST_CHECK_ITEM_BY_ID_CARD_BY_ID_CHECKLIST - チェックリストに項目を追加します［任意］

主なパラメーター:

• idList: 24 文字の 16 進数 ID（リスト名ではありません）
• name: カードのタイトル
• desc: カードの説明（Markdown に対応）
• pos: 位置（'top'／'bottom'）
• due: 期限（ISO 8601 形式）

注意点:

• 返された id（idCard）はすぐに保存してください。これがないと、後続のチェックリスト操作は失敗します
• チェックリストのペイロードはネストされている場合があります（data.data）。内側のオブジェクトから idChecklist を抽出してください
• チェックリストの項目ごとに API 呼び出しが 1 回必要です。大きなチェックリストではレート制限が発生することがあります

2. ボードとリストを管理する

使用する場面: ユーザーがボードのレイアウトを表示、確認、再構成したい場合

ツールの順序:

1. TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER - ユーザーのすべてのボードを一覧表示します［必須］
2. TRELLO_GET_BOARDS_BY_ID_BOARD - ボードの詳細情報を取得します［必須］
3. TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD - ボード上のリスト（列）を取得します［任意］
4. TRELLO_GET_BOARDS_MEMBERS_BY_ID_BOARD - ボードのメンバーを取得します［任意］
5. TRELLO_GET_BOARDS_LABELS_BY_ID_BOARD - ボード上のラベルを取得します［任意］

主なパラメーター:

• idMember: 認証済みユーザーには 'me' を使用します
• filter: 'open'、'starred'、または 'all'
• idBoard: 24 文字の 16 進数 ID または 8 文字の shortLink（ボード名ではありません）

注意点:

• 実行によっては、ボードが response.data.details[] の下に返されます。最上位にフラットな配列があると決めつけないでください
• リストは results[0].response.data.details の下にネストされている場合があります。想定外の形式にも対応できるよう解析してください
• 末尾に 'Z' が付いた ISO 8601 タイムスタンプは、タイムゾーンを考慮して解析する必要があります

3. リスト間でカードを移動する

使用する場面: ユーザーがカードを別のリストに移動して、ステータスを変更したい場合

ツールの順序:

1. TRELLO_GET_SEARCH - 名前またはキーワードでカードを検索します［前提条件］
2. TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD - 移動先のリスト ID を取得します［前提条件］
3. TRELLO_UPDATE_CARDS_BY_ID_CARD - カードの idList を更新して移動します［必須］

主なパラメーター:

• idCard: 検索で取得したカード ID
• idList: 移動先のリスト ID
• pos: 新しいリスト内での順序（任意）

注意点:

• 検索結果には部分一致が含まれます。更新する前にカード名を確認してください
• 移動しても新しいリスト内での位置は更新されません。順序が重要な場合は pos を設定してください

4. メンバーをカードに割り当てる

使用する場面：ユーザーがカードにチームメンバーを割り当てたい場合

ツールの手順：

1. TRELLO_GET_BOARDS_MEMBERS_BY_ID_BOARD - ボードからメンバー ID を取得します［前提条件］
2. TRELLO_ADD_CARDS_ID_MEMBERS_BY_ID_CARD - カードにメンバーを追加します［必須］

主なパラメーター：

• idCard：対象カードの ID
• value：割り当てるメンバーの ID

注意点：

• UPDATE_CARDS_ID_MEMBERS はメンバーリスト全体を置き換えます。追加するには ADD_CARDS_ID_MEMBERS を使用してください
• メンバーにはボードへの権限が必要です

5. カードを検索・絞り込む

使用する場面：ユーザーがボード全体から特定のカードを探したい場合

ツールの手順：

1. TRELLO_GET_SEARCH - クエリ文字列で検索します［必須］

主なパラメーター：

• query：検索文字列（board:、list:、label:、is:open/archived 演算子に対応）
• modelTypes：'cards' に設定します
• partial：前方一致の場合は 'true' に設定します

注意点：

• 検索インデックスの更新には遅延があるため、新しく作成したカードが表示されるまで数分かかる場合があります
• 名前を完全一致で検索するには、TRELLO_GET_BOARDS_CARDS_BY_ID_BOARD を使用し、ローカルで絞り込んでください
• クエリでは単語単位でトークン化されます。一般的な単語はストップワードとして無視される場合があります

6. コメントと添付ファイルを追加する

使用する場面：ユーザーが既存のカードに情報を追加したい場合

ツールの手順：

1. TRELLO_ADD_CARDS_ACTIONS_COMMENTS_BY_ID_CARD - カードにコメントを投稿します［必須］
2. TRELLO_ADD_CARDS_ATTACHMENTS_BY_ID_CARD - ファイルまたは URL を添付します［任意］

主なパラメーター：

• text：コメントのテキスト（1～16384 文字、Markdown と @メンションに対応）
• url または file：添付元（両方は指定できません）
• name：添付ファイルの表示名
• mimeType：ファイルの MIME タイプ

注意点：

• コメントにはファイルを添付できません。添付ファイル用のツールを別途使用してください
• 添付ファイルの削除は取り消せません

よくあるパターン

ID の解決

操作の前に、必ず表示名を ID に解決してください：

• ボード名 → ボード ID：idMember='me' を指定して TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER を実行します
• リスト名 → リスト ID：解決済みのボード ID を指定して TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD を実行します
• カード名 → カード ID：クエリ文字列を指定して TRELLO_GET_SEARCH を実行します
• メンバー名 → メンバー ID：TRELLO_GET_BOARDS_MEMBERS_BY_ID_BOARD

ページネーション

ほとんどのリストエンドポイントはすべての項目を返します。カードが 1000 件以上あるボードでは、カード一覧エンドポイントの limit パラメーターと before パラメーターを使用してください。

レート制限

トークンごとに 10 秒あたり 300 リクエストです。制限内に収めるには、一括読み取り操作に TRELLO_GET_BATCH を使用してください。

既知の注意点

• ID の要件：ほぼすべてのツールで、表示名ではなく ID が必要です。必ず先に名前を ID に解決してください。
• ボード ID の形式：ボード ID は 24 文字の 16 進数、または 8 文字の shortLink である必要があります。'my-board' のような URL スラッグは無効です。
• 検索の遅延：検索インデックスの更新には遅延があり、新規作成または更新したカードがすぐに表示されない場合があります。
• ネストされたレスポンス：レスポンスデータはネストされていることがよくあります（data.data または data.details[]）。堅牢に解析してください。
• レート制限：トークンごとに 10 秒あたり 300 リクエストです。読み取りは TRELLO_GET_BATCH でまとめて実行してください。

クイックリファレンス

タスク	ツールスラッグ	主なパラメーター
ユーザーのボード一覧を取得	TRELLO_GET_MEMBERS_BOARDS_BY_ID_MEMBER	idMember='me', filter='open'
ボードの詳細を取得	TRELLO_GET_BOARDS_BY_ID_BOARD	idBoard（24文字の16進数）
ボードのリスト一覧を取得	TRELLO_GET_BOARDS_LISTS_BY_ID_BOARD	idBoard
カードを作成	TRELLO_ADD_CARDS	idList, name, desc, pos, due
カードを更新	TRELLO_UPDATE_CARDS_BY_ID_CARD	idCard, idList（移動先）
カードを検索	TRELLO_GET_SEARCH	query, modelTypes='cards'
チェックリストを追加	TRELLO_ADD_CARDS_CHECKLISTS_BY_ID_CARD	idCard, name
コメントを追加	TRELLO_ADD_CARDS_ACTIONS_COMMENTS_BY_ID_CARD	idCard, text
メンバーを割り当て	TRELLO_ADD_CARDS_ID_MEMBERS_BY_ID_CARD	idCard, value（メンバー ID）
ファイル／URLを添付	TRELLO_ADD_CARDS_ATTACHMENTS_BY_ID_CARD	idCard, url または file
ボードのメンバー一覧を取得	TRELLO_GET_BOARDS_MEMBERS_BY_ID_BOARD	idBoard
一括読み取り	TRELLO_GET_BATCH	urls（カンマ区切りのパス）

---

Composio によって提供されています