Skip to main content

概要

Wiki ツールは、ミーティングノートから抽出したエンティティ、コンセプト、関係性を検索・閲覧するための読み取り専用ツールです。
  • search_wiki — Wiki ページに対するキーワード検索。チェーンの起点です。ランク付けされたページ(pageGuid、name、pageType、関連度)を返し、これを他の 3 つのツールに渡します。
  • get_wiki_page — 単一ページの本文(説明 + 生成状態)に加えて、メタデータと、構造化された mentions、aliases、links を返します。
  • list_wiki_mentions — ページを参照しているノートの段落(ノート全体のどこでそのページが言及されているか)を返します。
  • get_wiki_graph — ナレッジグラフのノード + エッジのスライスを返し、ページ同士がどうつながっているかをトラバースできます。
search_wiki でページを探し、list_wiki_mentions で出典を確認し、get_wiki_graph でつながっているコンセプトをたどってください。 すべての Wiki ツールには、list_workspaces で取得した workspaceGuid を渡してください。
新しい呼び出しでは、必ず workspaceGuid を明示的に渡してください。既存クライアントとの互換性を保つため、サーバーのスキーマは workspaceGuid の省略を許可します。省略した場合、認証情報に紐づくワークスペースやアクセス可能な候補から対象を 1 つに絞れるときだけ、サーバーがワークスペースを選択します。候補が複数ある場合、エラー JSON の status_code は 409 で、detail.workspaces に各候補の guid と name が含まれます。1 つ選んで再度呼び出してください。有効な認証情報でアクセスできるワークスペースがない場合、status_code は 404 です。サーバーはこれらのエラーを MCP の HTTP 200 レスポンスで result.isError: true として返します。エラー JSON はテキストコンテンツに含まれます。
読み取り専用(v1)。 Wiki ページの作成、名前変更、マージ、削除には対応していません。ノートの内容は search_notes または get_note で取得してください。

アクセスとプランゲート

Wiki は有料で、ワークスペースごとに有効化が必要です。ツールは常に一覧に表示されますが、呼び出し時にプランと有効化の状態を確認します。 次の 2 つの条件を両方とも満たす必要があります。
  1. 対象プラン — ワークスペースのサブスクリプションが Pro、Max、Team、または Enterprise であること。Free と Lite は対象外です。
  2. 有効化済み — ワークスペースの管理者が、そのワークスペースで Wiki をオンにしていること。
プランまたは有効化の条件を満たさない場合、ツールは error_code と status_code: 402 を含むエラー JSON を返します。MCP レスポンスは HTTP 200 で、result.isError: true です。 エンベロープの形式(バックエンドからそのまま中継されます):
  • current_plan — ワークスペースの現在のプラン表示名。サブスクリプションがない場合は null。
  • required_plans — WIKI_PLAN_REQUIRED のアップグレード先。WIKI_NOT_ACTIVATED の場合は null。(Team Free Trial は意図的に除外されています。すでに保有しているトライアルであり、アップグレード先ではないためです。)
  • action_url — 操作するための Web リンク。呼び出し側自身が操作できない場合(チームメンバー、または管理者による有効化)は null。

search_wiki

キーワードで Wiki ページを検索します。最初にこれを使い、返された pageGuid を他のツールに渡します。 ランク付けされたページ結果を返します。各結果には pageGuid、name、pageType(例: CONCEPT、ENTITY)、関連度スコアが含まれます。

get_wiki_page

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

list_wiki_mentions

Wiki ページに言及しているノートの段落を一覧表示します。 mention レコード(ソースノート、段落、抽出テキスト、種別)とページネーションカーソルを返します。

get_wiki_graph

Wiki ナレッジグラフのノード + エッジのスライスを取得します。{ nodes, edges } を返し、各エッジは 2 つのページ間の型付き関係を保持します。
結果の上限。 get_wiki_graph は最大で limit 件のノード(デフォルト 50、最大 200)と、それら返されたノード間のエッジのみを返します(ダングリングエッジは破棄されるため、すべてのエッジの両端は nodes に含まれます)。元のグラフが上限を超えていた場合、レスポンスは truncated: true を設定します。mode / q / type で絞り込むか、より小さい radius / depth を指定して、焦点を絞ったスライスを取得してください。これにより、ハブページの近傍が無制限のペイロードを返すのを防ぎます。
クラスターベースの探索はまだ公開されていません。 Web アプリの新しいグラフ探索ビュー(overview/context/cluster)は内部専用です。MCP の get_wiki_graph ツールが公開するのは seed / expand / around / links モードです。クラスター探索の外部公開はロードマップにあります。

推奨チェーン

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