カーリル図書館MCP
「カーリル for AI」は、AIから利用できる図書館サービスという新しい体験を提供するための総合的な取り組みです。今回提供を開始する「カーリル図書館MCP」は、その第一歩として、Model Context Protocolを採用した図書館蔵書検索サービスです。
プレスリリース
2025年10月8日 公開
https://blog.calil.jp/2025/10/forai.html
2026年2月12日 Cursorの設定方法を追加しました
2026年2月9日 Manus（無料版,有料版）の設定方法を追加しました
2025年10月20日 大学図書館および専門図書館をサポートしました
設定ガイド
MCPサーバーエンドポイント
https://mcp-beta.calil.jp/mcp
AIエージェントサービスのサポート状況
| サービス名 | プラン | 価格 | 対応状況 | メモ |
|---|---|---|---|---|
| Claude（Anthropic） | Free | 無料 | ❌ | サポート対象外 |
| Claude（Anthropic） | Pro | $20/月 | ✅ | |
| Claude（Anthropic） | Max | $100〜/月 | ✅ | |
| Claude（Anthropic） | Team | $25/月 | ✅ | |
| Claude（Anthropic） | Enterprise | お問い合わせ | ✅ | |
| Claude Code（Anthropic） | Pro以上 | $20/月〜 | ✅ | プランはClaudeと同じ |
| ChatGPT | 無料版 | 無料 | ❌ | サポート対象外 |
| ChatGPT | Plus | $20/月 | ✅ | |
| ChatGPT | Pro | $200/月 | ✅ | |
| ChatGPT | Business | $30/月 | ✅ | |
| ChatGPT | Enterprise | お問い合わせ | ✅ | |
| GitHub Copilot（VS Code） | Free | 無料 | ✅ | |
| GitHub Copilot（VS Code） | Pro | $10/月 | ✅ | |
| GitHub Copilot（VS Code） | Pro+ | $39/月 | ✅ | |
| Gemini CLI（Google） | 無料枠 | 無料 | ✅ | Googleアカウントと連携 |
| Manus | 無料 | 無料 | ✅ | |
| Manus | Pro | $40/月 | ✅ | |
| Cursor | 無料 | 無料 | ✅ |
Claude
画面左下のアカウントアイコンを押す
設定をクリック
左のメニューの「コネクタ」を選択
一番下の「カスタムコネクタを追加」をクリック
名前はわかりやすいものを入れてください。 例）カーリル
リモートMCPサーバーURLに
https://mcp-beta.calil.jp/mcp
を入れてください。
カーリルの横にある「連携/連携させる」をクリック。
許可をクリック。
新規チャットに行って、＋ボタンの横の「検索とツール」ボタンを押して、「カーリル」がONになっていたら、設定完了です。
カーリルMCPを初めて使用する際に、上のような確認ダイアログが表示されます。
「常に許可」を選択すると、次回以降この確認は表示されなくなります。
ChatGPT
ChatGPTの有料プラン（Plus、Pro、Business、Enterprise）への加入が必要です。
現状、Web版で設定する必要があります。
https://chatgpt.com/#settings/Connectors
にアクセスするとコネクタの設定に行きます
もしくは、
左下のアカウントをクリックして、設定
Apps & Connectorを選択
一番下までスクロールして、「高度な設定」をクリック
開発者モードをONにする
Apps & Connectorに戻ると右上に「作成する」ボタンが出ているので、それをクリック
名前はわかりやすいものを入れてください。 例）カーリル
MCPサーバーのURLに
https://mcp-beta.calil.jp/mcp
を入れてください。
認証はOAuthを選択します。
「わたしはこのアプリケーションを信頼します」の横にあるチェックボックスにチェックを入れて、「作成する」を押します。
「許可」をクリック。
カーリルのカスタムコネクタが接続されました。
新規チャットに移動して、プロンプトボックスの＋ボタンを押して「カーリル」を選択。
これで設定完了です。
GitHub Copilot（VS Code）
コマンドパレットを開く
ショートカットキー( Windows/Linux: Ctrl+Shift+P, Mac: Command+Shift+P )
「MCP: サーバーの追加」を選択
「HTTP(HTTP またはサーバー送信イベント)」を選択
https://mcp-beta.calil.jp/mcp
を入れてEnter。
MCPの一意識別子を聞かれるので、わかりやすいものを入れてください。 例）calil-library-mcp
この設定をグローバルに反映するか聞かれます。 「グローバル」を選択。
許可を押すとカーリルのOAuth認証の画面を開きますか？と聞かれるので「開く」をクリック。
「許可」をクリック。
mcp.jsonに設定が保存されて表示されます。
もう一度、コマンドパレットを開く
ショートカットキー( Windows/Linux: Ctrl+Shift+P, Mac: Command+Shift+P )
「MCP: インストールされているサーバーの表示」を選択。
画面左に、拡張機能が開かれ、その下部分の「MCPサーバー - インストール済み」に、追加したMCPが表示されます。
歯車マークを押して「サーバーの起動」を選択。
設定完了です。
GitHub Copilotなどから利用できます。
Gemini CLI
Node.js
https://nodejs.org/ja/
Node.jsをインストール
ターミナル(Windows) / ターミナル(Mac)を起動
npm install -g @google/gemini-cli
gemini mcp add calil-mcp-server https://mcp-beta.calil.jp/mcp -t http -s user
gemini
> /mcp auth calil-mcp-server
「許可」をクリック。
ℹStarting OAuth authentication for MCP server 'calil-mcp-server'...
ℹ→ Opening your browser for OAuth sign-in...
If the browser does not open, copy and paste this URL into your browser:
https://calil.jp/oauth/authorize?client_id=dcr_X-sj96b6XFwO6VBKwcQPmQ&response_type=code
&redirect_uri=http%3A%2F%2Flocalhost%3A7777%2Foauth%2Fcallback&state=00qCJW3NWwpzfIDKbv7
htA&code_challenge=cDPAN5ZIswYm-4GIByCaW-DQq_T-_eIPPdTgX9n5NvE&code_challenge_method=S25
6&scope=profile&resource=https%3A%2F%2Fmcp-beta.calil.jp
💡 TIP: Triple-click to select the entire URL, then copy and paste it into your browser.
⚠️ Make sure to copy the COMPLETE URL - it may wrap across multiple lines.
ℹ✅ Successfully authenticated with MCP server 'calil-mcp-server'!
ℹRe-discovering tools from 'calil-mcp-server'...
ℹSuccessfully authenticated and refreshed tools for 'calil-mcp-server'.
> /mcp list
Configured MCP servers:
🟢 calil-mcp-server - Ready (3 tools)
Tools:
- get_ndc_info
- search_books
- search_libraries
Claude Code
Node.js
https://nodejs.org/ja/
Node.jsをインストール
ターミナル(Windows) / ターミナル(Mac)を起動
npm install -g @anthropic-ai/claude-code
claude mcp add calil https://mcp-beta.calil.jp/mcp -t http -s user
claude mcp get calil
calil:
Scope: User config (available in all your projects)
Status: ⚠ Needs authentication
Type: http
URL: https://mcp-beta.calil.jp/mcp
To remove this server, run: claude mcp remove "calil" -s user
claude
> /mcp get calil
⎿ Authentication successful. Connected to calil.
「許可」をクリック。
利用例
claude
╭─── Claude Code v2.0.13 ─────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ │ Recent activity │
│ Welcome back カーリル! │ 1d ago MCP Server API Specification Documentation │
│ │ 1d ago Debugging Complex Web App Authentication and Performance │
│ │ 1d ago Access to fetch at 'https://mcp-beta.calil.jp… │
│ ▐▛███▜▌ │ /resume for more │
│ ▝▜█████▛▘ │ ───────────────────────────────────────────────────────────────────────────────────────────────────── │
│ ▘▘ ▝▝ │ What's new │
│ │ Fixed `/plugin` not working on native build │
│ │ **Plugin System Released**: Extend Claude Code with custom commands, agents, hooks, and MCP servers … │
│ Sonnet 4.5 · Claude Max │ `/plugin install`, `/plugin enable/disable`, `/plugin marketplace` commands for plugin management │
│ R:\muteki-mcp-server │ /release-notes for more │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
> /mcp
⎿ Authentication successful. Connected to calil.
> 中津川市立図書館で1Q84を検索して
● 中津川市立図書館で「1Q84」を検索します。まず図書館のシステムIDを取得してから、蔵書を検索します。
● calil - Library Search (MCP)(keyword: "中津川市立図書館", limit: 5)
⎿ {
"libraries": [
{
… +11 lines (ctrl+o to expand)
● calil - Book Search (MCP)(systemids: ["Gifu_Nakatsugawa"], free: "1Q84", limit: "20")
⎿ {
"books": [
{
… +140 lines (ctrl+o to expand)
● 中津川市立図書館で「1Q84」を検索した結果、11件の蔵書が見つかりました。
検索結果
文庫版（新潮文庫）
1. 1Q84 BOOK1前編 (む-5-27) - 2012年4月刊
2. 1Q84 BOOK1後編 (む-5-28) - 2012年4月刊
3. 1Q84 BOOK2前編 (む-5-29) - 2012年5月刊
4. 1Q84 BOOK2後編 (む-5-30) - 2012年5月刊
5. 1Q84 BOOK3前編 (む-5-31) - 2012年6月刊
6. 1Q84 BOOK3後編 (む-5-32) - 2012年6月刊
ハードカバー版
7. 1Q84 BOOK1 - 2009年5月刊
8. 1Q84 BOOK2 - 2009年5月刊
9. 1Q84 BOOK3 - 2010年4月刊
関連書籍
10. 村上春樹の「1Q84」を読み解く (データハウス) - 2009年7月刊
11. 村上春樹『1Q84』をどう読むか (河出書房新社) - 2009年7月刊
全ての書籍は中津川市立図書館のオンライン蔵書検索システムで詳細を確認できます。
───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
>
───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
? for shortcuts
Manus
Manusにログインします。
新規チャットを開き、左下の「ツールをManusに接続する」をクリック。
コネクタの設定画面が開きます。
「カスタムMCPタブ」の「カスタムMCPを追加」をクリック。
「直接設定」を選択。
サーバー名に名前を入れます。（ここでは"Calil"と設定）
- 半角英数字のみで入力してください。
- 日本語（全角文字）を使うと、あとでエラーが出ることがあります。
トランスポートタイプは「HTTP」を選択。
サーバーURLに以下をそのままコピー＆ペーストしてください。
https://mcp-beta.calil.jp/mcp
右下の「保存」を選択すると、以下の画面がでます。 一覧から「Calil」を選択します。
「保存」の左側に 「試してみる」 というボタンが表示されます。
クリックすると、自動的に新規チャットが開き、プロンプトが入力されますので、内容はそのままで実行してください。
実行中にログインが要求されますので、ログインをクリックし、許可を選択。
初回実行時のみ、ログイン画面が要求されます。
画面の指示に従って
「ログイン」→「許可」 を選択してください。
新規チャットを開き、＋ボタン横のマークを押して、「Calil」がONになっていたら、設定完了です。
Cursor
事前準備｜Cursorをダウンロードする
https://cursor.com/ja/download
STEP1｜ログインする
STEP2｜画面右端の歯車マークを選択→Cursor Settingに移動
STEP3｜左側のタブからTools＆MCPを選択し、Installed MCP ServersのAdd Custom MCPをクリック
以下の画面が表示されます
STEP4｜以下のコードに書き換え、Ctrl + S で保存
{
"mcpServers": {
"calil": {
"url": "https://mcp-beta.calil.jp/mcp",
"transport": "http"
}
}
}
STEP5｜Cursorを再起動させ、Tool＆MCPの一覧→calil→Connectを選択
STEP6｜Openを選択
STEP7｜許可を選択
STEP8｜Tools＆MCP一覧に戻り、「calil」がONになっていたら、設定完了
技術仕様
MCPサーバーの仕様
- エンドポイントは
https://mcp-beta.calil.jp/mcp - Model Context Protocol (Version 2025-11-25準拠)
- Remote MCP
- Streamable HTTP
- OAuth 2.1 Authorization Framework
- Proof Key for Code Exchange（RFC 7636）
- Dynamic Client Registration (RFC 7591)
カーリルが確認したリダイレクト先URIについてホワイトリスト方式で許可しています。追加対応の希望があればご相談ください。localhostは既定で許可しています。 - OAuth 2.0 Authorization Server Metadata (RFC8414)
- Resource Indicators for OAuth 2.0 (RFC 8707)
ツールの機能
- 図書館蔵書検索 (
search_books)- 複数の図書館システムを横断検索（最大15館）
- フリーワード、書名、著者、出版者、NDC分類、出版年による検索
- 所蔵館情報と詳細ページURLを提供
- 図書館検索 (
search_libraries)- キーワードによる図書館検索
- システムIDの取得
- NDC分類情報取得 (
get_ndc_info)- 日本十進分類法（NDC第9版）の分類情報を提供
- 上位・下位・関連分類の参照
- 日本図書館協会が公開するオープンデータに基づく
制限事項
- 複数の自治体が同じ図書館システムを共有している場合、正しく検索できないことがあります
- ユーザー単位と全体で利用回数の制限が設定されています
- カーリル側でのアップデート等により再認証が必要となる場合があります
- 現在、認証機能はレート制限（アクセス回数の制御）のためだけに使用しています
お問い合わせ
株式会社カーリル
岐阜県中津川市坂下1645-15
https://calil.jp/doc/contact.html
更新履歴
- 2025年10月8日 初版公開
- 2025年10月9日 技術仕様を追加
- 2025年10月10日 設定ガイドに、Gemini CLI, Claude Codeを追加
- 2025年10月20日 大学図書館および専門図書館のサポートを追加
- 2026年2月9日 Manus（無料版,有料版）の設定方法を追加
- 2026年2月12日 Cursorの設定方法を追加
- 2026年2月13日 MCP Version 2025-11-25準拠に更新