Stuga — MCP-сервер для Claude Code: что делает и как установить
Связывает ассистента с локальной базой знаний команды, где все правки нейросети по умолчанию ждут подтверждения человеком перед публикацией.
claude mcp add --env STUGA_URL=<STUGA_URL> --transport stdio stuga -- npx -y @stuga/mcpЧто делает Stuga
Инструмент подключает ИИ-агентов к вашей self-hosted вики через протокол MCP. Модель может сама распределять заметки со встреч по нужным разделам, заполнять строки в таблицах и отвечать на вопросы команды по утверждённым материалам.
Внутри связки работают три режима контроля: подтверждение автором запроса, проверка коллегой или прямое применение правок. Агенту закрыты системные действия: он не может удалять страницы или менять права доступа.
Для запуска сервера требуется развёрнутый узел Stuga на macOS 15+ с чипом Apple silicon либо в Docker с Postgres. Без рабочего инстанса MCP-клиент работать не сможет.
Какие задачи решает
- вести командную базу знаний силами ИИ с обязательной модерацией правок
- искать ответы по внутренним страницам и таблицам с учётом прав доступа
- находить устаревшие разделы и битые ссылки в документации
- автоматически разносить факты из встреч по статьям и базам данных
Примеры запросов агенту
- Сохрани выжимку встречи в Stuga и обнови связанные разделы
- Спроси у Stuga, какой регламент действует для возвратов
- Проверь Stuga на битые ссылки и покажи предложенные правки
Как установить Stuga
1Командой платформы
claude mcp add --env STUGA_URL=<STUGA_URL> --transport stdio stuga -- npx -y @stuga/mcpВместо <…> подставьте свои значения
2Командой платформы: удалённый сервер
claude mcp add --transport http stuga https://{stuga_host}/mcp1Командой платформы
codex mcp add stuga --env STUGA_URL=<STUGA_URL> -- npx -y @stuga/mcpВместо <…> подставьте свои значения
2Командой платформы: удалённый сервер
codex mcp add stuga --url https://{stuga_host}/mcp1Файл настроек
{
"mcpServers": {
"stuga": {
"command": "npx",
"args": [
"-y",
"@stuga/mcp"
],
"env": {
"STUGA_URL": "<STUGA_URL>"
}
}
}
}Вместо <…> подставьте свои значения
2Файл настроек
{
"mcpServers": {
"stuga": {
"url": "https://{stuga_host}/mcp"
}
}
}1Файл настроек
{
"servers": {
"stuga": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@stuga/mcp"
],
"env": {
"STUGA_URL": "<STUGA_URL>"
}
}
}
}Вместо <…> подставьте свои значения
2Файл настроек
{
"servers": {
"stuga": {
"type": "http",
"url": "https://{stuga_host}/mcp"
}
}
}1Командой платформы
gemini mcp add -e STUGA_URL=<STUGA_URL> stuga npx -y @stuga/mcpВместо <…> подставьте свои значения
2Командой платформы: удалённый сервер
gemini mcp add -t http stuga https://{stuga_host}/mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Stuga
Как установить Stuga в Claude Code?
Выполните команду claude mcp add --env STUGA_URL=<STUGA_URL> --transport stdio stuga -- npx -y @stuga/mcp, указав адрес вашего узла Stuga вместо <STUGA_URL>.
Что делает Stuga?
Сервер даёт агенту доступ к корпоративной вики для чтения и создания черновиков. Каждое изменение попадает на карточку проверки перед тем, как попасть в документ.
Может ли агент случайно удалить страницу или изменить настройки доступа?
Нет, агенты ограничены только редактированием контента страниц и строк таблиц. Перемещение, удаление, переименование и настройки доступа остаются под контролем людей.
