> ## Documentation Index
> Fetch the complete documentation index at: https://hc.saas-manager.biz.nuro.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# YouTrack Self-Hosted

> YouTrack Self-Hosted との連携手順です。

## サポートする機能

<Badge color="blue">プロビジョニング</Badge> <Badge color="blue">アカウント削除</Badge>

<Info>
  連携には管理者権限のアカウントが必要です。
</Info>

## 事前準備

### ログイン方法

[YouTrack ログインページ](https://www.jetbrains.com/youtrack/)にて、メールアドレス・パスワードを入力し、ログインします。

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6gicv4soc5/2026-01-05-175010.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=22395dce7d8d6edf116917111f2f20e2" alt="YouTrack ログイン画面" width="433" height="508" data-path="images/integrations/6gicv4soc5/2026-01-05-175010.png" />

### Base URL の確認方法

**Hub Service URL** を Base URL として使用します。

Hub Service URL は、YouTrack の認証・ユーザー管理する **Hub サービスの URL** です。

* **YouTrack にアクセスする際の URL（Primary YouTrack Service URL）** を確認します。

例：`https://www.mycompany.com`

* 次に、上記 URL に対応する **Hub Service URL** を確認します。\
  Hub Service URL は、以下のように **URL に `hub` を含む** 形式になります。

例：`https://www.mycompany.com/hub`、`https://hub.mycompany.com`

* 確認できた **Hub Service URL** を **Base URL** として設定してください。

<Info>
  URL に `hub` が含まれていることを確認してください。
</Info>

### API キーの取得方法

画面右上のアイコンをクリックし、 **Profile** をクリックします。

**Account Security** タブから、**New token** をクリックします。

**トークン名・スコープ**を指定し、**Create** をクリックします。

作成された **API キー**をコピーします。

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6gicv4soc5/screenshot-2025-12-26-at-14-16-59.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=215b2cf83a56dece8294738536edc62b" alt="API キー取得画面" width="1816" height="1258" data-path="images/integrations/6gicv4soc5/screenshot-2025-12-26-at-14-16-59.png" />

#### スコープについての補足

組み込みの Hub サービスを使用している YouTrack では、以下のようにスコープが分かれています。

**YouTrack**

課題、タグ、コマンド、アジャイルボード、ダッシュボード、レポートなど YouTrack の基本的な操作するための権限

**YouTrack Administration**

プロジェクト管理、ユーザーアクセスの管理、サーバー設定の更新するための権限

## インテグレーションのセットアップ

マネーフォワード Admina のインテグレーション画面にて、**YouTrack Self-Hosted** で検索します。

任意の**ワークスペース名**、前の手順で取得した **Base URL**、**API キー**を入力し、**連携する**をクリックします。

<img src="https://mintcdn.com/admina-sbn/ORUY-8P7xU7apqUD/images/integrations/6gicv4soc5/2026-01-07-145331.png?fit=max&auto=format&n=ORUY-8P7xU7apqUD&q=85&s=c6c265c9eb223614adcd0867da26a54a" alt="インテグレーション設定画面" width="460" height="620" data-path="images/integrations/6gicv4soc5/2026-01-07-145331.png" />

連携に成功すると、アカウント一覧に登録済みのユーザー情報が表示されます。

正常に完了しない場合は、インテグレーション画面のステータスタブから**編集**し、再度連携をお試しください。

解決しない場合はチャットにてお問い合わせください。