Trello MCP Server

Сервер протокола Model Context Protocol (MCP), предоставляющий инструменты для получения данных и взаимодействия с досками, списками и карточками Trello.

Возможности

• Получение всех досок для аутентифицированного пользователя

• Получение сведений о доске

• Получение списков с доски

• Получение карточек с досок или из списков

• Получение сведений о конкретной карточке

• Поиск карточек по всем доскам

• Получение действий/истории карточки

Related MCP server: Trello MCP Server

Настройка

1. Получение учетных данных API Trello

Важно: Вам необходимо создать Power-Up, чтобы получить учетные данные API.

1. Перейдите на https://trello.com/power-ups/admin

2. Нажмите "Create New Power-Up" (или кнопку "Crear")

3. Заполните основную информацию:

   • Name: "Trello MCP" (или любое другое имя)

   • Workspace: Выберите ваше рабочее пространство

4. После создания перейдите в раздел "API Key" в настройках вашего Power-Up

5. Вы увидите свой API Key (строка из 32 символов)

6. Нажмите на ссылку "Token" (или "token" в описании), чтобы сгенерировать токен API

7. Авторизуйте токен при появлении запроса

8. Скопируйте API key и API token

Альтернативно, вы можете перейти напрямую на https://trello.com/app-key, если у вас уже создан Power-Up.

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 key и токена

2. Убедитесь, что срок действия токена не истек

3. При необходимости перегенерируйте токен на https://trello.com/app-key

Сервер не запускается

1. Проверьте, установлен ли Node.js: node --version

2. Убедитесь, что зависимости установлены: npm install

3. Проверьте правильность установки переменных окружения

MCP-сервер показывает статус "Failed"

Если MCP-сервер показывает статус "failed" в Claude Code:

1. Отсутствует поле type: Убедитесь, что ваша конфигурация включает "type": "stdio". Это обязательно для Claude Code CLI.

2. Переменные окружения не загружены: Файл .env НЕ загружается автоматически, когда Claude Code запускает MCP-сервер. Вы должны включить объект 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