---
title: "AI エージェント用の個人アクセストークンを作成する"
description: "個人アクセストークンを作成して安全に保管し、権限レベルとデータソース範囲でスコープを設定して、後からそのスコープを変更したりトークンを失効させたりします"
canonical_url: "https://docs.ardge.com/ja/knowledge/precisemd/access-tokens"
---
# AI エージェント用の個人アクセストークンを作成する

> 個人アクセストークンを作成して安全に保管し、権限レベルとデータソース範囲でスコープを設定して、後からそのスコープを変更したりトークンを失効させたりします

## 概要

個人アクセストークンは、AI エージェントが特定のユーザーとして PreciseMD API を呼び出すための長期有効な認証情報です。MCP や CLI 経由のアクセスは、このトークンで認証されます。

すべてのトークンには 2 層のスコープがあります。**Permissions** が実行できる操作の種類を決め、**Data source scope** がアクセスできるストレージ接続を決めます。この記事では、トークンの作成、スコープの設定、後からのスコープ変更、および漏洩した場合の失効について説明します。

## この記事で学べること

- 個人アクセストークンを作成し、安全に保管する
- 用途に合った権限レベルとデータソース範囲を選ぶ
- トークンの最終使用日時と有効期限のステータスを確認する
- 既存トークンのスコープを変更する、またはトークンを失効させる

**所要時間: 約 10 分**

## 対象バージョン

- PreciseMD 1.4.0 以降

## 事前準備

- 許可したいストレージ接続がすでに存在すること。データソースを個別に選択する場合は必須です
- PreciseMD の管理者であること

<warning>

**メンバーは自分でトークンを作成できません：**

個人アクセストークンは **User management** ページにあり、メンバーには管理者向けインターフェースが表示されません。メンバーのトークンは管理者が作成して渡す必要があります。

</warning>

## ステップ 1: 対象ユーザーのトークン一覧を開く

1. **User management** ページに移動します
2. トークンを作成する対象ユーザーの行で、鍵アイコン **Manage personal access tokens** をクリックします

**Personal access tokens** ダイアログには「User: <username>

」と表示され、そのユーザーの既存トークンが一覧表示されます。まだ存在しない場合は「This user has no personal access tokens」と表示されます。

</username>



![ユーザー管理ページ](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/access-tokens/step-1-1.webp)

![個人用アクセストークンのダイアログ](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/access-tokens/step-1-2.webp)

## ステップ 2: トークンを作成する

1. ダイアログ上部の **Create** をクリックします
2. 次のように各項目を入力します

<table>
<thead>
  <tr>
    <th>
      項目
    </th>
    
    <th>
      入力値
    </th>
    
    <th>
      ルールと注意事項
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Name
      </strong>
    </td>
    
    <td>
      このトークンを識別する名前
    </td>
    
    <td>
      必須、1〜100 文字。用途とデバイスが分かる名前にします。例: <code>
        Claude Desktop on MacBook
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Permissions
      </strong>
    </td>
    
    <td>
      3 つのレベルのいずれか
    </td>
    
    <td>
      後述の「権限レベル」を参照してください
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Data source scope
      </strong>
    </td>
    
    <td>
      <strong>
        Authorize all data sources
      </strong>
      
       をオンにするか、個別に選択します
    </td>
    
    <td>
      どちらも設定していない状態では送信できません
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Expires
      </strong>
    </td>
    
    <td>
      トークンが無効になる日付
    </td>
    
    <td>
      任意、今日より後の任意の日付。空欄にすると期限切れになりません
    </td>
  </tr>
</tbody>
</table>

1. **Save** をクリックします

<warning>

**完全なトークンは一度だけ表示されます：**

作成後、ページに **Personal access token created** と表示され、「Copy it now — the full token can't be retrieved once you close this dialog.」という注意書きが添えられます。コピーアイコンをクリックして保管し、**I've stored it safely** をクリックしてください。保管しなかった場合、トークンを失効させて新しく作成し直すしかありません。

