MCPサーバーを利用する

RunbookのMCPサーバーを利用すると、MCPに対応したAIクライアントとRunbookを簡単に連携できます。

MCPとは

MCP（Model Context Protocol）は、生成AIモデルが外部の情報にアクセスできるようにするためのしくみです。従来のAIモデルは学習時のデータのみに基づいて回答を生成するため、社内固有の情報や最新情報を取り入れることができませんでした。MCPサーバーは、Runbookなどの外部サービスと各種生成AIとを、プラグインのように連携させるためのしくみです。RunbookのMCPを使えば、生成AIからRunbookの情報の読み出しや、記事の作成、ワークフローの実行などが可能になります。

現在Runbookが提供しているMCPサーバーは以下です。

リモートMCPサーバー（β版）をセットアップする

OAuthの設定を行う

システム設定のメニューから「OAuth」を開きます。クライアントの種類を「MCPクライアント」に設定し、利用するMCPクライアントを選択します。

「MCPサーバーのURL」をコピーして、MCPクライアントに登録します。設定方法は各種MCPクライアントごとに異なりますので、マニュアル等を参考に設定を行ってください。

ローカルMCPサーバーをセットアップする

APIトークンを取得する

ローカルMCPサーバーからRunbookにアクセスするためのAPIトークンを取得する必要があります。ワークスペースのAPIトークン、個人APIトークンのどちらも使用できます。生成AIからワークフローの実行を行うには、個人APIトークンを使用してください。

デスクトップ拡張（.dxt）ファイルによるインストール

Claude Desktopなど、デスクトップ拡張に対応しているクライアントの場合は、.dxtファイルから簡単にインストールを行うことができます。

.dxtファイルのダウンロード

こちらのサイトから、最新の runbook-mcp-server-x.x.x.dxt ファイルをダウンロードしてください。

Claude Desktopへのインストール

設定を開き、「拡張機能」からダウンロードした.dxtファイルをドラッグ・アンド・ドロップしてインストールします。

設定画面が開きますので、先ほど取得したAPIトークンとご使用のドメインを入力し、「有効」のチェックをオンにすれば設定完了です。

手動でインストールする

.dxtファイルに対応していないクライアントの場合は、手動でインストールを行います。

Node.jsのインストール

バージョン20.0.0以上のNode.jsがインストールされている必要があります。Node.jsは公式サイトからダウンロードしてインストールしてください。インストール方法についてはインターネットに日本語の情報が多く存在しますので、参考にしてください。

MCPサーバーを設定する

MCPサーバーは以下のコマンドで実行することができます。

または、環境変数を使う場合

設定方法は各種AIクライアントごとに異なりますので、上記コマンドが呼び出せるように設定を行ってください。例えば、Claude Desktopの場合、設定ファイルに以下のように記述します。

MCPサーバーで利用できる操作

MCPサーバーで利用できるRunbookの操作は以下です。

• get-article: 記事を取得します。
• list-articles: 記事一覧を取得します。
• create-article: 記事を作成します。
• update-article: 記事を更新します。
• list-books: ブック一覧を取得します。
• list-categories: カテゴリー一覧を取得します。
• search-articles: 記事を検索します。
• get-process: 実行中のワークフローを取得します。
• run-process: ワークフローを実行します。

ソースコード