forked from boos/BoosAPI
boos
e0a5f57793
Vendor the rebranded BoosAPI Desktop client (Tauri + Vue) into metapi as a monorepo subdirectory under desktop/. Source only — node_modules, dist, Cargo target and the upstream .git history are excluded. desktop/ keeps its own independent Cargo workspace (desktop/src-tauri with crates/*); it is not part of the backend boosapi crate, so a `cargo check` at the metapi root still compiles only the backend. Build the desktop app from desktop/src-tauri per desktop/README.md. Note: app icons are still placeholder assets pending the final BoosAPI logo. The updater signing keys live outside the repo and are not included.
65 lines
3.1 KiB
Markdown
65 lines
3.1 KiB
Markdown
# MCP-серверы
|
||
|
||
## Что такое MCP?
|
||
|
||
[Model Context Protocol (MCP)](https://modelcontextprotocol.io/) — открытый стандарт, позволяющий ИИ-моделям взаимодействовать с внешними инструментами и источниками данных. BoosApi выступает как MCP-клиент — вы добавляете MCP-серверы, и ИИ может вызывать предоставляемые ими инструменты во время разговора.
|
||
|
||
---
|
||
|
||
## Транспортные протоколы
|
||
|
||
BoosApi поддерживает три транспортных протокола для связи с MCP-серверами:
|
||
|
||
| Протокол | Соединение | Сценарий использования | Конфигурация |
|
||
|---------|-----------|----------------------|-------------|
|
||
| **Stdio** | Локальный процесс | Инструменты на вашей машине, запускаемые через `npx`, `uvx`, `python` и т.д. | `command` + `args` + опциональный `env` |
|
||
| **SSE** | Удалённый сервер | Server-Sent Events endpoint на удалённой машине | `url` |
|
||
| **StreamableHTTP** | Удалённый сервер | HTTP-потоковый endpoint, более новая альтернатива SSE | `url` |
|
||
|
||
---
|
||
|
||
## Добавление MCP-серверов
|
||
|
||
### Создание через форму
|
||
|
||
1. Перейдите в **Настройки → MCP-серверы**.
|
||
2. Нажмите **Добавить MCP-сервер**.
|
||
3. Введите имя и выберите транспортный протокол.
|
||
4. Заполните поля для выбранного протокола.
|
||
5. Нажмите **Сохранить**.
|
||
|
||
### Импорт JSON
|
||
|
||
Нажмите **Импорт JSON** и вставьте объект конфигурации:
|
||
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"fetch": {
|
||
"command": "uvx",
|
||
"args": ["mcp-server-fetch"]
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## Встроенные инструменты
|
||
|
||
| Инструмент | Описание |
|
||
|-----------|---------|
|
||
| **@boosapi/fetch** | Загрузка веб-страниц и HTTP-ресурсов |
|
||
| **@boosapi/search-file** | Поиск файлов в локальной файловой системе |
|
||
|
||
---
|
||
|
||
## Лимит циклов инструментов
|
||
|
||
В Settings -> MCP можно настроить максимальное число последовательных tool-call iterations для MCP-enabled response. Уменьшайте лимит при тестировании неизвестных серверов или увеличивайте его для workflow, где несколько tools должны выполняться цепочкой.
|
||
|
||
## Следующие шаги
|
||
|
||
- [API-шлюз](./gateway) — предоставление провайдеров как локального API-сервера
|
||
- [Быстрый старт](./getting-started) — вернуться к руководству по быстрому старту
|