Biel.ai

Biel.ai 将技术文档转化为用户可用的答案和 AI Agent 所需的上下文，并附上指向来源的链接。此 MCP 服务可将 Claude Code、Codex、Cursor 及其他兼容客户端连接到 Biel.ai 项目中已编入索引的文档。

通常的工作流是先搜索相关内容，在需要更多上下文时检索已编入索引的文档，然后由发起调用的 AI 助手作答。你也可以明确要求 Biel.ai 生成答案。基于来源的回答无法消除模型错误；请核对检索到的内容和引用。

需要 Biel.ai 账户、已编入索引的来源，以及包含托管 MCP 的套餐并启用该功能。创建账户，并按照 MCP 设置指南操作。

开始使用

1. 启用 MCP 并复制端点

在 Biel.ai 中打开你的项目，前往 设置 > MCP，启用 MCP 服务并保存。复制为你的项目提供的完整端点。

2. 连接 AI 客户端

请参阅规范文档，了解特定客户端的操作步骤：

• 将技术文档连接到 Claude Code。
• 将技术文档连接到 Codex。
• 连接 ChatGPT 或 Claude。
• 对于 Cursor 和 VS Code / Copilot，请使用小组件的 连接 菜单或手动设置指南。

示例配置使用 mcp-remote 作为桥接，以支持不具备原生 Streamable HTTP 支持的客户端。具备原生 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。

选择生成答案或搜索

此服务提供三个工具：

• 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 密钥。私有项目需要在查询参数中提供 api_key，并授予 search 权限以进行检索，以及 chats_create 权限以生成回答。

配置了允许的域名时，需要提供 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 问题
• 联系：[email protected]
• 定制演示：预约演示