Biel.ai MCP server
2026년 10월 23일 커밋AI 어시스턴트를 기술 문서와 연결하여 인덱싱된 웹 페이지, 파일, 리포지토리로부터 출처가 명시된 답변과 컨텍스트를 제공합니다.
다른 이름 TechDocsStudio/biel-mcp, biel-mcp
- 스타
- 5
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 2.0.0
- 마지막 커밋
- 2026년 10월 23일
- 라이선스
- MIT
Biel.ai MCP란?
AI 어시스턴트를 기술 문서와 연결하여 인덱싱된 웹 페이지, 파일, 리포지토리로부터 출처가 명시된 답변과 컨텍스트를 제공합니다.
프로젝트 README에서 생성된 요약
Biel.ai MCP server 정보
Biel.ai는 AI 어시스턴트를 기술 문서와 연결하여 출처가 명시된 답변을 제공하는 방법을 지원합니다. 웹 페이지, 파일, 리포지토리 및 OpenAPI 소스를 프로젝트로 인덱싱하여 작동합니다. 개발자는 Claude Code, Codex, Cursor, ChatGPT와 같은 클라이언트에서 이 MCP server를 사용하여 문서로부터 특정 컨텍스트를 가져올 수 있습니다.
이 서버는 세 가지 주요 도구를 통해 작동합니다. 키워드와 시맨틱 검색을 결합한 biel_search, 인덱싱된 전체 텍스트를 읽는 biel_get_document, 대화형 답변을 생성하는 biel_ai가 있습니다. 사용자는 Biel.ai 계정과 활성화된 MCP 엔드포인트가 있어야 합니다. 공개 프로젝트는 API 키 없이 접근할 수 있지만, 비공개 프로젝트는 검색 및 채팅 생성을 위한 특정 권한을 가진 api_key가 필요합니다.
설정하려면 Biel.ai 설정에서 프로젝트 엔드포인트를 복사하여 클라이언트를 구성해야 합니다. 네이티브 HTTP 지원이 없는 도구의 경우 mcp-remote를 브릿지로 사용할 수 있습니다. 이 시스템은 요청당 검색 결과 청크 수를 5개에서 20개 사이로 설정하는 등 세밀한 제어를 허용합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Biel.ai MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Biel.ai MCP 설치
$ claude mcp add --transport http biel-mcp https://mcp.biel.ai/v2/%7Bproject_slug%7D/mcpCursor에 Biel.ai MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"biel-mcp": {
"url": "https://mcp.biel.ai/v2/%7Bproject_slug%7D/mcp"
}
}
}VS Code에 Biel.ai MCP 설치
.vscode/mcp.json
{
"servers": {
"biel-mcp": {
"type": "http",
"url": "https://mcp.biel.ai/v2/%7Bproject_slug%7D/mcp"
}
}
}VS Code CLI에 Biel.ai MCP 설치
$ code --add-mcp '{"name":"biel-mcp","type":"http","url":"https://mcp.biel.ai/v2/%7Bproject_slug%7D/mcp"}'Codex에 Biel.ai MCP 설치
$ codex mcp add biel-mcp --url https://mcp.biel.ai/v2/%7Bproject_slug%7D/mcpCodex config.toml에 Biel.ai MCP 설치
~/.codex/config.toml
[mcp_servers.biel-mcp] url = "https://mcp.biel.ai/v2/%7Bproject_slug%7D/mcp"
Gemini CLI에 Biel.ai MCP 설치
$ gemini mcp add -s user --transport http biel-mcp https://mcp.biel.ai/v2/%7Bproject_slug%7D/mcpGemini settings.json에 Biel.ai MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"biel-mcp": {
"url": "https://mcp.biel.ai/v2/%7Bproject_slug%7D/mcp",
"type": "http"
}
}
}자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능techdocsstudio/biel-mcp is public and reachablegithub.com/techdocsstudio/biel-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-23github.com/techdocsstudio/biel-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답initialize answered with protocol 2025-11-25 in 859 ms통과
README
GitHub에서 보기Biel.ai turns technical documentation into answers for users and context for AI agents, with links back to the sources. This MCP server connects Claude Code, Codex, Cursor, and other compatible clients to documentation indexed in a Biel.ai project.
The usual workflow is to search for relevant content, retrieve indexed documents when more context is needed, and answer in the calling AI assistant. Biel.ai can also generate an answer when you explicitly request one. Source grounding does not eliminate model error; check the retrieved content and references.

