Biel.ai MCP Server

1<div align="center">
2  <picture>
3    <source media="(prefers-color-scheme: dark)" srcset="./logo-dark..jpg" />
4    <img alt="Biel.ai" src="./logo.jpg" />
5  </picture>
6  <h1>Biel.ai MCP Server</h1>
7  <h3>Connect your IDE to your product docs</h3>
8</div>
9 
10 
11Give AI tools like Cursor, VS Code, and Claude Desktop access to your company's product knowledge through the [Biel.ai platform](https://biel.ai).
12 
13Biel.ai provides a hosted Retrieval-Augmented Generation (RAG) layer that makes your documentation searchable and useful to AI tools. This enables smarter completions, accurate technical answers, and context-aware suggestions—directly in your IDE or chat environment.
14 
15![Demo](./demo.png)
16 
17When AI tools can read your product documentation, they become **significantly** more helpful—generating more accurate code completions, answering technical questions with context, and guiding developers with real-time product knowledge.
18 
19 
20> **Note:** Requires a Biel.ai account and project setup. **[Start your free 15-day trial](https://app.biel.ai/accounts/signup/)**.
21 
22<h3><a href="https://docs.biel.ai/integrations/mcp-server?utm_source=github&utm_medium=referral&utm_campaign=readme">See quickstart instructions →</a></h3>
23 
24## Getting started
25 
26### 1. Get your MCP configuration
27 
28```json
29{
30  "mcpServers": {
31    "biel-ai": {
32      "description": "Query your product's documentation, APIs, and knowledge base.",
33      "command": "npx",
34      "args": [
35        "mcp-remote",
36        "https://mcp.biel.ai/sse?project_slug=YOUR_PROJECT_SLUG&domain=https://your-docs-domain.com"
37      ]
38    }
39  }
40}
41```
42 
43**Required:** `project_slug` and `domain`  
44**Optional:** `api_key` (only needed for private projects)
45 
46### 2. Add to your AI tool
47 
48* **Cursor**: **Settings** → **Tools & Integrations* → **New MCP server**.
49* **Claude Desktop**: Edit `claude_desktop_config.json`  
50* **VS Code**: Install **MCP extension**.
51 
52### 3. Start asking questions
53 
54```
55Can you check in biel_ai what the auth headers are for the /users endpoint?
56```
57 
58## Self-hosting (Optional)
59 
60For advanced users who prefer to run their own MCP server instance:
61 
62### Local development
63```bash
64# Clone and run locally
65git clone https://github.com/techdocsStudio/biel-mcp
66cd biel-mcp
67pip install -r requirements.txt
68python biel_mcp_server.py
69```
70 
71### Docker deployment
72```bash
73# Docker Compose (recommended)
74docker-compose up -d --build
75 
76# Or Docker directly
77docker build -t biel-mcp .
78docker run -d -p 7832:7832 biel-mcp
79```
80 
81## Support
82 
83- **Issues**: [GitHub Issues](https://github.com/techdocsStudio/biel-mcp/issues)
84- **Contact**: [support@biel.ai](mailto:support@biel.ai)
85- **Custom Demo**: [Book a demo](https://biel.ai/contact)
86