Gramax DocPortal MCP
mdemyanov/gramax-docportal-mcp
Acesse portais Gramax diretamente do Claude com busca e navegação inteligente
Ver no GitHubServidor MCP que integra portais de documentação Gramax com Claude, permitindo busca semântica, leitura de artigos e navegação por catálogos. Suporta filtros avançados por propriedades, idioma e tipos de conteúdo, funcionando tanto em portais públicos quanto autenticados.
Instalação
npx convez-ai mdemyanov/gramax-docportal-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Pesquisar documentação técnica integrada ao Claude para respostas contextializadas
- Navegar catálogos de conhecimento corporativo sem sair da conversa
- Filtrar artigos por propriedades, idioma ou tipo de recurso para buscas precisas
Veredito

MCP bem estruturado para portais Gramax com suporte robusto a autenticação e filtros avançados. Integração direta, configuração clara, ideal para empresas que usam Gramax como base de conhecimento corporativo.
README
A tradução para o português deste README ainda está na fila.
gramax-docportal-mcp
MCP-сервер для доступа к порталу документации Gramax. Позволяет искать статьи, получать контент и навигацию через Claude и другие LLM.
Инструменты
| Инструмент | Описание |
|---|---|
gramax_list_catalogs | Список всех каталогов документации |
gramax_get_navigation | Дерево навигации каталога |
gramax_search | Поиск по статьям (фильтры по свойствам, языку, семантический поиск) |
gramax_get_article | Содержимое статьи в Markdown |
Установка
uv tool install gramax-docportal-mcp
Настройка
Добавьте в .mcp.json:
{
"mcpServers": {
"gramax": {
"command": "uvx",
"args": ["gramax-docportal-mcp"],
"env": {
"GRAMAX_BASE_URL": "https://your-portal.example.com",
"GRAMAX_API_TOKEN": "ваш-api-токен"
}
}
}
}
Публичные порталы (без токена)
Если портал публичный (не требует авторизации), GRAMAX_API_TOKEN можно не задавать — сервер работает в анонимном режиме:
{
"mcpServers": {
"gramax": {
"command": "uvx",
"args": ["gramax-docportal-mcp"],
"env": {
"GRAMAX_BASE_URL": "https://your-portal.example.com"
}
}
}
}
Получение токена
Если портал защищён, откройте в браузере (будучи залогиненным на портале):
https://your-portal.example.com/api/user/token
Токен действует 30 дней. Для кастомного срока:
https://your-portal.example.com/api/user/token?expiresAt=2026-12-31
Без токена или с истёкшим токеном сервер получит 401 при первом запросе и вернёт русскоязычное сообщение об ошибке.
Переменные окружения
| Переменная | Описание | Обязательно |
|---|---|---|
GRAMAX_BASE_URL | URL портала документации | Да |
GRAMAX_API_TOKEN | API-токен (Bearer); не нужен для публичных порталов | Нет |
Расширенный поиск
gramax_search поддерживает дополнительные параметры для точной фильтрации:
| Параметр | Описание |
|---|---|
catalog_name | Ограничить поиск одним каталогом |
search_type | "vector" — семантический поиск (по умолчанию — полнотекстовый) |
language | Язык статей: "ru", "en", "de", "zh" и др. |
resource_filter | "without" — только статьи, "only" — только файлы |
property_filter | Фильтр по свойствам статей (Продукт, Сегмент, Отрасль и др.) |
Примеры property_filter
{"op": "eq", "key": "Продукт", "value": "NSD"}
{"op": "contains", "key": "Сегмент", "list": ["Enterprise", "SMB"]}
{"op": "and", "filters": [
{"op": "eq", "key": "Тип контента", "value": "Кейс"},
{"op": "eq", "key": "Отрасль", "value": "Логистика"}
]}
В результатах поиска отображаются метаданные статей (🏷️) и рекомендованные результаты (⭐).
Лицензия
MIT