Публичный хаб кураторских баз

Хаб — это публичный каталог баз знаний, доступных через единый MCP-эндпоинт. AI-агент подключается к вашему инстансу один раз и получает доступ к вашим заметкам и каждой федеративной базе — без отдельной настройки на каждую базу, без дополнительных ключей.

Представьте это как курируемый справочник: в нём — философский архив, технический журнал, каталог навыков агентов, индекс Telegram-каналов. Агент выбирает нужную базу (или делает веерный поиск по всем) в зависимости от запроса.

Что такое хаб

Хаб находится по адресу /_system/mcp на инстансе trip2g. Он предоставляет шесть MCP-инструментов: search, similar, note_html для локальных заметок и federated_search, federated_similar, federated_note_html для удалённых баз. Агент, подключённый к эндпоинту хаба, обращается ко всему через эти шесть методов.

Публичная страница хаба по адресу /hub со списком подключённых баз знаний

Базы, перечисленные в разделе hub/, — реальные работающие базы знаний, к которым хаб может маршрутизировать запросы. Каждая запись в индексе хаба — это KB-заметка: обычная заметка Obsidian, в frontmatter которой указан mcp_federation_kb_url. Это одно поле регистрирует удалённую базу и делает её доступной через federated_search.

Как агент работает с хабом

Укажите MCP-клиенту (Claude Desktop, Claude Code, Cursor или любому MCP-совместимому инструменту) адрес:

https://trip2g.com/_system/mcp

Задавайте вопросы в обычном режиме. Агент сначала выполняет локальный search. Если результат поиска — KB-заметка (запись в хабе), ответ содержит маркер kind: "federation_kb" и инструкцию вызвать federated_search с kb_id этой базы. Дальше агент напрямую обращается к удалённой базе, не загружая всё заранее.

Чтобы обратиться к конкретной базе:

federated_search(query: "code review TypeScript", kb_id: "foragent")

Чтобы сделать веерный поиск по всем доступным базам:

federated_search(query: "Марк Аврелий о принятии решений")

Результаты от всех доступных баз объединяются и возвращаются вместе.

Как база попадает в хаб

База появляется в хабе, когда вы добавляете KB-заметку в хранилище и выполняете синхронизацию. Заметке нужно одно поле во frontmatter:

---
title: "Философский архив"
free: true
mcp_federation_kb_url: https://philosophers.example.com/_system/mcp
mcp_federation_kb_id: philosophy
---
Использовать для: поиска философских отсылок к инженерным решениям.
Не использовать для: срочных задач и узкоспециализированных тем.

mcp_federation_kb_url регистрирует удалённую базу. mcp_federation_kb_id задаёт короткий slug для точечных запросов — если не указан, slug по умолчанию равен hostname URL. Тело заметки — свободный текст; агент читает его, выбирая нужную базу, поэтому описывайте содержимое чётко.

free: true делает запись видимой для анонимных MCP-агентов. Без этого поля маршрутизация через эту базу доступна только аутентифицированным подписчикам и администраторам.

Публичные базы и приватные пиры

Публичные базы — аутентификация не нужна. Хаб проксирует вызовы анонимно. Добавьте KB-заметку, нажмите Sync — база доступна.

Приватные пиры — требуют общего HMAC-секрета. Вы и партнёр генерируете секрет для другой стороны и вставляете его в Администрирование → Federation. Пока секрет не установлен, вызовы к этой базе не возвращают результатов. Полная инструкция — в ru/user/federation.

База foragent в текущем хабе — пример приватного пира: у неё нет публичного доступа, и хаб хранит ключ у себя.

Записи хаба — это обычные страницы

Каждая KB-заметка — обычная заметка, поэтому она отображается как страница на вашем сайте. Читатели могут просматривать хаб по адресу /hub так же, как любой другой раздел. Тело заметки — что вы написали о том, когда использовать эту базу — становится публичным описанием.

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

Связанные страницы

MCP Federation — детали протокола, настройка HMAC, права доступа, диагностика
MCP-сервер — как работает локальный MCP-сервер и как подключить клиента
LLM Wiki — как создать базу знаний для AI-агента из хранилища Obsidian