Claude Desktop — YouTrack MCP

Účel

Propojení Claude Desktopu s naší YouTrack instancí přes Model Context Protocol (MCP). Po nastavení může Claude přímo číst, vyhledávat a zakládat issues v YouTracku — bez nutnosti kopírovat obsah ručně.

Naše instance: https://nittin.youtrack.cloud · MCP endpoint: https://nittin.youtrack.cloud/mcp

Předpoklady

• Nainstalovaný Claude Desktop (claude.ai/download)
• Nainstalovaný Node.js — potřebný pro npx mcp-remote
• Přístup do YouTrack instance nittin.youtrack.cloud pod svým účtem

Postup

1. Vygeneruj permanentní token v YouTracku

   Přihlas se do YouTracku a přejdi do nastavení svého profilu: klikni na avatar vpravo nahoře → Profile → Authentication → Permanent tokens → New token. Jako scope vyber YouTrack. Token zkopíruj — zobrazí se jen jednou. Začíná prefixem perm-.

   🔧 nittin.youtrack.cloud

2. Otevři konfigurační soubor Claude Desktopu

   Claude Desktop čte MCP servery z JSON konfiguračního souboru. Otevři ho v textovém editoru:

   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   Pokud soubor neexistuje, vytvoř ho jako prázdný JSON objekt: {}

   🔧 Textový editor

3. Přidej YouTrack MCP server do konfigurace

   Do souboru přidej sekci mcpServers s následující konfigurací. Nahraď perm-VÁŠTOKENZDEYOUTRACK tokenem z předchozího kroku.

   { "mcpServers": { "youtrack": { "command": "npx", "args": [ "mcp-remote", "https://nittin.youtrack.cloud/mcp", "--header", "Authorization:Bearer perm-VÁŠTOKENZDEYOUTRACK" ] } } }

   Token patří jen tobě

   Tento token dává Claude přístup k YouTracku pod tvým účtem. Nesdílej ho, nevkládej do sdílených souborů ani do gitu.

   🔧 Textový editor

4. Ulož soubor a restartuj Claude Desktop

   Ulož konfigurační soubor a úplně zavři Claude Desktop (včetně ikony v systémové liště). Poté ho znovu spusť. MCP servery se inicializují při startu aplikace.

   🔧 Claude Desktop

5. Ověř připojení

   V Claude Desktopu by se měla v novém chatu zobrazit ikona nástrojů (kladívko). Klikni na ni — v seznamu uvidíš YouTrack nástroje jako search_issues, get_issue, create_issue apod. Jako rychlý test napiš Claudovi: „Vyhledej v YouTracku otevřené issues v projektu SALES."

   🔧 Claude Desktop

Co Claude s YouTrackem umí

• Issues: vyhledávání, čtení detailu, vytváření, úprava, komentování
• Projekty: přehled projektů a jejich nastavení
• Uživatelé a skupiny: vyhledávání členů týmu
• Časové záznamy: logování spent time
• Články: čtení a vytváření dokumentace v Knowledge Base

Časté problémy

• Nástroje se v Claudovi nezobrazí — zkontroluj, že jsi Claude Desktop opravdu zavřel včetně systémové lišty a ne jen minimalizoval okno.
• Chyba autentizace / 401 — token je nejspíš špatně zkopírován nebo expiroval. Vygeneruj nový v YouTracku a aktualizuj config.
• npx: command not found — Node.js není nainstalovaný nebo není v PATH. Nainstaluj Node.js z nodejs.org a restartuj počítač.
• JSON parse error při startu Claudia — konfigurační soubor obsahuje syntaktickou chybu. Zkontroluj správnost JSON (čárky, závorky) například na jsonlint.com.

Changelog