Koma Core MCP — MCP-сервер для Claude Code
MCP-сервер подключает защищённое RAG-хранилище: агент ищет публичные метаданные, а полный текст получает только с подходящим уровнем доступа.
claude mcp add koma-core-mcp -e KOMA_MASTER_KEY=<KOMA_MASTER_KEY> -- npx -y koma-core-mcpЧто делает Koma Core MCP
Koma Core MCP даёт агенту два инструмента. search_docs ищет документы по категории и тегу и возвращает метаданные, включая displayName, accessTier и preview, но не сам текст. retrieve_doc получает содержимое по sourceId, который вернул поиск.
Доступ проверяется по userTier: доступны уровни public, premium и enterprise. При старте сервер загружает три демонстрационных документа. Хранилище работает в памяти, поэтому данные не сохраняются между запусками.
Для production понадобится реальная база через интерфейс DatabaseAdapter и настоящий мастер-ключ. Переменную KOMA_MASTER_KEY можно передать при запуске; без неё используется демонстрационный ключ, что ограничивает сервер учебным сценарием.
Какие задачи решает
- искать документы по категории и тегу
- получать метаданные без выдачи текста
- запрашивать документ по
sourceId - проверять доступ по уровню пользователя
Примеры запросов агенту
- Найди документы с тегом
apiчерезsearch_docsи покажи их метаданные. - Получи документ
api-referenceчерезretrieve_docс уровнемpremium. - Проверь, доступен ли
internal-architectureпользователю уровняpublic.
Как установить Koma Core MCP
Командой платформы
claude mcp add koma-core-mcp -e KOMA_MASTER_KEY=<KOMA_MASTER_KEY> -- npx -y koma-core-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add koma-core-mcp --env KOMA_MASTER_KEY=<KOMA_MASTER_KEY> -- npx -y koma-core-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"koma-core-mcp": {
"command": "npx",
"args": [
"-y",
"koma-core-mcp"
],
"env": {
"KOMA_MASTER_KEY": "<KOMA_MASTER_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"koma-core-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"koma-core-mcp"
],
"env": {
"KOMA_MASTER_KEY": "<KOMA_MASTER_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e KOMA_MASTER_KEY=<KOMA_MASTER_KEY> koma-core-mcp npx -y koma-core-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Koma Core MCP
Как установить Koma Core MCP в Claude Code?
Выполните claude mcp add koma-core-mcp -e KOMA_MASTER_KEY=<KOMA_MASTER_KEY> -- npx -y koma-core-mcp.
Что делает Koma Core MCP?
Он подключает защищённое RAG-хранилище к агенту через MCP. Поиск выдаёт метаданные, а полный текст возвращается после проверки уровня доступа.
Как Koma Core MCP ограничивает доступ к документам?
retrieve_doc сравнивает userTier с уровнем документа. Например, internal-architecture требует уровня enterprise, а guide-getting-started доступен на уровне public.
