# 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
  ```