> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tiro.ooo/llms.txt
> Use this file to discover all available pages before exploring further.

# Wiki

> 自動生成されたワークスペース Wiki を検索・トラバースする（読み取り専用）

## 概要

Wiki ツールは、Tiro が自動生成するワークスペース Wiki（ミーティングノートから抽出されたエンティティ、コンセプト、関係性）を、エージェントがトラバース可能なナレッジグラフとして公開します。4 つの**読み取り専用**ツールが、検索 → 読み取り → トラバースのチェーンを構成します。

* **`search_wiki`** — Wiki ページに対するキーワード検索。チェーンの起点です。ランク付けされたページ（`pageGuid`、`name`、`pageType`、関連度）を返し、これを他の 3 つのツールに渡します。
* **`get_wiki_page`** — 単一ページの本文（説明 + 生成状態）に加えて、メタデータと、構造化された mentions、aliases、links を返します。
* **`list_wiki_mentions`** — ページを参照しているノートの段落（ノート全体のどこでそのページが言及されているか）を返します。
* **`get_wiki_graph`** — ナレッジグラフのノード + エッジのスライスを返し、ページ同士がどうつながっているかをトラバースできます。

ノート検索に対する Wiki ならではの価値は**グラフ**にあります。テキストを読むだけでなく、エンティティから、それが言及されている箇所（`list_wiki_mentions`）へ、さらにリンクされたコンセプト（`get_wiki_graph`）へと移動できます。

5 つ目の補助ツール **`list_workspaces`** はチェーンそのものの一部ではありません。複数ワークスペースのアカウントが、どのワークスペースを対象にすべきか（各ワークスペースの `guid` と Wiki が有効かどうか）を把握できるようにし、上記 4 つのツールに明示的な `workspaceGuid` を渡せるようにします。

<Note>
  **読み取り専用（v1）。** これらのツールは Wiki を読み取るだけです。Wiki ページの作成、名前変更、マージ、削除は、v1 では MCP 経由で公開されていません（OAuth の書き込み同意は対応待ち）。ノートのコンテンツにはこれらを使わず、代わりに `search_notes` / `get_note` を使用してください。
</Note>

## アクセスとプランゲート

Wiki は**有料のオプトイン**機能です。4 つのツールは常に `tools/list` に列挙されます（すべての接続で表示されます）が、利用資格はバックエンドが**呼び出し時**に判定します。そのため、利用可能に見えるツールでもゲートレスポンスを返す場合があります。

ワークスペースが Wiki を利用できるのは、次の**両方**が満たされている場合のみです。

1. **対象プラン** — ワークスペースのサブスクリプションが Pro、Max、Team、または Enterprise であること。Free と Lite は対象外です。
2. **有効化済み** — ワークスペースの管理者が、そのワークスペースで Wiki をオンにしていること。

呼び出しがゲートされた場合、ツールは機械可読の `error_code` を含むエラーエンベロープ（HTTP `402`）を返します。

| `error_code`         | 意味                                                | 呼び出し側が取るべき対応                                                                                            |
| -------------------- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| `WIKI_PLAN_REQUIRED` | プランに Wiki が含まれていない（Free/Lite/サブスクリプションなし/非アクティブ）。 | アップグレード。`action_url` は料金プラン（B2C）またはチームの課金（チーム管理者）ページを指します。チームメンバーの場合は `null` で、メッセージには管理者に依頼するよう記載されます。 |
| `WIKI_NOT_ACTIVATED` | プランは対象だが、管理者が Wiki を有効化していない。                     | ワークスペース設定で Wiki を有効化する（管理者）か、管理者に依頼する（メンバー）。アップセルはなく、`required_plans` は `null` です。                      |

エンベロープの形式（バックエンドからそのまま中継されます）:

```json theme={"system"}
{
  "success": false,
  "error_code": "WIKI_PLAN_REQUIRED",
  "message": "위키 기능은 Pro 이상 요금제에서 사용할 수 있어요. 웹에서 로그인 후 요금제를 업그레이드해 주세요.",
  "current_plan": "Lite",
  "required_plans": ["pro", "max", "team", "enterprise"],
  "action_url": "https://tiro.ooo/#pricing",
  "status_code": 402
}
```

