# Biel.ai

Biel.ai — MCP-сервер для Claude Code, который ищет ответы в индексированной документации и возвращает ссылки на источники. Подключается к проекту Biel.ai.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 у репозитория
- Автор: TechDocsStudio
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/TechDocsStudio/biel-mcp
- Обновлён: 2026-11-16
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/bielai

## Что делает

Biel.ai подключает AI-агента к документации, собранной в проекте Biel.ai. Сервер ищет нужные фрагменты, открывает полный текст найденного документа и может сформировать ответ с учётом контекста диалога. Вызовы выполняются через инструменты `biel_search`, `biel_get_document` и `biel_ai`.

Для работы нужен аккаунт Biel.ai, индексированные источники и включённый hosted MCP в тарифе, где эта функция доступна. Закрытым проектам нужен API-ключ с правом `search` для поиска и `chats_create` для генерации ответов. После изменений документации источники нужно обновить в Biel.ai, иначе поиск продолжит использовать прежний индекс.

Сервер можно развернуть самостоятельно на Python 3.10 или новее через официальный Python MCP SDK 2.3. При самостоятельном запуске состояние по умолчанию хранится в памяти, поэтому перезапуск удаляет сохранённые диалоги.

## Требования
- Удалённый сервер: `https://mcp.biel.ai/v2/{project_slug}/mcp`

## Установка

### Claude Code (родная платформа)

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http biel-ai https://mcp.biel.ai/v2/{project_slug}/mcp
```

### Codex

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Командой платформы: удалённый сервер**
```bash
codex mcp add bielai --url https://mcp.biel.ai/v2/{project_slug}/mcp
```

### Cursor

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "bielai": {
            "url": "https://mcp.biel.ai/v2/{project_slug}/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "bielai": {
            "type": "http",
            "url": "https://mcp.biel.ai/v2/{project_slug}/mcp"
        }
    }
}
```

### Gemini CLI

1. **Адрес-шаблон**
- Адрес сервера — шаблон: подставьте свои значения вместо {…} или […]

2. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http bielai https://mcp.biel.ai/v2/{project_slug}/mcp
```

## Когда брать
- найти инструкции по API в индексированной документации
- прочитать полный текст документа по его `document_id`
- сформировать ответ со ссылками на источники
- продолжить диалог через `conversation_id`

## Примеры запросов агенту
- Найди через `biel_search` инструкции по аутентификации API и объясни обязательные заголовки.
- Открой полный документ через `biel_get_document` по найденному `document_id` и перескажи его требования.
- Сформируй через `biel_ai` ответ о ротации учётных данных, продолжив предыдущий диалог.

## Похожие
- [context7-mcp](https://affpapa.org/nevibecode/skills/context7-mcp.md) — скилл · 7200 установок
- [stripe-docs](https://affpapa.org/nevibecode/skills/stripe-stripe-docs.md) — скилл · 2900 установок
- [twitterapi-io-mcp](https://affpapa.org/nevibecode/mcp/twitterapi-io-mcp.md) — MCP-сервер · ★ 10 у репозитория
- [convex-docs](https://affpapa.org/nevibecode/skills/convex-docs.md) — скилл · 44100 установок
- [documenting-contracts](https://affpapa.org/nevibecode/skills/documenting-contracts.md) — скилл · 26300 установок
- [reef](https://affpapa.org/nevibecode/plugins/reef.md) — плагин · ★ 6 у репозитория

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
