MCP-сервер Trello
Мощный MCP-сервер для взаимодействия с досками, списками и карточками Trello через хосты ИИ.
Оглавление
- Оглавление
- Предпосылки
- Предварительная установка
- Установка
- Режимы сервера
- Конфигурация
- Интеграция клиента
- Возможности
- Подробные возможности
- Использование
- Поиск неисправностей
- Внося вклад
Предпосылки
- Python 3.12 или выше, может легко управляться с помощью
uv
- Установлен Claude for Desktop
- Учетная запись Trello и учетные данные API
- установлен менеджер пакетов uv
Предварительная установка
- Убедитесь, что у вас установлено приложение Claude Desktop.
- Убедитесь, что вы уже вошли в свою учетную запись в Claude.
- Старт Клод
Установка
- Настройте учетные данные API Trello:
- Перейти к администрированию приложений Trello
- Создайте новую интеграцию в New Power-Up или Integration
- Заполните свою информацию (URL-адрес коннектора Iframe можно оставить пустым) и убедитесь, что выбрали правильное рабочее пространство.
- Щелкните значок вашего приложения и перейдите к пункту «Ключ API» на левой боковой панели.
- Скопируйте свой «API-ключ» и справа: «Вы можете вручную сгенерировать токен». Нажмите на слово «токен», чтобы получить свой токен Trello.
- Переименуйте файл
.env.example
в корне проекта в.env
и задайте переменные, которые вы только что получили:
- Установите uv, если вы этого еще не сделали:
- Клонируйте этот репозиторий:
- Установите зависимости и настройте сервер для Клода с помощью uv::
- Перезапустите приложение Claude Desktop.
Режимы сервера
Этот сервер MCP может работать в двух различных режимах:
Режим приложения Клода
Этот режим напрямую интегрируется с приложением Claude Desktop:
- Установите
USE_CLAUDE_APP=true
в вашем.env
файле (это значение по умолчанию) - Запустите сервер с помощью:
- Перезапустите приложение Claude Desktop.
Режим сервера SSE
Этот режим работает как автономный сервер SSE, который можно использовать с любым MCP-совместимым клиентом, включая Cursor:
- Установите
USE_CLAUDE_APP=false
в вашем.env
файле - Запустите сервер с помощью:
- По умолчанию сервер будет доступен по адресу
http://localhost:8000
(или по настроенному вами порту)
Режим докера
Вы также можете запустить сервер с помощью Docker Compose:
- Убедитесь, что у вас установлены Docker и Docker Compose.
- Создайте файл
.env
с вашей конфигурацией - Соберите и запустите контейнер:
- По умолчанию сервер будет работать в режиме SSE.
- Для просмотра журналов:
- Чтобы остановить сервер:
Конфигурация
Сервер можно настроить с помощью переменных среды в файле .env
:
Переменная | Описание | По умолчанию |
---|---|---|
TRELLO_API_KEY | Ваш ключ API Trello | Необходимый |
TRELLO_TOKEN | Ваш токен API Trello | Необходимый |
MCP_SERVER_NAME | Имя MCP-сервера | MCP-сервер Trello |
MCP_СЕРВЕР_ХОСТ | Адрес хоста для режима SSE | 0.0.0.0 |
MCP_SERVER_PORT | Порт для режима SSE | 8000 |
ИСПОЛЬЗОВАТЬ_CLAUDE_APP | Использовать ли режим приложения Claude | истинный |
Вы можете настроить сервер, отредактировав эти значения в файле .env
.
Интеграция клиента
Использование с Claude Desktop
- Запустите сервер в режиме приложения Claude (
USE_CLAUDE_APP=true
) - Запустить или перезапустить Claude Desktop
- Клод автоматически обнаружит ваш сервер MCP и подключится к нему.
Использование с курсором
Чтобы подключить ваш MCP-сервер к Cursor:
- Запустите сервер в режиме SSE (
USE_CLAUDE_APP=false
) - В курсоре перейдите в Настройки (значок шестеренки) > ИИ > Протокол контекста модели.
- Добавьте новый сервер с URL-адресом
http://localhost:8000
(или настроенным вами хостом/портом) - Выберите сервер при использовании функций искусственного интеллекта Cursor
Вы также можете добавить эту конфигурацию в файл JSON настроек курсора (обычно в ~/.cursor/mcp.json
):
Использование с другими клиентами MCP
Для других MCP-совместимых клиентов укажите конечную точку SSE по адресу http://localhost:8000
.
Пример минимального клиента
Вот минимальный пример Python для подключения к конечной точке SSE:
Возможности
Операция | Доска | Список | Карточка | Контрольный список | Пункт контрольного списка |
---|---|---|---|---|---|
Читать | ✅ | ✅ | ✅ | ✅ | ✅ |
Писать | ❌ | ✅ | ✅ | ✅ | ✅ |
Обновлять | ❌ | ✅ | ✅ | ✅ | ✅ |
Удалить | ❌ | ✅ | ✅ | ✅ | ✅ |
Подробные возможности
Операции совета директоров
- ✅ Читать все доски
- ✅ Ознакомьтесь с подробностями конкретной доски
Список операций
- ✅ Прочитать все списки на доске
- ✅ Прочитайте конкретные детали списка
- ✅ Создавайте новые списки
- ✅ Обновить название списка
- ✅ Архивировать (удалять) списки
Операции с картами
- ✅ Прочитать все карты в списке
- ✅ Прочитайте данные конкретной карты
- ✅ Создавайте новые карты
- ✅ Обновить атрибуты карты
- ✅ Удалить карты
Контрольный список операций
- ✅ Получите конкретный контрольный список
- ✅ Перечислите все контрольные списки на карточке
- ✅ Создайте новый контрольный список
- ✅ Обновите контрольный список
- ✅ Удалить контрольный список
- ✅ Добавить контрольный пункт в контрольный список
- ✅ Обновить контрольный элемент
- ✅ Удалить контрольный элемент
Использование
После установки вы сможете взаимодействовать с досками Trello через Claude. Вот несколько примеров запросов:
- «Покажи мне все мои доски»
- «Какие списки есть на доске [имя_доски]?»
- «Создать новую карточку в списке [list_name] с заголовком [title]»
- «Обновить описание карты [имя_карты]»
- «Архивировать список [list_name]»
Вот мои примеры использования:
Поиск неисправностей
Если у вас возникли проблемы:
- Проверьте свои учетные данные API Trello в файле
.env
- Проверьте, есть ли у вас необходимые разрешения в вашем рабочем пространстве Trello.
- Убедитесь, что у вас установлена последняя версия Claude for Desktop
- Проверьте журналы на наличие сообщений об ошибках с помощью команды
uv run mcp dev main.py
- Убедитесь, что uv правильно установлен и находится в вашем PATH.
Внося вклад
Не стесняйтесь отправлять сообщения о проблемах и запросы на улучшения!
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Мощный MCP-сервер для взаимодействия с досками, списками и карточками Trello через хосты ИИ.
Related MCP Servers
- -securityFlicense-qualityAn MCP server that enables AI assistants like Claude to interact with Anki flashcard decks, allowing users to create, manage, and update flashcards through natural language conversations.Last updated -1TypeScript
- -securityFlicense-qualityA specialized MCP server that enables AI agents to interact with Reddit, including reading posts, creating content, and managing subreddit configurations.Last updated -715TypeScript
- -securityFlicense-qualityA MCP server that allows AI assistants to interact with the browser, including getting page content as markdown, modifying page styles, and searching browser history.Last updated -5TypeScript
- AsecurityAlicenseAqualityAn MCP server implementation that allows AI assistants to access, search, and interact with Dev.to content, including fetching articles, retrieving user information, and publishing new content.Last updated -1053PythonMIT License