Requires a Biel.ai account, indexed sources, and hosted MCP enabled on a plan that includes it. Create an account and follow the MCP setup guide.
Getting started
1. Enable MCP and copy your endpoint
Open your project in Biel.ai, go to Settings > MCP, enable the MCP server, and save. Copy the complete endpoint supplied for your project.
2. Connect your AI client
Use the canonical documentation for client-specific steps:
- Connect technical documentation to Claude Code.
- Connect technical documentation to Codex.
- Connect ChatGPT or Claude.
- For Cursor and VS Code / Copilot, use the widget's Connect menu or the manual setup guide.
The example configuration uses mcp-remote as a bridge for clients without native Streamable HTTP support. Clients with native HTTP support should connect directly using their own configuration format.
3. Verify retrieval
Confirm the client discovers biel_search, biel_get_document, and biel_ai. Ask a question your indexed documentation covers:
Use biel_search to find our API authentication instructions. Read relevant
results with biel_get_document and explain the required headers with source links.
Check the retrieved text and citations against the documentation. MCP serves indexed content; refresh sources in Biel.ai after documentation changes and search again for current document IDs.
Choose generated answers or search
The server exposes three tools:
biel_ai: ask Biel.ai to generate an answer, with conversational context. Existing calls usingmessagecontinue to generate answers.biel_search: hybrid keyword and semantic search over indexed web pages, uploaded files, repositories and OpenAPI sources, without answer generation.biel_get_document: read the complete indexed text of a document returned by search.
Call biel_search with a natural-language question or search terms:
{"query": "How do I authenticate with the SDK?", "limit": 5}
Search requests the API's search_type=hybrid&source_types=all. The REST API defaults to search_type=keyword, independently of the selected sources. Results include chunk text, source type, a document_id, and any page/sheet reference; non-URL documents are cited by title and location. The limit argument controls how many chunks are returned (default 5, maximum 20).
Use biel_get_document with a search result's document_id to read the complete indexed document without visiting its source site:
{"document_id": "DOCUMENT_ID_FROM_SEARCH", "limit": 20}
Troubleshooting
Public projects do not need an API key. Private projects require an api_key query parameter with search permission for retrieval and chats_create for generated answers.
A domain query parameter is needed when allowed domains are configured. See connection parameters before connecting a private or domain-restricted project. Treat a URL containing a key as a credential and keep it out of shared configuration.
Self-hosting (Optional)
For advanced users who prefer to run their own MCP server instance:
Local development
# Clone and run locally
git clone https://github.com/TechDocsStudio/biel-mcp
cd biel-mcp
pip install .
biel-mcp
Use as a Python package
Applications that host their own ASGI stack can install the server directly from a tagged revision and import its FastAPI application:
pip install "biel-mcp @ git+https://github.com/TechDocsStudio/biel-mcp.git@VERSION"
from biel_mcp.server import app
Docker deployment
# Docker Compose (recommended)
docker-compose up -d --build
# Or Docker directly
docker build -t biel-mcp .
docker run -d -p 7832:7832 biel-mcp
Support
- Issues: GitHub Issues
- Contact: support@biel.ai
- Custom Demo: Book a demo
Biel.ai MCP 질문
Biel.ai MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http biel-mcp https://mcp.biel.ai/v2/%7Bproject_slug%7D/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Biel.ai MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
서버를 사용하려면 API 키가 필요한가요?
공개 프로젝트는 API 키가 필요하지 않지만, 비공개 프로젝트는 검색 및 답변 생성을 위한 특정 권한이 포함된 api_key 쿼리 파라미터가 필요합니다.