lens

Mindola MCP サーバー

Mindolaは、個人が所有する資料（文章、メモ、ドキュメント、リンク）だけをもとに、引用付きで質問に答える公開AIページを作成します。

この公開AIページはレンズと呼ばれます。https://mindola.ai/me/your-nameのような共有可能なリンクを通じて、誰でもチャットやリアルタイムの音声通話で質問できます。すべての回答は所有者の資料だけに基づき、出典も表示されます。資料に質問の答えがない場合、レンズは推測せずに正直にそう伝え、質問を本人に取り次ぐこともできます。

このリポジトリは、Mindolaのホスト型MCPサーバーに関する公開ドキュメントとサンプルを提供します。サーバーはリモートで動作するため、インストールや実行は不要です。MCP クライアント（Claude、Cursor、VS Code、Codex、ChatGPT）にURLを1つ追加すれば、AI アシスタントとの1回の会話で、レンズの作成と内容の追加ができます。サーバー自体はクローズドソースのMindolaアプリ内で動作します。このリポジトリにはドキュメントとサンプルコードが含まれています。

今すぐライブレンズをお試しください。アカウントは不要です：mindola.ai/me/charles-darwin。

Mindolaが解決する課題

人々は、誰にも読まれない知識を公開しています。ブログ記事、ドキュメント、コース教材、メモはアーカイブに埋もれ、訪問者はそこから必要な情報を探さなければなりません。ほとんどの人はそうしません。知りたいことは1つだけで、答えを1つ求めています。

一般的なAIチャットボットでは解決になりません。学習に使われたあらゆる情報をもとに回答するため、あなたやあなたの製品、仕事について自信満々にでたらめを作り出すことがあります。それなら、答えがないほうがましです。

Mindolaはその間を埋めます。あなたの資料への入り口となるページを作り、ナレッジベースだけをもとに質問に回答し、回答ごとに出典を示し、わからないときはそれを認めます。訪問者はアーカイブではなく回答を得られ、あなたはどんな質問が寄せられたかを確認できます。

自分でRAGを構築する代わりにMindolaを選ぶ理由

検索拡張生成（RAG）を自分で構築するのは、本格的なプロジェクトです。あらゆるソース形式に対応する取り込み処理、ドキュメント構造を考慮したチャンク分割、埋め込み、ベクトルストア、検索の調整、モデルが資料の範囲内で回答するためのグラウンディングロジック、引用を表示するUI、範囲外の質問への拒否動作に加え、ホスティング、監視、フロントエンドも必要です。リアルタイム音声を加えると、作業量はおおよそ倍になります。

Mindolaなら、完成した製品を1つのリンクと1つのAPIで利用できます。資料を用意すれば、知識検索、根拠に基づく回答、引用、回答の拒否、音声、公開ページ、未回答の質問を受け取る受信箱はMindolaが対応します。コーディングアシスタントとの1回の会話で、何もない状態から、根拠に基づくAIページを動作させることができます。

状況によっては、自分で構築するのが適切な選択肢です。使用するモデルやデータの保存場所、検索順位を完全に制御したい場合や、既存製品にパイプラインを深く組み込みたい場合は、自分で構築してください。Mindolaは、パイプラインを自分で管理せずに、その成果を得たい人のためのサービスです。

主な機能

• 根拠に基づく回答と引用。 すべての回答はオーナーの資料のみをもとにしており、出典も表示されます。非公開の資料が引用に漏れることはありません。
• 正直な回答拒否。 範囲外の質問には、幻覚による回答ではなく、「わかりません」と明確に答えます。
• リアルタイムの音声通話。 訪問者はレンズとリアルタイムで会話でき、割り込みにも対応します（話の途中でも訪問者が会話に割り込めます）。オーナーはクローン音声または既定の音声を使用できます。
• リード獲得機能を標準搭載。 レンズが回答できない質問は、訪問者の情報とともにオーナーの受信箱に届くため、レンズを簡易 CRM としても活用できます。
• 任意の決済機能。 オーナーは Stripe Connect を通じて訪問者から料金を受け取れます。自身の Stripe アカウントを使用し、レンズごとに料金を設定できます。既定では無効です。
• 10 のアプリ言語。 アプリの UI は、英語、オランダ語、ドイツ語、スペイン語、フランス語、アラビア語、日本語、韓国語、トルコ語、中国語に対応しています。
• 1 つのリンクで幅広く活用。 同じレンズにどのような情報を与えるかに応じて、ウェブサイト、ドキュメント、コーチング業務などに対応できます。

インストール

MCP サーバーはホストされているため、ローカルで実行する必要はありません。クライアントから URL を指定してください。

Claude Code

claude mcp add --transport http mindola https://app.mindola.ai/mcp/lens

Cursor（~/.cursor/mcp.json またはプロジェクトの .cursor/mcp.json）

{
  "mcpServers": {
    "mindola": {
      "url": "https://app.mindola.ai/mcp/lens"
    }
  }
}

Claude Desktop / claude.ai

Settings -> Connectors -> Add custom connector -> URL https://app.mindola.ai/mcp/lens。

VS Code、Codex CLI、Windsurf、Gemini CLI、ChatGPT、およびトラブルシューティングについては、docs/installation.md をご覧ください。すぐにコピーできるクライアント設定は examples/clients/ にあります。

クイックスタート

AI アシスタントを使う場合

1. 上記のいずれかの設定を使ってサーバーに接続します。
2. 次のようなプロンプトを貼り付けます。

Create a Mindola lens for me. I'm a nutrition coach specializing in
plant-based diets for endurance athletes. I've been coaching for 8 years.
Use a warm tone. Ask me anything you need, then show me the profile
before you create it.

3. アシスタントがプロフィール（名前、自己紹介、専門分野、事実、境界）を作成し、内容を提示します。ツールの指示により、アシスタントは作成前に明示的な確認を得る必要があり、会話でユーザーが提供または確認した情報のみを使用します。
4. 確認します。アシスタントが create_digital_twin_lens を呼び出し、次の情報を返します。
   • shareUrl：すぐに公開されるレンズの公開ページ
   • claimUrl：開いて無料で登録すると、レンズを自分のものにできます
   • manageUrl、expiresAt、factCount、suggestedPrompts

作成にアカウントは不要です。レンズは最初は未登録の状態で、share URL から利用できます。登録されない場合は 30 日後に期限切れになります。未登録の間は、アシスタントに add_lens_knowledge を使って知識を追加し続けることができます。登録後の変更は、アプリまたは認証済みの開発者 API から行います。

5. 同じ会話を続けます。アシスタントに記事やページを追加するよう依頼します。

Add my last three blog posts to the lens, then check the ingestion
status and tell me when everything is ready.

アシスタントが URL を指定して add_lens_knowledge を呼び出し、知識の件数がすべて準備完了になるまで get_lens_status をポーリングします。share URL を開いて、レンズに質問してみましょう。

REST API を使う場合

Mindola アプリで API キーを作成し、1 回のリクエストで知識をシードしたレンズを作成します。

curl -s https://app.mindola.ai/api/v1/lenses \
  -H "Authorization: Bearer mnd_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Product docs assistant",
    "greeting": "Hi, ask me anything about the product.",
    "knowledge": [
      { "type": "url", "content": "https://example.com/docs/getting-started", "title": "Getting started" },
      { "type": "text", "content": "Refunds are available within 30 days of purchase.", "title": "Refund policy" }
    ]
  }'

レスポンスは { id, token, shareUrl, sourcesQueued } を含む 201 です。取り込みはバックグラウンドで実行されるため、知識の件数が ready になるまで GET /api/v1/lenses/:id をポーリングしてください。詳細なリファレンスは docs/api.md をご覧ください。

実際の活用例 20 選

1. コーチ：あなたのメソッドに基づいて質問に答え、あなた本人が対応する必要のある質問では見込み客の情報を取得する、何でも質問できるページです。
2. オープンソースのメンテナー：読者が検索しなくても、引用元を示しながら質問に答える開発者向けドキュメントです。
3. コース作成者：シラバスやレッスンに基づき、学生が午前 2 時でも質問できるコースアシスタントです。
4. インディー創業者：ドキュメントや変更履歴に基づいて回答する、小規模な製品向けのカスタマーサポート AI です。
5. 求職者：チャットまたは音声で、採用担当者からの経歴に関する質問に答える履歴書です。
6. 小規模チーム：チーム全員が質問できる、1 つのリンクからアクセスできる社内ドキュメントです。
7. ポッドキャスター：エピソードのメモや書き起こしをもとに作成したペルソナで、リスナーがエピソードの合間に質問できます。
8. ニュースレターの執筆者：何年分もの配信をスクロールする代わりに、読者が検索できるアーカイブです。
9. カンファレンスの登壇者：スライドやメモをもとに作成し、講演終了後も参加者が質問できるページです。
10. コンサルタント：最初の打ち合わせ前に、問い合わせてきた見込み客の条件を確認する AI 専門家ページです。
11. 著者：あなたのアイデアについて議論し、その出典となる章を示す書籍の companion です。
12. 代理店：自社の資料に基づいて、業務範囲、プロセス、料金に関する質問にあらかじめ答えるサービスページです。
13. 教師：授業で実際に教えた内容に沿って回答する、授業資料に基づいた学習支援ツールです。
14. 研究者：論文に関する質問に答え、正確な出典を示すページです。
15. プロダクトマネージャー：「X はもうリリースしましたか」という質問に自動で答える、リリースノートの視点です。
16. 地域の事業者：自社のページに基づいて、営業時間、サービス、ポリシーに関する質問に答える、ウェブサイトの視点です。
17. 人事チーム：共有ドライブではなく、従業員ハンドブックに基づいて回答するオンボーディングアシスタントです。
18. フィットネストレーナー：Stripe を通じた有料 Q&A で、訪問者があなたのレンズに直接質問するために料金を支払います。
19. コミュニティマネージャー：モデレーションに関する質問に一貫して答える、ルールとガイドラインのボットです。
20. 歴史教育者：Charles Darwin のデモのように、パブリックドメインの人物に命を吹き込みます。

このうち 10 件は examples/use-cases/ で最初から最後まで具体的に紹介しています。それぞれに、貼り付けて使えるプロンプト、想定される会話、最終的な成果が含まれています。

プロンプトの例

サーバーを接続したら、次のいずれかを Claude、Codex、Cursor、または ChatGPT に貼り付けてください。

Create a Mindola lens for me. I'm a freelance UX designer with 10 years
of experience in fintech and healthcare. Interview me briefly to fill
the gaps, show me the profile, and only create it after I approve.

Read the README and docs folder of this repository, then create a
Mindola lens that answers questions about the project's docs.
Show me the proposed profile before creating anything.

Turn my CV into a Mindola lens that answers recruiters' questions.
Here is my CV: [paste CV]. Keep the tone professional and add a
boundary that it never discusses salary expectations.

Create a Mindola lens for my online course "Intro to Data Analysis".
It should act as a course assistant for students. I'll paste the
syllabus and lesson summaries next.

Add these three articles to my Mindola lens YOUR_LENS_TOKEN:
https://example.com/post-1
https://example.com/post-2
https://example.com/post-3

Check the status of my Mindola lens YOUR_LENS_TOKEN. Tell me how many
knowledge sources are ready, pending, or failed.

Create a Mindola lens for our startup's support. Use our FAQ page at
https://example.com/faq and the refund policy I paste below. Tone:
professional. Add suggested prompts about setup, billing, and refunds.

Create a Mindola lens in Dutch (locale nl) for my bakery. It should
answer questions about opening hours, allergens, and custom orders
from the text I provide.

役割と目標ごとに整理された 100 件のプロンプトは、docs/prompts.md にあります。業界別に見たい場合は、カスタマーサポートからオンラインコースまで、分野ごとに分類された 1 文のプロンプト 100 件を examples/100-prompts.md でご覧いただけます。

API の概要

REST 開発者 API v1 は https://app.mindola.ai で利用でき、Authorization: Bearer mnd_<key> で認証します。書き込みエンドポイントのレート制限は、キーごとに 1 分あたり 30 リクエストです。

エンドポイント	機能
POST /api/v1/lenses	レンズを作成します。テキストまたは URL のナレッジアイテムを最大 50 件、任意で初期登録できます
GET /api/v1/lenses	レンズを新しい順に最大 100 件取得します
GET /api/v1/lenses/:id	ナレッジ件数（合計、準備完了、保留中、失敗）を含むレンズを 1 件取得します
POST /api/v1/lenses/:id/knowledge	既存のレンズにナレッジアイテムを最大 50 件追加します

curl -s https://app.mindola.ai/api/v1/lenses \
  -H "Authorization: Bearer mnd_your_api_key_here"

フィールドごとの詳細なリファレンス、エラーコード、キー管理については docs/api.md をご覧ください。curl、Node、Python で実行できるサンプルは examples/ にあります。

MCP ツール

サーバーが公開するツールは、以下の3つだけです。

• create_digital_twin_lens：会話中にユーザーが承認したプロフィールからレンズを作成し、共有 URL と申請 URL を返します。
• add_lens_knowledge：トークンを使って、未申請のレンズに最大20件のテキストまたは URL を追加します。コンテンツは標準の取り込みパイプラインで処理され、レンズが引用付きで回答できるようになります。
• get_lens_status：読み取り専用です。共有 URL、レンズが申請済みかどうか、ナレッジ件数を返します。取り込みの進行状況を確認するのに便利です。

認証不要のプレーンな JSON-RPC で、サーバーのスモークテストを実行できます。

curl -s https://app.mindola.ai/mcp/lens \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

スキーマ、フィールドの上限、利用上のマナーについては、docs/mcp-tools.md をご覧ください。

アーキテクチャ

flowchart LR
    A[MCP client<br>Claude, Cursor, Codex, ChatGPT] -->|create_digital_twin_lens| B[Hosted Mindola MCP server<br>app.mindola.ai/mcp/lens]
    B --> C[Lens created<br>live and unclaimed]
    A -->|add_lens_knowledge| D[Ingestion<br>parse, chunk, embed]
    D --> C
    C --> E[Public lens page<br>mindola.ai/me/your-name]
    V[Visitor] -->|chat or live voice| E
    E -->|grounded answers with citations| V

このサーバーは Streamable HTTP（MCP プロトコルバージョン 2025-03-26、2025-06-18、2025-11-25）を使用し、ステートレスです。追加したナレッジは解析、チャンク分割、埋め込み処理を経て、訪問者が質問した際に検索を通じて提供されます。トランスポートの動作や未申請レンズのライフサイクルなど、詳細については docs/architecture.md をご覧ください。

よくある質問

無料で試せますか？ はい。MCP サーバーを通じたレンズの作成に料金はかからず、アカウントも不要です。Mindola は無料で利用を開始でき、より多く利用する方向けの有料プランもあります。

アカウントは必要ですか？ レンズの作成には必要ありません。匿名で作成すると、すぐに利用できる未申請のレンズが作成されます。申請する際に無料で登録できます。

未申請のレンズとは何ですか？ アカウントなしで作成されたレンズです。共有 URL からすぐに利用でき、申請 URL も付属します。30日以内に誰も申請しない場合、期限切れになります。申請されるまでは、アシスタントがレンズのトークンだけでナレッジを追加できます。

データはどこに保存されますか？ app.mindola.ai の背後にある Mindola のホスティングサービスに保存されます。レンズの回答はお客様の資料に基づいており、非公開の資料が引用に表示されることはありません。

レンズが幻覚を起こすことはありますか？ 回答はお客様の資料だけに基づきます。質問が資料の範囲外の場合、レンズは正直に回答を控え、推測する代わりに質問を受信箱へ転送できます。

自分の声を使えますか？ はい。レンズの所有者は、ライブ通話でクローン音声を使うか、既成の音声を選択できます。生成された音声にはすべて、AI 生成であることを示す機械可読マーカーが付与されます。

どの言語に対応していますか？ アプリの UI は10言語に対応しています：英語、オランダ語、ドイツ語、スペイン語、フランス語、アラビア語、日本語、韓国語、トルコ語、中国語です。レンズを作成する際、コピーの BCP-47 ロケールを設定できます。

カスタム GPT との違いは何ですか？ カスタム GPT は ChatGPT 内で動作するため、利用には ChatGPT が必要です。レンズは、誰でも通常のリンクから開ける公開ウェブページで、根拠となる引用、正直な回答拒否、ライブ音声、回答できなかった質問を受け付ける受信箱、オプションの Stripe 決済機能を備えています。他社のアプリ内のチャットではなく、皆様のナレッジへの入り口として開発しました。

その他の質問と詳しい回答については、docs/faq.md をご覧ください。

制限事項

現時点で対応していない機能を、正直に列挙します。

• API と MCP ツールが現在受け付けるナレッジ項目の種類は、text と url の2つです。PDF のアップロードや Q&A ペアなど、より多様なソースの種類は Mindola アプリで利用できます。
• ウェブフックにはまだ対応していません。取り込みの進行状況は get_lens_status または GET /api/v1/lenses/:id をポーリングして確認してください。
• API v1 にレンズ削除エンドポイントはありません。
• 公式 SDK パッケージはまだありません。サンプルではプレーンな curl、fetch、requests を使用しています。
• 未申請のレンズは、申請されないまま30日が経過すると期限切れになります。
• 匿名 MCP のレート制限：レンズ作成はセッションあたり1分間に2回、1時間に10回です。他の2つのツールは IP あたり1分間に20回です。REST 書き込みエンドポイントは、キーあたり1分間に30リクエストまでです。

API はまだ小規模で初期段階にあり、今後さらにエンドポイントを追加する予定です。

セキュリティ

• 設計上、MCP サーバーには認証がありません。 匿名での呼び出しで作成できるのは、所有者が未設定のレンズだけです。作成数はレート制限（1 分あたり 2 件、1 時間あたり 10 件）され、申請されない限り 30 日で期限切れになります。所有権は、レンズをサインイン済みアカウントに紐付ける申請の段階で確立されます。その後は、匿名コネクターから変更できなくなります。
• API キーは慎重に取り扱っています。 キーが表示されるのは作成時の 1 回だけです。保存されるのは SHA-256 ハッシュのみで、表示用に先頭 12 文字を保持します。また、失効はタイムスタンプで記録されるため、監査できます。
• 安全性を支えるグラウンディング。 回答にはオーナーの資料のみを使用し、非公開の資料が引用に含まれることはありません。
• EU AI Act への準拠。 レンズが生成する音声には、EU AI Act 第 50 条第 2 項に準拠した機械可読なマークが付与され、AI 生成であることを検出できます。
• 責任ある脆弱性開示。 脆弱性を見つけた場合は、[email protected] までメールでお知らせください。

ライセンス

このリポジトリのドキュメントとサンプルコードは MIT ライセンスです。ホスト型の Mindola サービス自体はクローズドソースです。

リンク

• プロダクト：mindola.ai
• ライブデモレンズ：mindola.ai/me/charles-darwin
• 機械可読なドキュメント：mindola.ai/llms.txt
• MCP レジストリエントリー：registry.modelcontextprotocol.io の ai.mindola/lens
• スターターテンプレート：mindola-persona-starter
• お問い合わせ：[email protected]