English Français العربية

Biel.ai

السجل الرسمي الإنتاجية

Query your product docs from AI tools. Source-cited answers from your indexed documentation.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http biel-ai 'https://mcp.biel.ai/v2/{project_slug}/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "biel-ai": {
            "type": "http",
            "url": "https://mcp.biel.ai/v2/{project_slug}/mcp"
        }
    }
}
Remote (sse)
Claude Code 
claude mcp add --transport sse biel-ai 'https://mcp.biel.ai/sse?project_slug={project_slug}&domain={domain}'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "biel-ai": {
            "type": "sse",
            "url": "https://mcp.biel.ai/sse?project_slug={project_slug}&domain={domain}"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Biel.ai MCP Server
  2. Getting started
  3. Choose generated answers or search
  4. Troubleshooting
  5. Self-hosting (Optional)
  6. Support

Biel.ai MCP Server

Give AI assistants context from technical documentation

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:

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.

The server exposes three tools:

  • biel_ai: ask Biel.ai to generate an answer, with conversational context. Existing calls using message continue 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

الأسئلة الشائعة

ما هو Biel.ai؟

Query your product docs from AI tools. Source-cited answers from your indexed documentation.

كيف أثبّت Biel.ai؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http biel-ai 'https://mcp.biel.ai/v2/{project_slug}/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Biel.ai إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Biel.ai مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Biel.ai؟

ينشره TechDocsStudio. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.