Trello MCP サーバー
AI ホストを介して Trello ボード、リスト、カードと対話するための強力な MCP サーバー。
目次
前提条件
- Python 3.12以上であれば、
uvで簡単に管理できます。 - Claude for Desktopがインストール済み
- TrelloアカウントとAPI認証情報
- UVパッケージマネージャーがインストールされている
インストール前
- Claudeデスクトップアプリがインストールされていることを確認してください
- 自分のアカウントですでに Claude にログインしていることを確認してください。
- クロードを開始
インストール
- Trello API 資格情報を設定します。
- Trelloアプリ管理に移動
- 新しいパワーアップまたは統合で新しい統合を作成します
- 情報を入力してください（IframeコネクタのURLは空のままにできます）。正しいワークスペースを選択してください。
- アプリのアイコンをクリックし、左側のサイドバーから「API キー」に移動します。
- 「API キー」をコピーし、右側の「トークンを手動で生成できます」という部分で「トークン」という単語をクリックして、Trello トークンを取得します。
- プロジェクト ルートにある
.env.exampleファイルの名前を.envに変更し、取得した変数を設定します。
TRELLO_API_KEY=your_api_key_here
TRELLO_TOKEN=your_token_here
- まだインストールしていない場合は、uv をインストールします。
curl -LsSf https://astral.sh/uv/install.sh | sh
- このリポジトリをクローンします:
git clone https://github.com/m0xai/trello-mcp-server.git
cd trello-mcp-server
- uv:: を使用して依存関係をインストールし、Claude のサーバーを設定します。
uv run mcp install main.py
- Claudeデスクトップアプリを再起動します
サーバーモード
この MCP サーバーは、次の 2 つの異なるモードで実行できます。
クロード・アプ・モード
このモードは、Claude デスクトップ アプリケーションと直接統合されます。
.envファイルでUSE_CLAUDE_APP=true設定します (これがデフォルトです)- 次のコマンドでサーバーを実行します。
uv run mcp install main.py
- 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 ) に追加することもできます。
{
"mcpServers": {
"trello": {
"url": "http://localhost:8000/sse"
}
}
}
他のMCPクライアントとの使用
その他の MCP 互換クライアントの場合は、 http://localhost:8000の SSE エンドポイントを指定します。
最小限のクライアントの例
SSE エンドポイントに接続するための最小限の Python の例を次に示します。
import asyncio
import httpx
async def connect_to_mcp_server():
url = "http://localhost:8000/sse"
headers = {"Accept": "text/event-stream"}
async with httpx.AsyncClient() as client:
async with client.stream("GET", url, headers=headers) as response:
# Get the session ID from the first SSE message
session_id = None
async for line in response.aiter_lines():
if line.startswith("data:"):
data = line[5:].strip()
if "session_id=" in data and not session_id:
session_id = data.split("session_id=")[1]
# Send a message using the session ID
message_url = f"http://localhost:8000/messages/?session_id={session_id}"
message = {
"role": "user",
"content": {
"type": "text",
"text": "Show me my Trello boards"
}
}
await client.post(message_url, json=message)
if __name__ == "__main__":
asyncio.run(connect_to_mcp_server())
機能
| 手術 | ボード | リスト | カード | チェックリスト | チェックリスト項目 |
|---|
| 読む | ✅ | ✅ | ✅ | ✅ | ✅ |
| 書く | ❌ | ✅ | ✅ | ✅ | ✅ |
| アップデート | ❌ | ✅ | ✅ | ✅ | ✅ |
| 消去 | ❌ | ✅ | ✅ | ✅ | ✅ |
詳細な機能
理事会運営
- ✅ すべてのボードを読む
- ✅ 特定のボードの詳細を読む
リスト操作
- ✅ ボード内のすべてのリストを読む
- ✅ 特定のリストの詳細を読む
- ✅ 新しいリストを作成する
- ✅ リスト名を更新
- ✅ リストをアーカイブ（削除）する
カード操作
- ✅ リスト内のすべてのカードを読む
- ✅ 特定のカードの詳細を読む
- ✅ 新しいカードを作成する
- ✅ カード属性を更新する
- ✅ カードを削除する
チェックリスト操作
- ✅ 具体的なチェックリストを入手する
- ✅ すべてのチェックリストをカードにリストする
- ✅ 新しいチェックリストを作成する
- ✅ チェックリストを更新する
- ✅ チェックリストを削除する
- ✅ チェックリストにチェック項目を追加する
- ✅ チェック項目を更新する
- ✅ チェック項目を削除する
使用法
インストールが完了すると、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に入っていることを確認してく���さい
貢献
問題や機能強化のリクエストをお気軽にお寄せください。