# OpenProject CE

MCP-сервер OpenProject CE для управления проектами и задачами в OpenProject Community Edition через ИИ-агенты. Читает и меняет рабочие пакеты, доски, встречи и расписания.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 45 у репозитория
- Автор: jtauschl
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/jtauschl/openproject-ce-mcp
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/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 функции вроде портфолио и заполнителей не поддерживаются.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `OPENPROJECT_BASE_URL`, `OPENPROJECT_API_TOKEN`, `OPENPROJECT_READ_PROJECTS`, `OPENPROJECT_WRITE_PROJECTS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 <команда>

## Когда брать
- связать агента с OpenProject CE для чтения задач, досок и встреч
- создавать рабочие пакеты, подзадачи и связи через промпт
- логировать время в задачи и управлять участниками проекта
- контролировать запись через двухэтапное подтверждение
- получать короткие ответы вместо полных HAL-объектов API

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
