MCP-сервер Steppo: как подключить базу знаний к Claude Code и Cursor

Если инструкции и регламенты уже хранятся в Steppo, их можно открыть ИИ-клиенту через MCP. Сотрудник задаёт вопрос в Claude Code или другом совместимом приложении, а клиент запрашивает нужный документ у Steppo с правами этого сотрудника. Ниже — порядок подключения и проверки. Сервер Steppo читает документы из Steppo; сам по себе он не подключает файлы из Notion, Confluence или Google Docs.

Что даёт подключение

Модель может искать инструкции, читать разделы документа, получать структуру папок и историю изменений. Это полезно, когда вопрос касается внутреннего процесса: «Как мы согласуем публикацию?» или «Какая инструкция по настройке доступа действует сейчас?». Для общего объяснения стандарта MCP есть отдельная статья; здесь сосредоточимся на настройке Steppo.

Перед подключением: три проверки

1. Есть содержимое. Подготовьте хотя бы один документ с понятным названием и конкретными шагами. Если база пустая или в ней противоречивые версии, подключение не исправит ответы.

2. Понятны права. Выберите команду, документы которой нужны в ИИ-клиенте. MCP использует права вошедшего пользователя: читателю доступны только опубликованные материалы, а закрытые документы остаются закрытыми.

3. Есть контрольный вопрос. Запишите вопрос, ответ на который содержится только в вашем документе. Так вы отличите ответ из базы от догадки модели.

Подключение Claude Code

В терминале выполните команду:

claude mcp add --transport http steppo https://steppo.ru/api/mcp

При первом обращении Claude Code откроет авторизацию Steppo. Войдите в аккаунт, выберите команду и разрешите подключение. Токен не нужно вручную копировать в промпт. Адрес сервера для удалённых MCP-клиентов — https://steppo.ru/api/mcp.

В Cursor или другом приложении добавьте удалённый MCP-сервер с этим URL, если клиент поддерживает Streamable HTTP и OAuth. Названия пунктов меню зависят от версии приложения. После подключения клиент должен показать инструменты Steppo, например поиск и чтение документов.

Как проверить, что ИИ использует вашу базу

1. Спросите: «Найди инструкцию по [название процесса] в Steppo и дай ссылку на документ».

2. Попросите перечислить шаги и указать, из какого раздела они взяты.

3. Откройте исходный документ и сравните ответ с актуальной версией. Если сведений в документе нет, попросите ассистента прямо сказать об этом.

Не оценивайте подключение по одной красивой формулировке. Важно, нашёл ли клиент именно ваш документ и можно ли проверить вывод по источнику.

Если документ не находится

• Проверьте, что вошли в нужную команду и имеете доступ к документу в интерфейсе Steppo.

• Убедитесь, что документ опубликован, если подключаетесь с ролью читателя.

• Начните с точного названия документа, затем попробуйте запрос по теме.

• Если инструменты Steppo не появились в клиенте, проверьте URL сервера и поддержку удалённого MCP с OAuth.

Как управлять доступом

Сервер Steppo сейчас работает только на чтение: ИИ-клиент не получает через MCP инструментов изменения или удаления документов. При этом текст доступного документа передаётся вашему ИИ-клиенту для ответа; политику обработки данных самого клиента стоит проверить отдельно. Список активных подключений и отзыв доступа находятся в меню профиля Steppo, в разделе «Интеграции».

Для первого теста достаточно одной инструкции и одного контрольного вопроса. Когда результат можно сверить с источником, расширяйте набор документов постепенно и назначьте владельца их актуальности.