Trello MCP サーバー
AI ホストを介して Trello ボード、リスト、カードと対話するための強力な MCP サーバー。
目次
Related MCP server: Trello MCP Server
前提条件
Python 3.12以上であれば、
uvで簡単に管理できます。Claude for Desktopがインストール済み
TrelloアカウントとAPI認証情報
UVパッケージマネージャーがインストールされている
インストール前
Claudeデスクトップアプリがインストールされていることを確認してください
自分のアカウントですでに Claude にログインしていることを確認してください。
クロードを開始
インストール
Trello API 資格情報を設定します。
Trelloアプリ管理に移動
新しいパワーアップまたは統合で新しい統合を作成します
情報を入力してください(IframeコネクタのURLは空のままにできます)。正しいワークスペースを選択してください。
アプリのアイコンをクリックし、左側のサイドバーから「API キー」に移動します。
「API キー」をコピーし、右側の「トークンを手動で生成できます」という部分で「トークン」という単語をクリックして、Trello トークンを取得します。
プロジェクト ルートにある
.env.exampleファイルの名前を.envに変更し、取得した変数を設定します。
まだインストールしていない場合は、uv をインストールします。
このリポジトリをクローンします:
uv:: を使用して依存関係をインストールし、Claude のサーバーを設定します。
Claudeデスクトップアプリを再起動します
サーバーモード
この MCP サーバーは、次の 2 つの異なるモードで実行できます。
クロード・アプ・モード
このモードは、Claude デスクトップ アプリケーションと直接統合されます。
.envファイルでUSE_CLAUDE_APP=true設定します (これがデフォルトです)次のコマンドでサーバーを実行します。
Claudeデスクトップアプリケーションを再起動します
SSE サーバーモード
このモードは、Cursor を含む任意の MCP 互換クライアントで使用できるスタンドアロン SSE サーバーとして実行されます。
.envファイルでUSE_CLAUDE_APP=false設定します。次のコマンドでサーバーを実行します。
サーバーは、デフォルトでは
http://localhost:8000(または設定したポート) で利用できます。
ドッカーモード
Docker Compose を使用してサーバーを実行することもできます。
DockerとDocker Composeがインストールされていることを確認してください
設定を
.envファイルで作成するコンテナをビルドして起動します。
サーバーはデフォルトでSSEモードで実行されます
ログを表示するには:
サーバーを停止するには:
構成
サーバーは、 .envファイル内の環境変数を使用して構成できます。
変数 | 説明 | デフォルト |
TRELLO_API_KEY | Trello APIキー | 必須 |
TRELLO_トークン | Trello APIトークン | 必須 |
MCP_サーバー名 | MCPサーバーの名前 | Trello MCP サーバー |
MCP_サーバーホスト | SSEモードのホストアドレス | 0.0.0.0 |
MCP_サーバーポート | SSEモード用のポート | 8000 |
USE_CLAUDE_APP | クロードアプリモードを使用するかどうか | 真実 |
.envファイルでこれらの値を編集することで、サーバーをカスタマイズできます。
クライアント統合
Claude Desktopでの使用
サーバーをClaudeアプリモードで実行します(
USE_CLAUDE_APP=true)Claude Desktopを起動または再起動する
Claudeは自動的にMCPサーバーを検出して接続します
カーソルを使用する
MCP サーバーを Cursor に接続するには:
サーバーをSSEモードで実行する(
USE_CLAUDE_APP=false)カーソルで、設定(歯車アイコン)> AI > モデルコンテキストプロトコルに移動します。
URL
http://localhost:8000(または設定したホスト/ポート) で新しいサーバーを追加します。カーソルのAI機能を使用するときにサーバーを選択する
この構成をカーソル設定 JSON ファイル (通常は~/.cursor/mcp.json ) に追加することもできます。
他のMCPクライアントとの使用
その他の MCP 互換クライアントの場合は、 http://localhost:8000の SSE エンドポイントを指定します。
最小限のクライアントの例
SSE エンドポイントに接続するための最小限の Python の例を次に示します。
機能
手術 | ボード | リスト | カード | チェックリスト | チェックリスト項目 |
読む | ✅ | ✅ | ✅ | ✅ | ✅ |
書く | ❌ | ✅ | ✅ | ✅ | ✅ |
アップデート | ❌ | ✅ | ✅ | ✅ | ✅ |
消去 | ❌ | ✅ | ✅ | ✅ | ✅ |
詳細な機能
理事会運営
✅ すべてのボードを読む
✅ 特定のボードの詳細を読む
リスト操作
✅ ボード内のすべてのリストを読む
✅ 特定のリストの詳細を読む
✅ 新しいリストを作成する
✅ リスト名を更新
✅ リストをアーカイブ(削除)する
カード操作
✅ リスト内のすべてのカードを読む
✅ 特定のカードの詳細を読む
✅ 新しいカードを作成する
✅ カード属性を更新する
✅ カードを削除する
チェックリスト操作
✅ 具体的なチェックリストを入手する
✅ すべてのチェックリストをカードにリストする
✅ 新しいチェックリストを作成する
✅ チェックリストを更新する
✅ チェックリストを削除する
✅ チェックリストにチェック項目を追加する
✅ チェック項目を更新する
✅ チェック項目を削除する
使用法
インストールが完了すると、Claude を介して Trello ボードを操作できるようになります。クエリの例を以下に示します。
「すべてのボードを表示」
「ボード [board_name] にはどんなリストがありますか?」
「リスト [list_name] にタイトル [title] の新しいカードを作成します」
「カード[card_name]の説明を更新してください」
「リスト [list_name] をアーカイブする」
使用例は次のとおりです。
トラブルシューティング
問題が発生した場合:
.envファイルで Trello API の資格情報を確認しますTrelloワークスペースに適切な権限があることを確認してください
Claude for Desktopが最新バージョンであることを確認する
uv run mcp dev main.pyコマンドを使用して、ログでエラー メッセージを確認します。uvが正しくインストールされ、PATHに入っていることを確認してください
貢献
問題や機能強化のリクエストをお気軽にお寄せください。