Trello MCPサーバー

Trelloのボード、リスト、カードを取得・操作するためのツールを提供するModel Context Protocol (MCP) サーバーです。

機能

• 認証済みユーザーの全ボードを取得

• ボードの詳細を取得

• ボード内のリストを取得

• ボードまたはリスト内のカードを取得

• 特定のカードの詳細を取得

• ボードを横断したカードの検索

• カードのアクション/履歴を取得

Related MCP server: Trello MCP Server

セットアップ

1. Trello API認証情報の取得

重要: API認証情報を取得するには、Power-Upを作成する必要があります。

1. https://trello.com/power-ups/admin にアクセスします

2. 「Create New Power-Up」（または「Crear」ボタン）をクリックします

3. 基本情報を入力します:

   • 名前: "Trello MCP" (任意の名前で構いません)

   • ワークスペース: ワークスペースを選択します

4. 作成後、Power-Up設定の「API Key」セクションに移動します

5. API Keyが表示されます（32文字の文字列）

6. 「Token」リンク（または説明内の「token」）をクリックして、APIトークンを生成します

7. プロンプトが表示されたらトークンを承認します

8. API keyとAPI tokenの両方をコピーします

すでにPower-Upを作成済みの場合は、直接 https://trello.com/app-key にアクセスすることも可能です。

2. 依存関係のインストール

npm install

3. 環境変数の設定

環境変数のサンプルファイルをコピーし、認証情報を追加します:

cp .env.example .env

.envを編集し、認証情報を追加します:

TRELLO_API_KEY=your_actual_api_key
TRELLO_API_TOKEN=your_actual_api_token

4. サーバーのテスト

サーバーを直接実行します:

npm start

設定

このMCPサーバーは、Claude Desktopでグローバルに設定するか、Claude Code CLIでプロジェクトごとに設定できます。

オプション1: グローバル設定 (Claude Desktop)

Claude Desktopの設定ファイルを編集します:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

以下の設定を追加します:

{
  "mcpServers": {
    "trello": {
      "command": "node",
      "args": ["/absolute/path/to/trello-mcp/index.js"],
      "env": {
        "TRELLO_API_KEY": "your_api_key_here",
        "TRELLO_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

/absolute/path/to/trello-mcp/を、このディレクトリへの実際のパスに置き換えてください。

設定を追加した後、Claude Desktopを再起動します。

オプション2: プロジェクトごとの設定 (Claude Code CLI)

Claude Code CLIの場合、MCPサーバーは~/.claude.jsonでプロジェクトごとに設定されます。

重要: type: "stdio"フィールドとenv変数を設定に直接含める必要があります。.envファイルは自動的に読み込まれません。

特定のプロジェクト用に設定するには、以下のコマンドを使用します:

# Using jq to add the configuration
jq '.projects."/path/to/your/project".mcpServers.trello = {
  "type": "stdio",
  "command": "node",
  "args": ["/Users/ehigu/Documents/Esteban/Projects/habitus/webapp/trello-mcp/index.js"],
  "env": {
    "TRELLO_API_KEY": "your_api_key_here",
    "TRELLO_API_TOKEN": "your_api_token_here"
  }
}' ~/.claude.json > /tmp/claude_config.json && mv /tmp/claude_config.json ~/.claude.json

または、~/.claude.jsonを手動で編集します:

{
  "projects": {
    "/path/to/your/project": {
      "mcpServers": {
        "trello": {
          "type": "stdio",
          "command": "node",
          "args": ["/Users/ehigu/Documents/Esteban/Projects/habitus/webapp/trello-mcp/index.js"],
          "env": {
            "TRELLO_API_KEY": "your_api_key_here",
            "TRELLO_API_TOKEN": "your_api_token_here"
          }
        }
      }
    }
  }
}

設定を追加した後、Claude Codeを再起動します。

利用可能なツール

get_my_boards

認証済みユーザーのすべてのボードを取得します。

パラメータ:

• filter (オプション): ボードをタイプでフィルタリングします (all, open, closed, starred, organization, public, members)。デフォルト: "open"

get_board

特定のボードの詳細を取得します。

パラメータ:

• board_id (必須): ボードのID

get_board_lists

ボード上のすべてのリストを取得します。

パラメータ:

• board_id (必須): ボードのID

• filter (オプション): リストをフィルタリングします (all, open, closed, none)。デフォルト: "open"

get_board_cards

ボード上のすべてのカードを取得します。

パラメータ:

• board_id (必須): ボードのID

get_list_cards

特定のリスト内のすべてのカードを取得します。

パラメータ:

• list_id (必須): リストのID

get_card

特定のカードの詳細を取得します。

パラメータ:

• card_id (必須): カードのID

search_cards

すべてのボードを横断してカードを検索します。

パラメータ:

• query (必須): 検索クエリ

• board_ids (オプション): 検索対象とするボードID（カンマ区切り）

get_card_actions

特定のカードのアクション（アクティビティ/履歴）を取得します。

パラメータ:

• card_id (必須): カードのID

使用例

Claude Desktopで設定が完了すると、自然言語を使用してTrelloボードとやり取りできます:

• "Show me all my open Trello boards"

• "Get the cards from board [board_id]"

• "Search for cards containing 'bug fix'"

• "Show me the details of card [card_id]"

• "What are the lists in my board?"

トラブルシューティング

認証エラー

認証エラーが表示される場合:

1. APIキーとトークンが正しいか確認してください

2. トークンの有効期限が切れていないか確認してください

3. 必要に応じて https://trello.com/app-key からトークンを再生成してください

サーバーが起動しない

1. Node.jsがインストールされているか確認してください: node --version

2. 依存関係がインストールされているか確認してください: npm install

3. 環境変数が正しく設定されているか確認してください

MCPサーバーが「Failed」ステータスを表示する

Claude CodeでMCPサーバーが「failed」と表示される場合:

1. typeフィールドの欠落: 設定に"type": "stdio"が含まれていることを確認してください。これはClaude Code CLIで必須です。

2. 環境変数が読み込まれていない: Claude CodeがMCPサーバーを実行する際、.envファイルは自動的に読み込まれません。設定内にenvオブジェクトを使用してAPI認証情報を直接含める必要があります:

   {
     "type": "stdio",
     "command": "node",
     "args": ["/path/to/trello-mcp/index.js"],
     "env": {
       "TRELLO_API_KEY": "your_api_key",
       "TRELLO_API_TOKEN": "your_api_token"
     }
   }

3. ログを確認: claude --debugを実行して詳細なエラーログを確認してください

4. 手動でテスト: サーバーを直接実行して動作することを確認してください:

   cd /path/to/trello-mcp
   TRELLO_API_KEY=your_key TRELLO_API_TOKEN=your_token node index.js

5. Claude Codeを再起動: 設定を変更した後、Claude Codeを完全に終了して再起動してください

MCPサーバーがClaudeに表示されない

1. 設定内のパスが絶対パスであり、正しいことを確認してください

2. Claude Desktop/Codeを完全に再起動してください

3. Claude Desktopのログでエラーを確認してください

4. Claude Code CLIの場合は、~/.claude.jsonの正しいプロジェクトパスに設定があるか確認してください

ライセンス

MIT