Claude Trello連携でボードとカードを操作する設定手順
Trello MCPはAtlassianが公開する公式のリモートMCPサーバーです。claude.aiとClaude Codeそれぞれの接続手順、できること、権限の設計を確認します。
Claude Trello連携とは
Trello MCPはAtlassianが公開する公式のリモートMCPサーバーです。GitHubリポジトリの説明によると「a cloud-hosted bridge that gives your AI tools secure, real-time access to your Trello content」、つまりTrelloのボード・リスト・カード・チェックリストにAIから直接アクセスできる橋渡しの役割を持ちます。
ChatGPT・Cursor・VS Code・Google Gemini CLIと並んでClaudeも対応プラットフォームに名前が挙がっており、claude.aiのディレクトリからワンクリックで追加できます。Claude Codeからも接続でき、リポジトリが配布するエージェント向けskillを使えば設定ミスを減らせます。似た仕組みで先にGmail・Google Driveを連携済みなら、Claude Connectorsの全体像の理解がそのまま流用できます。
前提条件
必要なのはTrelloアカウント(プラン不問)と、対応するAIクライアントです。認証はOAuth 2.0で行うため、認可画面を開けるブラウザがあれば十分です。接続時にはTrelloのワークスペースを1つ選んで許可します。1接続につき1ワークスペースまでという制約があり、複数ワークスペースへの同時接続は今後の対応予定として案内されています。
ステップ1: claude.aiから接続する(Web版・デスクトップ・モバイル)
claude.aiでは、ディレクトリ経由と手動追加の2通りがあります。
ディレクトリから追加する場合が簡単です。Trello MCPのリスティングページを開き、案内に沿って接続を進めます。
手動で追加する場合は、カスタムコネクタの設定画面を使います。
- 「Customize」→「Connectors」→「+」→「Add custom connector」を開く
- リモートMCPサーバーのURLとして
https://mcp.trello.com/v1を入力する - 「Add」をクリックして接続を確定する
- 会話画面の「+」ボタンから「Connectors」トグルを有効にして使い始める
Team・Enterpriseでは、Ownerが先に「Organization settings」→「Connectors」で組織全体に対してこのURLを登録する必要があります。登録後、メンバーは個人の「Customize」→「Connectors」から接続する流れです。
ステップ2: Claude Codeから接続する
Claude CodeはCLIコマンド1本で同じMCPサーバーに接続できます。
claude mcp add --transport http trello https://mcp.trello.com/v1実行後にOAuthの認可画面が開き、接続するTrelloワークスペースを選んで権限を許可すれば設定完了です。ディレクトリ経由のコネクタはClaude Codeと同じMCP基盤で動くため、claude.aiで先に接続を試してからCLIに展開しても手順は変わりません。
リポジトリはClaude Code向けのagent skillも配布しています。ツールが期待するARI形式のID、日時をUTCで扱う点、Inbox系ツールとボード系ツールの使い分けなど、間違えやすいポイントをあらかじめ教え込めます。
npx skills install atlassian/trello-mcp-serverclaude.aiとClaude Codeのどちらを選ぶか
両方に接続しても構いませんが、用途で使い分けると迷いません。日常のタスク確認や進捗の聞き取りは、チャットで完結するclaude.aiのほうが手軽です。一方でリポジトリの作業と並行してTrelloのカードを更新したい、コミットの内容に応じてカードを自動で動かしたいといった開発フローに組み込む使い方は、CLIから直接呼び出せるClaude Codeが向いています。
| 利用シーン | 向いている接続先 |
|---|---|
| 日次の進捗確認・タスクの棚卸し | 向いている接続先claude.ai(Web・デスクトップ・モバイル) |
| 開発作業と連動したカード更新 | 向いている接続先Claude Code |
| チーム全体への一括展開 | 向いている接続先claude.ai(Team/Enterpriseの組織設定経由) |
両方を同時に有効化しても、接続先のワークスペースが同じであれば操作できる範囲は変わりません。使う場面によって窓口を選ぶだけで済みます。
接続後にできること
MCPが公開しているカテゴリは9つです。
| カテゴリ | 操作 |
|---|---|
| Member | 操作プロフィールと既定設定の確認 |
| Workspaces | 操作ワークスペース情報の確認 |
| Boards | 操作ボードの閲覧・作成、ラベルの確認 |
| Lists | 操作リストの閲覧・移動 |
| Cards | 操作カードの閲覧・作成・更新・移動・アーカイブ・完了マーク、ラベルの付け外し |
| Checklists | 操作チェックリストの閲覧・作成・更新、項目の追加・更新 |
| Search | 操作キーワードでのカード・ボード検索 |
| Planner | 操作カレンダー予定の閲覧、フォーカスタイムの作成、カードとの紐づけ |
| Inbox | 操作Inboxカードの閲覧・作成・更新・アーカイブ |
PlannerはGoogleまたはOutlookのカレンダーと連携させて予定を読み取る機能です。ただしフォーカスタイムの作成にはTrello PremiumまたはEnterpriseプランが必要で、無料プランでは閲覧までにとどまります。
コメント・添付ファイル・カスタムフィールド・ラベルの新規作成・ボード編集・カードのコピーといった操作は、リポジトリの「coming soon」欄に挙げられており、まだ対応していません。
権限とセキュリティの設計
GitHubの「Data and security」節に沿って要点を挙げます。認証はOAuth 2.0、アクセス範囲は認可時に選んだワークスペースだけに絞られます。Claudeが実行できる操作は、利用者自身がTrello上で持つ権限を超えません。
破壊的な削除操作は用意されていません。カードやリストを消したい場合でも、実行できるのはアーカイブまでです。完全な削除はTrello側の画面から手動で行う必要があります。アクセス権限はいつでも取り消せます。
Team・Enterprise組織では、Atlassian Administrationの管理画面からMCPサーバーの許可・ブロックや、読み取り・書き込み・検索の権限レベルを組織単位で制御できます。これはAtlassian Rovo MCPサーバーと共通の管理基盤で、Trello専用の管理ツールは別途不要です。個人で使う分にはこうした組織設定を意識する必要はなく、接続時に選んだ権限がそのまま適用されます。
権限を絞って始め、必要になった範囲だけ広げていく進め方が安全です。最初から書き込み権限をすべて許可するのではなく、閲覧と検索だけで様子を見てから、カード操作の権限を追加する順番でも運用は成立します。
よくあるつまずき
「ワークスペースを切り替えたい」という要望はよく出ますが、1接続=1ワークスペースの制約があります。複数ワークスペースを扱いたい場合は、いったん接続を解除して別のワークスペースで再接続する運用になります。
権限を追加で許可したい場合は、既存の接続を編集するのではなく、いったん接続を解除してから必要な権限を選び直して再接続します。「後から権限を積み増す」操作は用意されていません。
Claude Codeで claude mcp add を実行してもOAuth画面が開かない場合は、URLのタイプミスをまず疑います。https://mcp.trello.com/v1 は末尾のバージョン番号を含めて正確に入力する必要があります。
カードが見つからないとき、権限の問題ではなくワークスペースの取り違えであることが多いです。接続時に選んだワークスペースと、探しているカードのあるワークスペースが一致しているかを確認します。
接続できているかを確認する
設定が終わったら、実際にTrelloの中身に触れる指示を出して疎通を確かめます。「自分のTrelloワークスペースを教えて」「今あるボードの一覧を出して」といった読み取り系の依頼であれば、承認なしですぐに結果が返ります。
一覧が返らない場合は、接続そのものが完了していないか、選んだワークスペースにボードが無いかのどちらかです。claude.aiなら「Customize」→「Connectors」の画面で接続状態を確認できます。Claude Codeであれば claude mcp list を実行し、trelloの項目が表示されているかを見ます。
読み取りが通ったら、次は「テスト用のカードを1枚作って」のような軽い書き込み系の指示で挙動を確かめます。ここで内容の確認画面が出れば、権限も正しく機能している状態です。
よくある質問
無料のTrelloアカウントでも接続できるか
できます。GitHubの案内では「A Trello account on any plan」とだけ書かれており、プランを問わず接続できます。ただしフォーカスタイムの作成などPremium・Enterprise限定の機能は、接続元のTrelloプランに依存します。
複数のTrelloワークスペースを1つの会話で扱えるか
扱えません。1接続=1ワークスペースの制約があるため、別のワークスペースのカードを見たい場合は接続を切り替える必要があります。
カードを完全に削除できるか
できません。用意されているのはアーカイブまでで、完全な削除機能は搭載されていません。誤操作でカードが消える心配をせずに任せられる設計です。
組織全体でTrello MCPの利用を制限したいときはどうするか
Atlassian Administrationの管理画面から、許可するMCPサーバーのドメインや、読み取り・書き込み・検索それぞれの権限レベルを組織単位で設定できます。Trello専用の管理ツールは不要で、既存のAtlassian Rovo MCPサーバー向けの管理基盤がそのまま使えます。
ChatGPTなど他のAIクライアントと併用できるか
できます。同じ https://mcp.trello.com/v1 のURLを、対応する各クライアントの設定にそれぞれ追加すれば、Claude・ChatGPT・Cursorなどから同じTrelloワークスペースへ個別に接続できます。
まとめ
Trello MCPはAtlassian公式のリモートMCPサーバーで、claude.aiではディレクトリからのワンクリック追加、Claude Codeでは claude mcp add --transport http の1コマンドで接続できます。破壊的な削除ができない設計と、OAuthベースの権限管理により、任せる範囲を絞って始めやすい仕組みです。接続を終えたら、実際にボードを動かす使い方はClaudeでTrelloの進捗管理を回す方法で確認してください。