Biel.ai MCP sunucusu
Commit 23 Eki 2026Yapay zeka asistanlarını teknik dokümantasyona bağlayarak indekslenmiş web sayfaları, dosyalar ve depolardan kaynak göstererek yanıtlar ve bağlam sağlar.
Ayrıca bilinen adı TechDocsStudio/biel-mcp, biel-mcp
- Yıldızlar
- 5
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 2.0.0
- Son commit
- 23 Eki 2026
- Lisans
- MIT
Biel.ai MCP nedir?
Yapay zeka asistanlarını teknik dokümantasyona bağlayarak indekslenmiş web sayfaları, dosyalar ve depolardan kaynak göstererek yanıtlar ve bağlam sağlar.
Özet, projenin README dosyasından oluşturuldu
Biel.ai MCP sunucusu hakkında
Biel.ai, kaynak göstererek yanıtlar sunmak amacıyla yapay zeka asistanlarını teknik dokümantasyona bağlamanın bir yolunu sağlar. Web sayfalarını, dosyaları, depoları ve OpenAPI kaynaklarını bir projeye indeksleyerek çalışır. Geliştiriciler, dokümantasyonlarından belirli bağlamları çekmek için bu sunucuyu Claude Code, Codex, Cursor ve ChatGPT gibi istemcilerle birlikte kullanabilirler.
Sunucu üç ana araç üzerinden çalışır: hibrit anahtar kelime ve semantik arama için biel_search, indekslenmiş tam metni okumak için biel_get_document ve sohbet tabanlı yanıtlar oluşturmak için biel_ai. Kullanıcıların bir Biel.ai hesabına ve etkinleştirilmiş bir MCP uç noktasına sahip olmaları gerekir. Açık projelere API anahtarı olmadan erişilebilirken, özel projeler arama ve sohbet oluşturma için belirli izinlere sahip bir api_key gerektirir.
Kurulum, Biel.ai ayarlarından bir proje uç noktasının kopyalanmasını ve istemcinin yapılandırılmasını içerir. Yerel HTTP desteği olmayan araçlar için mcp-remote bir köprü görevi görebilir. Sistem, istek başına arama sonuçlarını 5 ile 20 parça arasında sınırlamak gibi hassas kontroller yapılmasına olanak tanır.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Biel.ai MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleBiel.ai MCP'yi Claude Code içine yükleyin
$ claude mcp add --transport http biel-mcp https://mcp.biel.ai/v2/%7Bproject_slug%7D/mcpBiel.ai MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"biel-mcp": {
"url": "https://mcp.biel.ai/v2/%7Bproject_slug%7D/mcp"
}
}
}Biel.ai MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"biel-mcp": {
"type": "http",
"url": "https://mcp.biel.ai/v2/%7Bproject_slug%7D/mcp"
}
}
}Biel.ai MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"biel-mcp","type":"http","url":"https://mcp.biel.ai/v2/%7Bproject_slug%7D/mcp"}'Biel.ai MCP'yi Codex içine yükleyin
$ codex mcp add biel-mcp --url https://mcp.biel.ai/v2/%7Bproject_slug%7D/mcpBiel.ai MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.biel-mcp] url = "https://mcp.biel.ai/v2/%7Bproject_slug%7D/mcp"
Biel.ai MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user --transport http biel-mcp https://mcp.biel.ai/v2/%7Bproject_slug%7D/mcpBiel.ai MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"biel-mcp": {
"url": "https://mcp.biel.ai/v2/%7Bproject_slug%7D/mcp",
"type": "http"
}
}
}Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirtechdocsstudio/biel-mcp is public and reachablegithub.com/techdocsstudio/biel-mcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-10-23github.com/techdocsstudio/biel-mcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorinitialize answered with protocol 2025-11-25 in 859 msGeçti
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 soruları
Biel.ai MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --transport http biel-mcp https://mcp.biel.ai/v2/%7Bproject_slug%7D/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Biel.ai MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Sunucuyu kullanmak için bir API anahtarına ihtiyacım var mı?
Açık projeler için API anahtarı gerekmez, ancak özel projeler veri çekme ve yanıt oluşturma işlemleri için belirli izinlere sahip bir api_key sorgu parametresi gerektirir.