convez.ai
MCP ServerIntegração & APIsIntermediário
mdemyanov

Gramax DocPortal MCP

mdemyanov/gramax-docportal-mcp

Acesse portais Gramax diretamente do Claude com busca e navegação inteligente

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor 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-mcp

1 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

Estrelas
2
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 mês
Versão
v0.3.4
Issues abertas
0
Contribuidores
1

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_URLURL портала документацииДа
GRAMAX_API_TOKENAPI-токен (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

Ver o original no GitHub

Bom para

Relacionados