OpenProject CE — MCP-сервер для Claude Code
MCP-сервер OpenProject CE для управления проектами и задачами в OpenProject Community Edition через ИИ-агенты. Читает и меняет рабочие пакеты, доски, встречи и расписания.
MIT ★ 45 обновлён 2026-10-29
claude mcp add --env OPENPROJECT_BASE_URL=<OPENPROJECT_BASE_URL> --env OPENPROJECT_API_TOKEN=<OPENPROJECT_API_TOKEN> --env OPENPROJECT_READ_PROJECTS=<OPENPROJECT_READ_PROJECTS> --env OPENPROJECT_WRITE_PROJECTS=<OPENPROJECT_WRITE_PROJECTS> --transport stdio openproject-ce -- uvx openproject-ce-mcpЧто делает OpenProject CE
Подключает локальные агенты к OpenProject CE через MCP stdio. Агент может создавать проекты, рабочие пакеты, подзадачи, связи, доски и встречи, логировать время, управлять участниками, версиями, файловыми хранилищами и отпусками сотрудников. Вложения картинками и текстом встраиваются в контекст модели. Любая операция записи проходит два вызова: предпросмотр и подтверждение; обойти это нельзя.
Сервер возвращает короткие типизированные ответы вместо HAL-пейлоадов OpenProject API. Снижение контекста на запрос — до 98%, если ограничить поля через параметр select. Область работы ограничена переменными OPENPROJECT_READ_PROJECTS и OPENPROJECT_WRITE_PROJECTS: пока они пусты, регистрируются только инструменты чтения статусов, типов и текущего пользователя.
Требует Python 3.10 или новее, токен OpenProject API v3 и список идентификаторов проектов для чтения и записи. Инструменты администрирования, расписаний и личных данных включаются отдельными флагами. Нацелен строго на Community Edition; Enterprise Edition функции вроде портфолио и заполнителей не поддерживаются.
Какие задачи решает
- связать агента с OpenProject CE для чтения задач, досок и встреч
- создавать рабочие пакеты, подзадачи и связи через промпт
- логировать время в задачи и управлять участниками проекта
- контролировать запись через двухэтапное подтверждение
- получать короткие ответы вместо полных HAL-объектов API
Примеры запросов агенту
- Покажи все задачи проекта
demo-projectсо статусом In Progress - Создай рабочий пакет типа Task в проекте
web-appс названием «Настроить CI» и назначь его мне - Залогируй два часа на задачу 142 с комментарием «Исправление багов»
Как установить OpenProject CE
Командой платформы
claude mcp add --env OPENPROJECT_BASE_URL=<OPENPROJECT_BASE_URL> --env OPENPROJECT_API_TOKEN=<OPENPROJECT_API_TOKEN> --env OPENPROJECT_READ_PROJECTS=<OPENPROJECT_READ_PROJECTS> --env OPENPROJECT_WRITE_PROJECTS=<OPENPROJECT_WRITE_PROJECTS> --transport stdio openproject-ce -- uvx openproject-ce-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from openproject-ce-mcp <команда>
Командой платформы
codex mcp add openproject-ce --env OPENPROJECT_BASE_URL=<OPENPROJECT_BASE_URL> --env OPENPROJECT_API_TOKEN=<OPENPROJECT_API_TOKEN> --env OPENPROJECT_READ_PROJECTS=<OPENPROJECT_READ_PROJECTS> --env OPENPROJECT_WRITE_PROJECTS=<OPENPROJECT_WRITE_PROJECTS> -- uvx openproject-ce-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from openproject-ce-mcp <команда>
Файл настроек
{
"mcpServers": {
"openproject-ce": {
"command": "uvx",
"args": [
"openproject-ce-mcp"
],
"env": {
"OPENPROJECT_BASE_URL": "<OPENPROJECT_BASE_URL>",
"OPENPROJECT_API_TOKEN": "<OPENPROJECT_API_TOKEN>",
"OPENPROJECT_READ_PROJECTS": "<OPENPROJECT_READ_PROJECTS>",
"OPENPROJECT_WRITE_PROJECTS": "<OPENPROJECT_WRITE_PROJECTS>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from openproject-ce-mcp <команда>
Файл настроек
{
"servers": {
"openproject-ce": {
"type": "stdio",
"command": "uvx",
"args": [
"openproject-ce-mcp"
],
"env": {
"OPENPROJECT_BASE_URL": "<OPENPROJECT_BASE_URL>",
"OPENPROJECT_API_TOKEN": "<OPENPROJECT_API_TOKEN>",
"OPENPROJECT_READ_PROJECTS": "<OPENPROJECT_READ_PROJECTS>",
"OPENPROJECT_WRITE_PROJECTS": "<OPENPROJECT_WRITE_PROJECTS>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from openproject-ce-mcp <команда>
Командой платформы
gemini mcp add -e OPENPROJECT_BASE_URL=<OPENPROJECT_BASE_URL> -e OPENPROJECT_API_TOKEN=<OPENPROJECT_API_TOKEN> -e OPENPROJECT_READ_PROJECTS=<OPENPROJECT_READ_PROJECTS> -e OPENPROJECT_WRITE_PROJECTS=<OPENPROJECT_WRITE_PROJECTS> openproject-ce uvx openproject-ce-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from openproject-ce-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы об OpenProject CE
Как установить OpenProject CE в Claude Code?
Запусти `claude mcp add openproject-ce-mcp -e OPENPROJECT_BASE_URL=<OPENPROJECT_BASE_URL> -e OPENPROJECT_API_TOKEN=<OPENPROJECT_API_TOKEN> -- uvx openproject-ce-mcp` и перезапусти Claude Code.
Что делает OpenProject CE?
Подключает ИИ-агенты к OpenProject Community Edition: агент читает и создаёт проекты, задачи, доски, встречи, логирует время, управляет участниками и версиями. Любая запись идёт через предпросмотр и подтверждение.
Какие переменные окружения нужны для работы?
Обязательны OPENPROJECT_BASE_URL и OPENPROJECT_API_TOKEN. Рекомендуется заполнить OPENPROJECT_READ_PROJECTS и OPENPROJECT_WRITE_PROJECTS списками идентификаторов проектов, иначе большая часть инструментов не зарегистрируется.