</warning>

### 権限レベル

<table>
<thead>
  <tr>
    <th>
      レベル
    </th>
    
    <th>
      できること
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Read only
      </strong>
    </td>
    
    <td>
      データの読み取りのみ。作成も変更もできません
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Read and write, no delete
      </strong>
    </td>
    
    <td>
      タスクの追加や実行の開始など、作成と変更ができますが、削除とキャンセルはできません
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Read, write, and delete
      </strong>
    </td>
    
    <td>
      上記すべてに加えて、リソースの削除と実行中タスクのキャンセルができます
    </td>
  </tr>
</tbody>
</table>

<tip>

**用途に必要な最小限の権限を与えてください：**

内容を抽出するだけのエージェントには **Read only** を、タスクを作成する必要があるエージェントには **Read and write, no delete** を割り当てます。**Read, write, and delete** は、エージェントが本当にリソースを削除する必要がある場合にのみ使用してください。

</tip>

### データソース範囲

- **Authorize all data sources** をオン — トークンは、後から追加されたものも含め、すべてのストレージ接続にアクセスできます
- **Authorize all data sources** をオフ — 許可する接続をドロップダウンで選択します。選択後、ボタンには「N data sources selected」と表示されます

どちらも設定せずに送信すると、項目に「Select at least one data source, or turn on authorize all」と表示されます。

![トークン作成フォーム](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/access-tokens/step-2-1.webp)

![名前とデータソースの範囲を入力した状態](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/access-tokens/step-2-2.webp)

## ステップ 3: トークンのステータスを確認する

**Personal access tokens** ダイアログに戻ると、各トークンに名前と有効期限のステータスが表示されます。ステータスは **Never expires**、**Expires on **、**Expired on **、**Revoked on ** のいずれかです。

行の **Details** をクリックすると、詳細を確認できます。

<table>
<thead>
  <tr>
    <th>
      項目
    </th>
    
    <th>
      表示内容
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        Name
      </strong>
    </td>
    
    <td>
      作成時に付けた名前
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Token
      </strong>
    </td>
    
    <td>
      どのトークンかを判別するためのマスクされたトークン文字列
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Created
      </strong>
    </td>
    
    <td>
      トークンが作成された日時
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Last used
      </strong>
    </td>
    
    <td>
      このトークンで最後に行われた API 呼び出し
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Expires
      </strong>
    </td>
    
    <td>
      有効期限の日付、または <strong>
        Never expires
      </strong>
    </td>
  </tr>
</tbody>
</table>

期限切れまたは失効したトークンでは、**Details** ボタンは無効になります。

![トークンの詳細](https://docs.ardge.com/screenshots/knowledge/ja/precisemd/access-tokens/step-3.webp)

## ステップ 4: トークンを変更または失効させる

既存トークンのスコープを変更する手順:

1. **Personal access tokens** ダイアログでその行の **Details** をクリックします
2. **Permissions** または **Data source scope** を調整します
3. **Save** をクリックします

ページに「Permission scope updated」と表示されます。**Name** と **Expires** は作成後に変更できません。

トークンを失効させる手順:

1. **Personal access tokens** ダイアログでその行の **Revoke** をクリックします
2. 確認ダイアログでもう一度 **Revoke** をクリックします

<warning>

**失効は取り消せません：**

失効すると、このトークンを使用した呼び出しは直後から失敗します。そのエージェントには新しく作成したトークンが必要です。

</warning>

ページに「Revoked "<name>

"」と表示され、その行は **Revoked on ** と表示されます。

</name>



## 関連記事

- [OCR タスクをスケジュールしてフォルダーを自動処理する](https://docs.ardge.com/ja/knowledge/precisemd/schedule-ocr-tasks)
- [組み込みエージェントで PreciseMD を操作する](https://docs.ardge.com/ja/knowledge/precisemd/built-in-agent)


## Sitemap

See the full [sitemap](https://docs.ardge.com/sitemap.md) for all pages.