* `current_plan` — ワークスペースの現在のプラン表示名。サブスクリプションがない場合は `null`。
* `required_plans` — `WIKI_PLAN_REQUIRED` のアップグレード先。`WIKI_NOT_ACTIVATED` の場合は `null`。（Team Free Trial は意図的に除外されています。すでに保有しているトライアルであり、アップグレード先ではないためです。）
* `action_url` — 操作するための Web リンク。呼び出し側自身が操作できない場合（チームメンバー、または管理者による有効化）は `null`。

<Note>
  **ワークスペースの選択。** デフォルトでは、Wiki ツールは API キーからワークスペースを暗黙的に解決します。ワークスペースにバインドされたキーやチームキーは直接解決され、個人トークンや OAuth トークンは**デフォルト**ワークスペースに解決されます。これはノートツールがスコープを決める方法と同じです。

  アカウントが**複数のワークスペース**に属している場合は、[`list_workspaces`](#list_workspaces) を呼び出して列挙し（それぞれの `guid` と Wiki が有効かどうかを取得）、選んだ `workspaceGuid` を任意の Wiki ツールに渡すことで、そのワークスペースを明示的に対象にできます。`workspaceGuid` を省略すると、デフォルトワークスペースの動作が維持されます。バックエンドは、渡されたワークスペースのメンバーであることを検証します。
</Note>

## `list_workspaces`

API キーがアクセスできるワークスペースを、それぞれの `guid`、`name`、Wiki が有効かどうかとともに一覧表示します。アカウントが複数のワークスペースに属している場合に、Wiki ツール用の `workspaceGuid` を選ぶために使用します。

このツールはパラメータを取りません。次を返します。

```json theme={"system"}
{
  "workspaces": [
    { "guid": "ws_abc", "name": "Acme", "isWikiEnabled": true },
    { "guid": "ws_def", "name": "Personal", "isWikiEnabled": false }
  ]
}
```

* 個人/OAuth トークンは、あなたがメンバーであるすべてのワークスペースを列挙します。ワークスペースにバインドされたキーやチームキーは、その 1 つだけを列挙します。
* `isWikiEnabled` は、そのワークスペースで Wiki がプラン対象であり**かつ**有効化されているかどうかを反映します。`true` のワークスペースを選び、その `guid` を `workspaceGuid` として渡してください。

## `search_wiki`

キーワードで Wiki ページを検索します。最初にこれを使い、返された `pageGuid` を他のツールに渡します。

| パラメータ           | 型      | 必須     | 説明                                                                 |
| --------------- | ------ | ------ | ------------------------------------------------------------------ |
| `keyword`       | string | **必須** | ページ名に対して照合される検索語。                                                  |
| `workspaceGuid` | string | 任意     | 特定のワークスペース（`list_workspaces` から取得）を対象にします。省略するとデフォルトワークスペースを使用します。 |

ランク付けされたページ結果を返します。各結果には `pageGuid`、`name`、`pageType`（例: `CONCEPT`、`ENTITY`）、関連度スコアが含まれます。

## `get_wiki_page`

`pageGuid`（`search_wiki` から取得）で 1 つの Wiki ページを取得します。

| パラメータ           | 型      | 必須     | 説明                                                                 |
| --------------- | ------ | ------ | ------------------------------------------------------------------ |
| `pageGuid`      | string | **必須** | `search_wiki` が返すページ識別子。                                           |
| `workspaceGuid` | string | 任意     | 特定のワークスペース（`list_workspaces` から取得）を対象にします。省略するとデフォルトワークスペースを使用します。 |

ページの**本文**（説明 + 生成状態）と**メタデータ**（タイトル、種別、mention/alias/link の件数、タイムスタンプ）に加えて、ページの構造化された `mentions`、`aliases`、`links` を返します。続けて `list_wiki_mentions` を使うと、そのページがノート全体のどこで参照されているかを確認できます。

## `list_wiki_mentions`

Wiki ページに言及しているノートの段落を一覧表示します。

| パラメータ           | 型      | 必須     | 説明                                                                 |
| --------------- | ------ | ------ | ------------------------------------------------------------------ |
| `pageGuid`      | string | **必須** | ページ識別子（`search_wiki` / `get_wiki_page` から取得）。                      |
| `cursor`        | string | 任意     | 前回のレスポンスから得たページネーションカーソル。                                          |
| `workspaceGuid` | string | 任意     | 特定のワークスペース（`list_workspaces` から取得）を対象にします。省略するとデフォルトワークスペースを使用します。 |

mention レコード（ソースノート、段落、抽出テキスト、種別）とページネーションカーソルを返します。

## `get_wiki_graph`

Wiki ナレッジグラフのノード + エッジのスライスを取得します。`{ nodes, edges }` を返し、各エッジは 2 つのページ間の型付き関係を保持します。

| パラメータ                  | 型         | 必須     | 説明                                                                                  |
| ---------------------- | --------- | ------ | ----------------------------------------------------------------------------------- |
| `mode`                 | string    | **必須** | `seed`、`expand`、`around`、`links` のいずれか（下記参照）。                                       |
| `pageGuid`             | string    | 条件付き   | `expand` / `around` の起点ページ。                                                         |
| `pageGuids`            | string\[] | 条件付き   | `links` 用の明示的なページ集合。                                                                |
| `depth`                | number    | 任意     | `expand` のトラバース深さ。                                                                  |
| `radius`               | number    | 任意     | `around` の近傍半径。                                                                     |
| `limit`                | number    | 任意     | 返されるノードの最大数。デフォルト `50`、最大 `200`。                                                    |
| `q` / `type` / `since` | —         | 任意     | `seed` 用の概要フィルター。                                                                   |
| `folderId`             | number    | 任意     | `seed` のみ：このフォルダ（サブフォルダを含む再帰）内のノートが言及するページにグラフを絞り込みます。空または参照できないフォルダの場合は空のグラフを返します。 |
| `workspaceGuid`        | string    | 任意     | 特定のワークスペース（`list_workspaces` から取得）を対象にします。省略するとデフォルトワークスペースを使用します。                  |

| `mode`   | 返すもの                                                              |
| -------- | ----------------------------------------------------------------- |
| `seed`   | ワークスペースの概要グラフ（必要に応じて `q` / `type` / `since` / `folderId` でフィルター）。 |
| `expand` | `pageGuid` から `depth` の分だけ外側へトラバース。                               |
| `around` | `radius` で指定したページの近傍。                                             |
| `links`  | 明示的な `pageGuids` の集合内のリンク。                                        |

<Note>
  **結果の上限。** `get_wiki_graph` は最大で `limit` 件のノード（デフォルト `50`、最大 `200`）と、それら返されたノード**間**のエッジのみを返します（ダングリングエッジは破棄されるため、すべてのエッジの両端は `nodes` に含まれます）。元のグラフが上限を超えていた場合、レスポンスは `truncated: true` を設定します。`mode` / `q` / `type` で絞り込むか、より小さい `radius` / `depth` を指定して、焦点を絞ったスライスを取得してください。これにより、ハブページの近傍が無制限のペイロードを返すのを防ぎます。
</Note>

<Note>
  **クラスターベースの探索はまだ公開されていません。** Web アプリの新しいグラフ探索ビュー（overview/context/cluster）は内部専用です。MCP の `get_wiki_graph` ツールが公開するのは `seed` / `expand` / `around` / `links` モードです。クラスター探索の外部公開はロードマップにあります。
</Note>

## 推奨チェーン

* **まずワークスペースを選ぶ（複数ワークスペースの場合）:** `list_workspaces` → 選んだ `workspaceGuid` を下記のいずれかのツールに渡します。
* **トピックについて Wiki が知っていることを調べる:** `search_wiki` → `get_wiki_page`。
* **ページがノートのどこに根拠を持つかを調べる:** `search_wiki` → `list_wiki_mentions`。
* **コンセプト同士のつながりを探索する:** `search_wiki` → `get_wiki_graph`（`mode: "around"`、`pageGuid`）。