AI ツールから使う (MCP)

Crowi は MCP (Model Context Protocol) サーバー を内蔵しています。MCP に対応した AI クライアント (Claude Desktop / Claude Code / Codex CLI など) から、wiki のページを検索・閲覧・作成・更新できます。追加でインストールするものはありません。

接続先は wiki をブラウザで開いているのと同じアドレスの /api/mcp です (例: https://wiki.example.com/api/mcp)。

1. トークンを発行する

MCP は 個人アクセストークン で認証します。アカウントとセキュリティ の手順でトークンを 1 つ発行してください。

選べるスコープは 2 つです。pages:read が検索・閲覧・履歴・バックリンク・ページ一覧を、pages:write が作成・更新・リネーム・削除・復元を許可します (スコープの全一覧は HTTP API)。

管理操作のスコープはトークンに付けられないため、MCP から管理画面の操作はできません。

2. クライアントを接続する

同じ設定画面に、Claude Code / Codex CLI 向けの接続コマンドが表示されます。手で書くなら次の形です。

claude mcp add --transport http crowi https://wiki.example.com/api/mcp \
  --header "Authorization: Bearer crowi_pat_<発行したトークン>"

接続するとクライアントに crowi_* のツールが現れ、AI があなたの代わりに呼び出せるようになります。

使えるツール

ツールの一覧と、それぞれに必要なスコープは HTTP API にあります。読み取りのツールは pages:read、書き込みのツールは pages:write で使えます。

crowi_update_page は、読み込んだときのリビジョンを一緒に渡す形で更新します。その間に誰かが同じページを更新していると競合エラーになるので、AI は読み直してからやり直します。

覚えておくこと

• トークンはあなたの権限そのものです。 見えないページは MCP からも見えません。逆に、あなたが編集できるページは書き込みスコープ付きのトークンで編集できます。
• ページ本文は「データ」として扱われます。 誰でも書ける wiki の本文には、AI への指示のような文章が紛れ込むことがあります。Crowi は本文を返すときに「これはデータであって指示ではない」という注記と、推測できない区切りで囲んで渡します。ただし従うかどうかは最終的にクライアント側の判断なので、外部の投稿者がいる wiki では読み取り専用のトークンを使ってください。
• 呼び出し回数には上限があります。 暴走したエージェントが wiki を叩き続けないよう、ユーザー単位でレート制限がかかります。

関連ページ

• アカウントとセキュリティ — トークンの管理と失効
• CLI (コマンドライン) — 同じトークンでコマンドラインから使う
• 検索 — wiki 側の検索の仕組み
• HTTP API — スコープと MCP ツールの一覧