問次郎

MCP 連携

問次郎は MCP(Model Context Protocol)サーバーを提供しています。Claude Code や Codex などの AI ツールを接続すると、AI にドキュメントを読み込ませたり、ページを作成させたりできます。

AI ツールの接続方法は2つあります。通常は、トークンを発行せずにログインして接続する方法をご利用ください。ブラウザでログインできない環境(CI やサーバー上の処理など)や、ログインでの接続に対応していない AI ツールでは、トークンで接続する方法をご利用ください。

できること

権限できること
読み取りのみプロジェクト・ページの一覧、本文の読み取り、検索、ページのスクリーンショット、書き方のガイドの読み取り、翻訳の状況の確認、質問履歴(読者が AI チャットでした質問と、AI の回答・読者の評価)の読み取り
読み取りと編集上記に加えて、ページの作成・更新・削除、画像の追加、ページツリーの並び順・深さの変更、ページの設定(非公開、ヘッダー・ページツリー・パンくずリスト・前後のページへのリンク・目次・フッターの表示)の変更、翻訳の入力、カバー画像・ヘッダーのロゴ・ファビコンの設定、カテゴリーの変更、AI チャットの設定(AI チャットを使えるようにするか・サービス名・サービスの概要・あいさつ・表示の形・メッセージテンプレート)の変更

AI チャットの「埋め込んでよいサイト」は、MCP では変更できません。問次郎の画面で設定してください。

権限は、ログインして接続する場合は許可の画面で、トークンで接続する場合はトークンの発行時に選択します。どちらの方法でも、AI ツールは接続したユーザーのアカウントとして、そのユーザーの権限の範囲でプロジェクトを利用します。

1つの接続(ログインして接続したアプリ、または MCP トークン)で利用できるのは、1つの組織のプロジェクトのみです。権限は、その組織でのユーザーの権限です。組織から外されると、その組織の接続とトークンは利用できなくなります。

AI が編集するのは作業中の内容のみです。公開は自動では行われません。カバー画像・ロゴ・ファビコンや AI チャットの設定も、作業中の内容に設定されます。内容を画面で確認したうえで、プロジェクト公開の手順で公開してください。

AI は、ページを作成する前に問次郎の書き方のガイドを読み込みます

MCP には、問次郎のドキュメントの書き方のガイド(ページの構成、AI チャットが回答しやすい書き方、ブロックの使い分けなど)が含まれています。AI ツールは、このガイドを読み込んでからページを作成します。

ログインして接続する

認証用のトークンを発行する必要はありません。AI ツールが開くブラウザで問次郎にログインし、接続を許可します(MCP の OAuth という仕組みを利用します)。MCP サーバーを URL で追加でき、OAuth でのログインに対応している AI ツールであれば、この方法で接続できます。

AI ツールに追加する MCP サーバーの URL は、次のとおりです。

テキスト
https://app.monjiro.io/mcp

