Redmine MCP: задачи, трудозатраты и вики Redmine для агента

runekaagaard/mcp-redmine· Проверено 12.11.2026· 256на GitHub

Подключает агента к вашему Redmine по ключу API: искать и создавать задачи, менять статусы, списывать время, читать вики и вложения. Есть режим только для чтения.

3 реализации:

Три универсальных инструмента поверх OpenAPI-описания Redmine: агент сам находит нужный метод API и вызывает его; плюс загрузка и скачивание файлов.

Как подключить

Что сделать до подключения

Для загрузки и скачивания файлов задать REDMINE_ALLOWED_DIRECTORIES — список разрешённых папок через запятую

REDMINE_API_KEY

Redmine → «Моя учётная запись» → справа «Ключ доступа к API» → Show или Generate

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'REDMINE_URL=https://<ваш Redmine>' --env 'REDMINE_API_KEY=<ваш ключ API>' --transport stdio redmine \
  -- uvx --from mcp-redmine==2026.10.15.204909 --refresh-package mcp-redmine mcp-redmine

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.redmine]
command = "uvx"
args = ["--from", "mcp-redmine==2026.10.15.204909", "--refresh-package", "mcp-redmine", "mcp-redmine"]

[mcp_servers.redmine.env]
REDMINE_URL = "https://<ваш Redmine>"
REDMINE_API_KEY = "<ваш ключ API>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "redmine": {
      "command": "uvx",
      "args": [
        "--from",
        "mcp-redmine==2026.10.15.204909",
        "--refresh-package",
        "mcp-redmine",
        "mcp-redmine"
      ],
      "env": {
        "REDMINE_URL": "https://<ваш Redmine>",
        "REDMINE_API_KEY": "<ваш ключ API>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "redmine": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "mcp-redmine==2026.10.15.204909",
        "--refresh-package",
        "mcp-redmine",
        "mcp-redmine"
      ],
      "env": {
        "REDMINE_URL": "https://<ваш Redmine>",
        "REDMINE_API_KEY": "<ваш ключ API>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "redmine": {
      "command": "uvx",
      "args": [
        "--from",
        "mcp-redmine==2026.10.15.204909",
        "--refresh-package",
        "mcp-redmine",
        "mcp-redmine"
      ],
      "env": {
        "REDMINE_URL": "https://<ваш Redmine>",
        "REDMINE_API_KEY": "<ваш ключ API>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "redmine": {
      "command": "uvx",
      "args": [
        "--from",
        "mcp-redmine==2026.10.15.204909",
        "--refresh-package",
        "mcp-redmine",
        "mcp-redmine"
      ],
      "env": {
        "REDMINE_URL": "https://<ваш Redmine>",
        "REDMINE_API_KEY": "<ваш ключ API>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "redmine": {
        "type": "local",
        "command": [
          "uvx",
          "--from",
          "mcp-redmine==2026.10.15.204909",
          "--refresh-package",
          "mcp-redmine",
          "mcp-redmine"
        ],
        "environment": {
          "REDMINE_URL": "https://<ваш Redmine>",
          "REDMINE_API_KEY": "<ваш ключ API>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "redmine": {
      "command": "uvx",
      "args": [
        "--from",
        "mcp-redmine==2026.10.15.204909",
        "--refresh-package",
        "mcp-redmine",
        "mcp-redmine"
      ],
      "env": {
        "REDMINE_URL": "https://<ваш Redmine>",
        "REDMINE_API_KEY": "<ваш ключ API>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "redmine": {
      "command": "uvx",
      "args": [
        "--from",
        "mcp-redmine==2026.10.15.204909",
        "--refresh-package",
        "mcp-redmine",
        "mcp-redmine"
      ],
      "env": {
        "REDMINE_URL": "https://<ваш Redmine>",
        "REDMINE_API_KEY": "<ваш ключ API>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

redmine_paths_listперечисляет методы API Redmine

redmine_paths_infoпоказывает описание метода

redmine_requestвызывает любой метод API

redmine_uploadзагружает файл для вложения

redmine_downloadскачивает вложение в файл

redmine_attachment_imageпоказывает агенту картинку из задачи

53 готовых инструмента: задачи, время, вики, новости, диаграмма Ганта, канбан-доска в чате; плагины RedmineUP и DMSF, OAuth и вход каждого пользователя своим ключом.

Как подключить

Что сделать до подключения

Python 3.11 или новее, uv

Redmine 6.1 или 7.0: на более старых версиях работу не проверяли

REDMINE_API_KEY

Redmine → My Account → API access key → Show; администратор должен включить REST API в Administration → Settings → API

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'REDMINE_URL=https://<ваш Redmine>' --env 'REDMINE_API_KEY=<ваш ключ API>' --env REDMINE_MCP_TRANSPORT=stdio --env 'ATTACHMENTS_DIR=<абсолютный путь к папке для вложений>' --transport stdio redmine-mcp-server \
  -- uvx redmine-mcp-server

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.redmine-mcp-server]
command = "uvx"
args = ["redmine-mcp-server"]

[mcp_servers.redmine-mcp-server.env]
REDMINE_URL = "https://<ваш Redmine>"
REDMINE_API_KEY = "<ваш ключ API>"
REDMINE_MCP_TRANSPORT = "stdio"
ATTACHMENTS_DIR = "<абсолютный путь к папке для вложений>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "redmine-mcp-server": {
      "command": "uvx",
      "args": ["redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://<ваш Redmine>",
        "REDMINE_API_KEY": "<ваш ключ API>",
        "REDMINE_MCP_TRANSPORT": "stdio",
        "ATTACHMENTS_DIR": "<абсолютный путь к папке для вложений>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "redmine-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": ["redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://<ваш Redmine>",
        "REDMINE_API_KEY": "<ваш ключ API>",
        "REDMINE_MCP_TRANSPORT": "stdio",
        "ATTACHMENTS_DIR": "<абсолютный путь к папке для вложений>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "redmine-mcp-server": {
      "command": "uvx",
      "args": ["redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://<ваш Redmine>",
        "REDMINE_API_KEY": "<ваш ключ API>",
        "REDMINE_MCP_TRANSPORT": "stdio",
        "ATTACHMENTS_DIR": "<абсолютный путь к папке для вложений>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "redmine-mcp-server": {
      "command": "uvx",
      "args": ["redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://<ваш Redmine>",
        "REDMINE_API_KEY": "<ваш ключ API>",
        "REDMINE_MCP_TRANSPORT": "stdio",
        "ATTACHMENTS_DIR": "<абсолютный путь к папке для вложений>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "redmine-mcp-server": {
        "type": "local",
        "command": ["uvx", "redmine-mcp-server"],
        "environment": {
          "REDMINE_URL": "https://<ваш Redmine>",
          "REDMINE_API_KEY": "<ваш ключ API>",
          "REDMINE_MCP_TRANSPORT": "stdio",
          "ATTACHMENTS_DIR": "<абсолютный путь к папке для вложений>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "redmine-mcp-server": {
      "command": "uvx",
      "args": ["redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://<ваш Redmine>",
        "REDMINE_API_KEY": "<ваш ключ API>",
        "REDMINE_MCP_TRANSPORT": "stdio",
        "ATTACHMENTS_DIR": "<абсолютный путь к папке для вложений>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "redmine-mcp-server": {
      "command": "uvx",
      "args": ["redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://<ваш Redmine>",
        "REDMINE_API_KEY": "<ваш ключ API>",
        "REDMINE_MCP_TRANSPORT": "stdio",
        "ATTACHMENTS_DIR": "<абсолютный путь к папке для вложений>"
      }
    }
  }
}

Инструменты сервера

list_redmine_issuesперечисляет задачи с фильтрами

get_redmine_issueчитает задачу с историей

search_redmine_issuesищет задачи по тексту

create_redmine_issueсоздаёт задачу

update_redmine_issueменяет задачу и статус

copy_issueкопирует задачу

list_subtasksпоказывает подзадачи

manage_issue_relationсвязывает задачи

list_redmine_projectsперечисляет проекты

summarize_project_statusсводит состояние проекта

list_time_entriesпоказывает трудозатраты

manage_time_entryсписывает время

import_time_entriesимпортирует трудозатраты пачкой

search_entire_redmineищет по задачам и вики

manage_redmine_wiki_pageчитает и правит вики

get_redmine_attachmentскачивает вложение

get_gantt_chartвыдаёт данные диаграммы Ганта

show_triage_boardрисует канбан-доску в чате

show_project_dashboardпоказывает сводку проекта

list_redmine_issue_statusesперечисляет статусы

Показано 20 из 70.

Отдельный инструмент на каждый метод REST API Redmine, включая пользователей и группы; запуск через npx, фильтр инструментов регулярными выражениями.

Как подключить

Что сделать до подключения

Node.js с командой npx или Docker

Включённый REST API: Administration → Settings → API → Enable REST web service

REDMINE_API_KEY

создаётся в личных настройках Redmine после включения REST API администратором

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'REDMINE_URL=https://<ваш Redmine>' --env 'REDMINE_API_KEY=<ваш ключ API>' --env REDMINE_MCP_READ_ONLY=true --transport stdio redmine-mcp-server \
  -- npx -y @onozaty/redmine-mcp-server

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.redmine-mcp-server]
command = "npx"
args = ["-y", "@onozaty/redmine-mcp-server"]

[mcp_servers.redmine-mcp-server.env]
REDMINE_URL = "https://<ваш Redmine>"
REDMINE_API_KEY = "<ваш ключ API>"
REDMINE_MCP_READ_ONLY = "true"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "redmine-mcp-server": {
      "command": "npx",
      "args": ["-y", "@onozaty/redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://<ваш Redmine>",
        "REDMINE_API_KEY": "<ваш ключ API>",
        "REDMINE_MCP_READ_ONLY": "true"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "redmine-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@onozaty/redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://<ваш Redmine>",
        "REDMINE_API_KEY": "<ваш ключ API>",
        "REDMINE_MCP_READ_ONLY": "true"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "redmine-mcp-server": {
      "command": "npx",
      "args": ["-y", "@onozaty/redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://<ваш Redmine>",
        "REDMINE_API_KEY": "<ваш ключ API>",
        "REDMINE_MCP_READ_ONLY": "true"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "redmine-mcp-server": {
      "command": "npx",
      "args": ["-y", "@onozaty/redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://<ваш Redmine>",
        "REDMINE_API_KEY": "<ваш ключ API>",
        "REDMINE_MCP_READ_ONLY": "true"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "redmine-mcp-server": {
        "type": "local",
        "command": ["npx", "-y", "@onozaty/redmine-mcp-server"],
        "environment": {
          "REDMINE_URL": "https://<ваш Redmine>",
          "REDMINE_API_KEY": "<ваш ключ API>",
          "REDMINE_MCP_READ_ONLY": "true"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "redmine-mcp-server": {
      "command": "npx",
      "args": ["-y", "@onozaty/redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://<ваш Redmine>",
        "REDMINE_API_KEY": "<ваш ключ API>",
        "REDMINE_MCP_READ_ONLY": "true"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "redmine-mcp-server": {
      "command": "npx",
      "args": ["-y", "@onozaty/redmine-mcp-server"],
      "env": {
        "REDMINE_URL": "https://<ваш Redmine>",
        "REDMINE_API_KEY": "<ваш ключ API>",
        "REDMINE_MCP_READ_ONLY": "true"
      }
    }
  }
}

Инструменты сервера

getIssuesперечисляет задачи

getIssueчитает задачу

createIssueсоздаёт задачу

updateIssueменяет задачу

addWatcherдобавляет наблюдателя

getProjectsперечисляет проекты

createTimeEntryсписывает время

getTimeEntriesпоказывает трудозатраты

getWikiPageчитает страницу вики

updateWikiPageправит страницу вики

getQueriesпоказывает сохранённые запросы

uploadAttachmentFromLocalFileзагружает файл с диска

downloadAttachmentToLocalFileскачивает вложение на диск

getUsersперечисляет пользователей

searchищет по всему Redmine

updateJournalправит комментарий задачи

Показано 16 из 90.

Что попросить агента

«Создай в проекте «<проект>» баг «<заголовок>» с описанием <описание>, приоритет высокий, исполнитель <имя>»MCP Redmine найдёт метод через redmine_paths_list и redmine_paths_info и создаст задачу через redmine_request; у jztan — create_redmine_issue

«Найди все задачи с высоким приоритетом в проекте «<проект>» без исполнителя»Агент вызовет list_redmine_issues с фильтрами по проекту, приоритету и исполнителю или redmine_request к /issues.json

«Переведи задачу #<номер> в «В работе» и добавь комментарий <текст>»Агент вызовет update_redmine_issue или updateIssue со статусом и notes

«Спиши 3,5 часа на задачу #<номер> за сегодня: <описание работы>»Агент вызовет manage_time_entry, createTimeEntry или redmine_request к /time_entries.json

«Покажи задачи проекта «<проект>» канбан-доской»Redmine MCP Server от jztan нарисует доску в чате через show_triage_board; статус меняется перетаскиванием карточки

Для каких задач

Завести задачу в нужном проекте с описанием, приоритетом и исполнителем

Найти задачи по фильтру: проект, статус, исполнитель, приоритет

Перевести задачу в другой статус и оставить комментарий

Списать часы на задачу или загрузить трудозатраты пачкой

Прочитать и поправить страницу вики проекта

Скачать вложение из задачи или прикрепить файл

Ограничения

Нужен ключ API, а в Redmine администратор должен включить REST API

У MCP Redmine загрузка и скачивание файлов выключены, пока не задана REDMINE_ALLOWED_DIRECTORIES

Redmine MCP Server от jztan проверен на Redmine 6.1 и 7.0; OAuth требует 6.1 и новее, а в режиме stdio работает только с общим ключом

Redmine MCP Server от onozaty: 30 звёзд на GitHub

Если не работает

Ошибка 401 Unauthorized или «Invalid API key»

Проверьте REDMINE_API_KEY, при нужде создайте новый ключ в «Моя учётная запись». Убедитесь, что администратор включил REST web service в Administration → Settings → API.

jztan: клиент получает {"error":"unauthorized"}, хотя настроен общий ключ

Сервер запущен в режиме OAuth: переменная REDMINE_AUTH_MODE из окружения оболочки перекрыла .env. Задайте в .env REDMINE_AUTH_MODE=legacy и перезапустите сервер.

Нумерованный список агента превращается в заголовки, в заметке видна сырая разметка

Redmine и агент пишут разной разметкой. Задайте jztan-серверу REDMINE_TEXT_FORMATTING: markdown, textile, common_mark или none, как в настройках Redmine.

MCP Redmine в Docker не видит файл инструкций

REDMINE_REQUEST_INSTRUCTIONS в Docker указывает путь внутри контейнера: смонтируйте файл, например в /app/INSTRUCTIONS.md.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
MCP Redmine	Rune Kaagaard	256	локально	токен	6	15 октября 2026
Redmine MCP Server (jztan)	jztan	92	локально	токен	70	12 ноября 2026
Redmine MCP Server (onozaty)	onozaty	30	локально	токен	90	31 октября 2026

Частые вопросы

Какой вариант выбрать?

MCP Redmine даёт агенту весь API через три универсальных инструмента. У jztan 53 готовых инструмента с понятными названиями, канбан-доска и поддержка плагинов RedmineUP. У onozaty по инструменту на каждый метод REST API и запуск через npx.

Можно ли запретить агенту что-то менять?

Да. В MCP Redmine задайте REDMINE_READ_ONLY=1, у jztan — REDMINE_MCP_READ_ONLY=true, у onozaty — REDMINE_MCP_READ_ONLY=true. Тогда сервер пропускает только чтение.

Где взять ключ API Redmine?

Войдите в Redmine, откройте «Моя учётная запись» и справа найдите «Ключ доступа к API»: Show покажет ключ, Generate создаст новый. Если блока нет, администратор включает REST API в Administration → Settings → API.

Работает ли с самоподписанным сертификатом?

Да. В MCP Redmine укажите путь к своему CA в REDMINE_CA_BUNDLE, у jztan — в REDMINE_SSL_CERT. Отключить проверку можно, но только в доверенной сети.

Можно ли дать доступ нескольким сотрудникам с их правами?

У MCP Redmine в режиме HTTP каждый клиент передаёт свой ключ в заголовке X-Redmine-API-Key. У jztan есть режимы oauth, api-key-login и legacy-per-user для входа каждого пользователя своим аккаунтом.

Как подключить Redmine MCP к Claude Code?

Для onozaty: claude mcp add redmine -e REDMINE_URL=<адрес> -e REDMINE_API_KEY=<ключ> -- npx -y @onozaty/redmine-mcp-server. Для jztan в режиме stdio добавьте -e REDMINE_MCP_TRANSPORT=stdio и запуск uvx redmine-mcp-server. Готовые команды есть во вкладке Claude Code.

Можно ли запустить Redmine MCP на общем сервере?

Да. MCP Redmine запускается с --transport streamable-http и отвечает на http://HOST:PORT/mcp. Сервер jztan по умолчанию работает по HTTP на http://localhost:8000/mcp, есть образы в GHCR и docker-compose.

Работает ли сервер из России?

Серверы запускаются на вашем компьютере и обращаются только к вашему Redmine, зарубежные аккаунты не нужны.

Redmine MCP: задачи, трудозатраты и вики Redmine для агента

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы