Biel.ai

Biel.ai は、技術ドキュメントをユーザー向けの回答や AI エージェント向けのコンテキストに変換し、情報源へのリンクも提示します。この MCP サーバーは、Claude Code、Codex、Cursor などの互換クライアントを、Biel.ai プロジェクトでインデックス化されたドキュメントに接続します。

通常のワークフローでは、関連するコンテンツを検索し、さらにコンテキストが必要な場合はインデックス化されたドキュメントを取得して、呼び出し元の AI アシスタントで回答します。明示的に依頼すれば、Biel.ai が回答を生成することもできます。情報源に基づいて回答しても、モデルの誤りをなくすことはできません。取得したコンテンツと参照先を確認してください。

Biel.ai アカウント、インデックス化された情報源、および対象プランで有効にしたホスト型 MCP が必要です。アカウントを作成し、MCP セットアップガイドに従ってください。

はじめに

1. MCP を有効にしてエンドポイントをコピーする

Biel.ai でプロジェクトを開き、Settings > MCP に移動して、MCP サーバーを有効にし、保存します。プロジェクト用に提供されたエンドポイント全体をコピーしてください。

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

クライアントごとの手順については、公式ドキュメントを参照してください。

• 技術ドキュメントを Claude Code に接続する。
• 技術ドキュメントを Codex に接続する。
• ChatGPT を接続するか、Claudeを接続します。
• Cursor と VS Code / Copilot の場合は、ウィジェットの Connect メニューまたは手動セットアップガイドを使用してください。

設定例では、Streamable HTTP をネイティブでサポートしていないクライアント用のブリッジとして mcp-remote を使用します。HTTP をネイティブでサポートしているクライアントは、それぞれの設定形式を使って直接接続してください。

3. 検索結果を確認する

クライアントが biel_search、biel_get_document、biel_ai を検出することを確認します。インデックス化されたドキュメントが答えを提供できる質問をしてください。

Use biel_search to find our API authentication instructions. Read relevant
results with biel_get_document and explain the required headers with source links.

取得したテキストと引用をドキュメントと照らし合わせて確認してください。MCP が提供するのはインデックス化されたコンテンツです。ドキュメントを変更した後は、Biel.ai で情報源を更新し、再度検索して最新のドキュメント ID を取得してください。

生成回答と検索を選択する

サーバーは 3 つのツールを提供します。

• biel_ai：会話のコンテキストを含めて、Biel.ai に回答を生成するよう依頼します。message を使う既存の呼び出しも、引き続き回答を生成します。
• biel_search：回答を生成せず、インデックス化されたウェブページ、アップロードされたファイル、リポジトリ、OpenAPI ソースをキーワード検索とセマンティック検索で検索します。
• biel_get_document：検索で返されたドキュメントのインデックス化されたテキスト全体を読み込みます。

自然言語の質問または検索語を指定して biel_search を呼び出します。

{"query": "How do I authenticate with the SDK?", "limit": 5}

検索では API の search_type=hybrid&source_types=all をリクエストします。REST API のデフォルトは search_type=keyword で、選択した情報源とは独立しています。結果にはチャンクのテキスト、情報源の種類、document_id、およびページ／シートの参照が含まれます。URL 以外のドキュメントは、タイトルと場所で引用されます。limit 引数は返されるチャンク数を制御します（デフォルトは 5、最大は 20）。

検索結果の document_id を biel_get_document に指定すると、情報源のサイトを開かずに、インデックス化されたドキュメント全体を読み込めます。

{"document_id": "DOCUMENT_ID_FROM_SEARCH", "limit": 20}

トラブルシューティング

公開プロジェクトでは API キーは必要ありません。非公開プロジェクトでは、検索による取得に search 権限、生成された回答の取得に chats_create 権限を持つ api_key クエリパラメーターが必要です。

許可されたドメインが設定されている場合は、domain クエリパラメーターが必要です。非公開プロジェクトやドメイン制限のあるプロジェクトに接続する前に、接続パラメーターを確認してください。キーを含む URL は認証情報として扱い、共有設定に含めないでください。

セルフホスト（任意）

独自の MCP サーバーインスタンスを実行したい上級ユーザー向けです。

ローカル開発

# Clone and run locally
git clone https://github.com/TechDocsStudio/biel-mcp
cd biel-mcp
pip install .
biel-mcp

Python パッケージとして使用

独自の ASGI スタックをホストするアプリケーションでは、タグ付きリビジョンからサーバーを直接インストールし、FastAPI アプリケーションをインポートできます。

pip install "biel-mcp @ git+https://github.com/TechDocsStudio/biel-mcp.git@VERSION"

from biel_mcp.server import app

Docker デプロイ

# Docker Compose (recommended)
docker-compose up -d --build

# Or Docker directly
docker build -t biel-mcp .
docker run -d -p 7832:7832 biel-mcp

サポート

• 課題: GitHub Issues
• お問い合わせ: [email protected]
• カスタムデモ: デモを予約する