以前の URL(https://app.monjiro.io/api/mcp)で追加した AI ツールも、設定を変えずにそのまま利用できます。

接続の流れは、どの AI ツールでも共通です。

  1. AI ツールに、上記の URL を MCP サーバーとして追加します。
  2. AI ツールで認証(ログイン)を開始します。ブラウザで問次郎の画面が開きます。
  3. 問次郎にログインしていない場合は、ログイン画面が表示されます。ログインすると、接続を許可する画面に進みます。
  4. 許可の画面で、許可する内容(「読み取りのみ」または「読み取りと編集」)を選択し、「許可」を押します。所属している組織が2つ以上ある場合は、「接続する組織」で、AI ツールから利用する組織も選択します(初期状態では、いま選んでいる組織が選ばれています)。
接続を許可する画面。「「Claude Code」が、問次郎への接続を求めています」という見出しの下に、接続するアカウント(組織名とメールアドレス)、「接続する組織」の選択肢(株式会社サンプル・サンプル制作室)、許可する内容として「読み取りのみ」と「読み取りと編集」の選択肢、許可したあとに戻る先(localhost)、「拒否」と「許可」のボタンが表示されている。
  1. ブラウザから AI ツールに戻り、問次郎の MCP が利用できるようになります。

URL の追加方法と認証の開始方法は、AI ツールによって異なります。あわせて、各 AI ツールの説明をご確認ください。

許可の画面には、接続を求めているアプリの名前と、許可したあとの戻り先(お使いのパソコンの localhost や、AI ツールのサービスのアドレス)が表示されます。アプリの名前は、アプリ自身が名乗っているものです。ご自身で開始した接続でない場合は、「拒否」を押してください。

例: Claude Code の場合

  1. ターミナルで次のコマンドを実行し、MCP サーバーを追加します。
テキスト
claude mcp add --transport http monjiro https://app.monjiro.io/mcp
  1. Claude Code で /mcp を入力し、一覧から monjiro を選択して、認証を開始します。ブラウザが開いたら、上記の手順3以降と同じように、ログインして接続を許可します。

接続後の使い方

接続後は、AI ツールに次のような依頼ができます。

  • 「問次郎のプロジェクトの一覧を見せて」
  • 「〇〇のページを書いて」
  • 「〇〇のページを、△△のページの下に移して」「ページの並び順を、手順の順に並べ替えて」
  • 「〇〇のページを非公開にして」
  • 「お知らせのページでは、前後のページへのリンクを表示しないようにして」
  • 「先月の質問履歴を見て、回答の評価がよくなかった質問に答えられるよう、ページを直して」
  • 「質問履歴でよく聞かれている質問を3つ選んで、AI チャットのメッセージテンプレートに設定して」
  • 「このロゴの画像を、ヘッダーのロゴに設定して」

ログインして接続した場合、接続はそのまま継続して利用できます。ただし、30日間一度も利用しなかった場合は、再度ログインして接続を許可する必要があります。

質問履歴に含まれる情報について

質問履歴には、読者が AI チャットに入力した文がそのまま含まれます。AI ツールに読み込ませる場合は、読者が入力した個人情報なども AI ツールに渡ることにご注意ください。

接続しているアプリを確認する・取り消す

画面右上のアカウントのメニューから「アカウント設定」を開くと、「MCP で接続しているアプリ」に、ログインして許可したアプリの一覧が表示されます。表示されるのは、いま選んでいる組織で許可したアプリのみです。ほかの組織のアプリを確認するには、組織を切り替えてください。アプリごとに、許可した内容、接続した日、最後に利用した日時を確認できます。

アカウント設定の「MCP で接続しているアプリ」。Claude Code に追加するコマンドの例の下に、接続しているアプリ(Claude Code、MCP Inspector)の一覧があり、それぞれに許可した内容(読み取りと編集)、接続した日、最後に使った日時と「取り消し」のボタンが表示されている。

接続を取り消すには、対象のアプリの「取り消し」を押し、確認の表示で「取り消す」を押します。取り消したアプリは、すぐに利用できなくなります。再度利用するには、ログインして接続を許可し直してください。

許可する内容を変更したい場合は、AI ツールから再度ログインして許可し直すと、新しく選択した内容に置き換わります。

トークンで接続する

ブラウザでログインできない環境や、ログインでの接続に対応していない AI ツールでは、アカウント設定で発行したトークンを使って接続します。

トークンを発行する

トークンは、いま選んでいる組織のトークンとして発行されます。別の組織で使うトークンは、その組織に切り替えてから発行してください。

  1. 画面右上のアカウントのメニューから「アカウント設定」を開きます。
  2. 「MCP トークン」の「トークンを発行」を押します。
  3. 名前(例: Claude Code)、有効期限(30日・90日・1年)、権限を選択して「発行」を押します。
MCP トークンを発行する画面
  1. 発行したトークンと、接続の例(Claude Code・Codex)が表示されます。トークンはこのときにしか表示されません。コピーして、安全な場所に保管してください。

Claude Code にトークンで接続する

ターミナルで次のコマンドを実行します。<トークン> は、発行したトークンに置き換えてください。

テキスト
claude mcp add --transport http monjiro \
  https://app.monjiro.io/mcp \
  --header "Authorization: Bearer <トークン>"

Codex に接続する

Codex では、トークンの値をコマンドで直接指定できません。トークンを環境変数に設定し、その環境変数の名前を指定します。

  1. ターミナルで次のコマンドを実行します。
テキスト
codex mcp add monjiro \
  --url https://app.monjiro.io/mcp \
  --bearer-token-env-var MONJIRO_MCP_TOKEN
  1. トークンを、環境変数 MONJIRO_MCP_TOKEN に設定します。シェルの設定ファイル(~/.zshrc など)に次の行を追加し、ターミナルを開き直してください。<トークン> は、発行したトークンに置き換えます。
テキスト
export MONJIRO_MCP_TOKEN="<トークン>"
  1. Codex を再起動すると、問次郎の MCP が利用できるようになります。依頼の仕方は、ほかの AI ツールと同じです。

トークンは Codex の設定にもコマンドの履歴にも残らず、環境変数から読み込まれます。

URL を指定できない場合

Codex のバージョンによっては、codex mcp add で --url を指定できないことがあります。その場合は、設定ファイル(~/.codex/config.toml)に次の内容を追加してから、手順2に進んでください。

テキスト
[mcp_servers.monjiro]
url = "https://app.monjiro.io/mcp"
bearer_token_env_var = "MONJIRO_MCP_TOKEN"

トークンを取り消す

アカウント設定の「MCP トークン」の一覧で、対象のトークンの「取り消し」を押し、確認の表示で「取り消す」を押します。取り消したトークンは、すぐに利用できなくなります。一覧に表示されるのは、いま選んでいる組織のトークンのみです。

トークンは、パスワードと同様に厳重に管理してください。トークンを使うと、発行したユーザーのアカウントとして、その組織のプロジェクトを読み書きできます。漏えいのおそれがある場合は、すぐに取り消してください。