ttg-marketplace/README.md

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-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:

  REDMINE_URL=https://redmine.example.com REDMINE_API_KEY=xxx \
    node plugins/redmine-mcp/server/index.js