OpenProject — MCP-сервер для Claude Code: что делает и как установить
Подключает инстанс OpenProject к ассистенту через API v3. Помогает управлять задачами и отчётами прямо из чата.
claude mcp add --env OPENPROJECT_URL=<OPENPROJECT_URL> --env OPENPROJECT_API_KEY=<OPENPROJECT_API_KEY> --env OPENPROJECT_OAUTH_TOKEN=<OPENPROJECT_OAUTH_TOKEN> --env OPENPROJECT_MCP_READ_ONLY=<OPENPROJECT_MCP_READ_ONLY> --env OPENPROJECT_MCP_ADMIN_TOOLS=<OPENPROJECT_MCP_ADMIN_TOOLS> --transport stdio openproject -- uvx openproject-mcp-serverЧто делает OpenProject
Сервер открывает ИИ доступ к 91 инструменту рабочей среды OpenProject через официальный API v3. Агент умеет фильтровать задачи по срокам и обновлять статусы. Ответы приходят в виде строгих типизированных схем. Модели не нужно разбирать неструктурированный текст.
Разработка ориентирована на редакции Community, где нет встроенной интеграции с ассистентами. Поддерживаются любые выпуски от 14 LTS до 17.x. Окружению требуется Python не ниже 3.12 и действующий ключ доступа. Без них утилита завершает работу с кодом 2 вместо выброса сырого стека вызовов.
Для защиты данных предусмотрен режим только для чтения. Любая деструктивная операция требует явного флага подтверждения. Изменение участников проекта блокируется без прав администратора.
Какие задачи решает
- отслеживать горящие тикеты и менять их приоритеты
- собирать отчёты по спринтам и закрытым задачам
- списывать трудозатраты в карточках задач
- публиковать комментарии в ветках обсуждений
Примеры запросов агенту
- Покажи открытые задачи в проекте website-relaunch, у которых срок сдачи до пятницы.
- Подними приоритет бага #4821 до High и оставь комментарий разработчику.
- Сформируй еженедельный отчёт по спринту в проекте website-relaunch.
Как установить OpenProject
Командой платформы
claude mcp add --env OPENPROJECT_URL=<OPENPROJECT_URL> --env OPENPROJECT_API_KEY=<OPENPROJECT_API_KEY> --env OPENPROJECT_OAUTH_TOKEN=<OPENPROJECT_OAUTH_TOKEN> --env OPENPROJECT_MCP_READ_ONLY=<OPENPROJECT_MCP_READ_ONLY> --env OPENPROJECT_MCP_ADMIN_TOOLS=<OPENPROJECT_MCP_ADMIN_TOOLS> --transport stdio openproject -- uvx openproject-mcp-serverВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from openproject-mcp-server <команда>
Командой платформы
codex mcp add openproject --env OPENPROJECT_URL=<OPENPROJECT_URL> --env OPENPROJECT_API_KEY=<OPENPROJECT_API_KEY> --env OPENPROJECT_OAUTH_TOKEN=<OPENPROJECT_OAUTH_TOKEN> --env OPENPROJECT_MCP_READ_ONLY=<OPENPROJECT_MCP_READ_ONLY> --env OPENPROJECT_MCP_ADMIN_TOOLS=<OPENPROJECT_MCP_ADMIN_TOOLS> -- uvx openproject-mcp-serverВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from openproject-mcp-server <команда>
Файл настроек
{
"mcpServers": {
"openproject": {
"command": "uvx",
"args": [
"openproject-mcp-server"
],
"env": {
"OPENPROJECT_URL": "<OPENPROJECT_URL>",
"OPENPROJECT_API_KEY": "<OPENPROJECT_API_KEY>",
"OPENPROJECT_OAUTH_TOKEN": "<OPENPROJECT_OAUTH_TOKEN>",
"OPENPROJECT_MCP_READ_ONLY": "<OPENPROJECT_MCP_READ_ONLY>",
"OPENPROJECT_MCP_ADMIN_TOOLS": "<OPENPROJECT_MCP_ADMIN_TOOLS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from openproject-mcp-server <команда>
Файл настроек
{
"servers": {
"openproject": {
"type": "stdio",
"command": "uvx",
"args": [
"openproject-mcp-server"
],
"env": {
"OPENPROJECT_URL": "<OPENPROJECT_URL>",
"OPENPROJECT_API_KEY": "<OPENPROJECT_API_KEY>",
"OPENPROJECT_OAUTH_TOKEN": "<OPENPROJECT_OAUTH_TOKEN>",
"OPENPROJECT_MCP_READ_ONLY": "<OPENPROJECT_MCP_READ_ONLY>",
"OPENPROJECT_MCP_ADMIN_TOOLS": "<OPENPROJECT_MCP_ADMIN_TOOLS>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from openproject-mcp-server <команда>
Командой платформы
gemini mcp add -e OPENPROJECT_URL=<OPENPROJECT_URL> -e OPENPROJECT_API_KEY=<OPENPROJECT_API_KEY> -e OPENPROJECT_OAUTH_TOKEN=<OPENPROJECT_OAUTH_TOKEN> -e OPENPROJECT_MCP_READ_ONLY=<OPENPROJECT_MCP_READ_ONLY> -e OPENPROJECT_MCP_ADMIN_TOOLS=<OPENPROJECT_MCP_ADMIN_TOOLS> openproject uvx openproject-mcp-serverВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from openproject-mcp-server <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о OpenProject
Как установить OpenProject в Claude Code?
Выполните команду `claude mcp add openproject-mcp-server -e OPENPROJECT_URL=<OPENPROJECT_URL> -e OPENPROJECT_API_KEY=<OPENPROJECT_API_KEY> -e OPENPROJECT_OAUTH_TOKEN=<OPENPROJECT_OAUTH_TOKEN> -- uvx openproject-mcp-server`.
Что делает MCP-сервер OpenProject?
Он связывает модель с OpenProject API v3, предоставляя инструменты для чтения задач, изменения статусов и выгрузки проектных отчётов.
Какие системные требования нужны для работы?
Необходим Python версии 3.12 или выше, инстанс OpenProject от 14 LTS до 17.x и персональный ключ доступа из настроек аккаунта.
