initial commit

2026-07-23 19:33:31 +02:00
commit 32c33156a8
4 changed files with 680 additions and 0 deletions
@@ -0,0 +1,47 @@
+# TTG Marketplace — Redmine MCP
+
+Claude Code plugin marketplace, egyetlen pluginnal: **redmine-mcp**, egy függőségmentes
+Node.js MCP szerver a [Redmine REST API](https://www.redmine.org/projects/redmine/wiki/rest_api)-hoz.
+
+## Telepítés
+
+```
+/plugin marketplace add /Users/tasi/Work/TTG/redmine-mcp
+/plugin install redmine-mcp@ttg-marketplace
+```
+
+(Git repóból: `/plugin marketplace add <git-url>`.)
+
+Telepítéskor a plugin két beállítást kér:
+
+| Beállítás | Leírás |
+|---|---|
+| `redmine_url` | A Redmine példány alap URL-je, pl. `https://redmine.example.com` |
+| `redmine_api_key` | Saját fiók → jobb oldalt „API hozzáférési kulcs” (az adminnak engedélyeznie kell: Adminisztráció → Beállítások → API → REST szolgáltatás engedélyezése) |
+
+Telepítés után: `/reload-plugins` vagy új session.
+
+## Eszközök
+
+**Issue-k:** `redmine_list_issues`, `redmine_get_issue` (journals/attachments/relations include-dal), `redmine_create_issue`, `redmine_update_issue` (mezők + komment a `notes`-szal), `redmine_delete_issue`
+
+**Projektek:** `redmine_list_projects`, `redmine_get_project`, `redmine_list_versions`
+
+**Időrögzítés:** `redmine_list_time_entries`, `redmine_create_time_entry`, `redmine_update_time_entry`, `redmine_delete_time_entry`
+
+**Felhasználók:** `redmine_list_users` (admin), `redmine_get_user` (`id="current"` = saját fiók)
+
+**Referencia-adatok:** `redmine_list_metadata` — státuszok, trackerek, prioritások, aktivitások, custom mezők, szerepek, mentett lekérdezések, csoportok, projekt-kategóriák, tagságok
+
+**Wiki és keresés:** `redmine_list_wiki_pages`, `redmine_get_wiki_page`, `redmine_update_wiki_page` (upsert), `redmine_search`
+
+## Megjegyzések
+
+- A szervernek nincs npm függősége (Node 18+ beépített `fetch`), build lépés sincs.
+- Hitelesítés: `X-Redmine-API-Key` header.
+- Lapozás: `offset`/`limit` (max. 100), a válaszban `total_count`.
+- Kézi próba plugin nélkül:
+  ```sh
+  REDMINE_URL=https://redmine.example.com REDMINE_API_KEY=xxx \
+    node plugins/redmine-mcp/server/index.js
+  ```