MCP-сервер

Шаг 1. Опубликуйте знания

Перенесите заметки в Obsidian, опубликуйте через trip2g. Сервис автоматически создаст векторный индекс для поиска.

Шаг 2. Добавьте инструкции

Создайте заметку с инструкциями для AI. В свойствах укажите:

---
mcp_method: instructions
---

Пример инструкций:

# Role
You are a virtual assistant powered by a personal knowledge base.
Your answers MUST be grounded in the knowledge base content.

## Workflow
1. search(query) → find relevant notes
2. Pick 3 most relevant notes
3. Ask clarifying question to confirm direction
4. Load content with note_html(path) — use toc_path from search results to fetch only the relevant section of long notes
5. Synthesize answer through the lens of these notes
6. Cite sources with links

Шаг 2б. Системные инструкции (initialize)

Чтобы клиент получал инструкции автоматически при подключении, создайте заметку с mcp_method: initialize:

---
mcp_method: initialize
free: true
---

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

Шаг 3. Настройте доступ

В настройках сайта включите MCP-сервер. Доступ может быть:

• Открытый — для всех
• По подписке — только для платных подписчиков

search — оглавление и местоположение совпадений

Каждый результат search содержит поле toc — массив объектов с оглавлением документа.

{
  "title": "Введение",
  "level": 2,
  "path": ["Глава 1", "Введение"]
}

path — массив-цепочка, однозначно идентифицирующий раздел. Заголовки могут повторяться под разными родительскими разделами; path их разграничивает. Например, два раздела с одинаковым названием «Введение» под «Главой 1» и «Главой 2» дадут разные пути: ["Глава 1", "Введение"] и ["Глава 2", "Введение"].

Каждое совпадение в массиве matches[] также содержит поле toc_path (массив строк) — указывает на самый вложенный раздел, которому принадлежит этот фрагмент. Используйте его, чтобы понять, где в документе находится совпадение, не загружая заметку целиком.

note_html — получить отдельный раздел

note_html принимает необязательный параметр toc_path. Передайте значение path из элемента оглавления, чтобы получить HTML только этого раздела, а не всей заметки.

note_html(pid=42, toc_path=["Глава 1", "Введение"])

Удобно для длинных заметок: загрузите оглавление через search, выберите нужный раздел по path, затем запросите только его через note_html.

Экономия токенов с навигацией по оглавлению

Длинные заметки при полной загрузке расходуют много токенов. Поля toc и toc_path позволяют агенту загружать только нужный раздел.

Как работают поля:

• Результаты search содержат toc — полное оглавление каждого найденного документа. Каждый элемент оглавления имеет title, level и path (массив-цепочка, идентифицирующий раздел).
• Каждый элемент matches[] содержит toc_path — путь к самому вложенному разделу, которому принадлежит этот фрагмент. Это точное местоположение совпадения в документе.
• note_html принимает toc_path — передайте значение path из оглавления, чтобы получить HTML только этого раздела, а не всей заметки.

Рекомендуемый сценарий:

1. search(query) — получить результаты с toc (структура документа) и matches[].toc_path (местоположение совпадения)
2. Прочитать toc_path лучшего совпадения, чтобы определить нужный раздел
3. note_html(pid=N, toc_path=match.toc_path) — загрузить только этот раздел
4. Если нужен другой раздел — использовать элементы toc из того же результата поиска, без повторного вызова search

Для поиска и получения заметок по федеративным базам смотрите ru/user/federation.

Консультант по чужим знаниям

Эксперт собрал базу знаний по теме. Вы подключили его MCP — получили консультанта, который отвечает в стиле эксперта, ссылается на его материалы.

Продажа доступа к знаниям

Авторы создают базы с инструкциями и продают подписку. Подписчик получает:

• Доступ к актуальным знаниям
• Обновления промптов и методов
• Консультанта в своём чате

Автор получает:

• Регулярный доход от подписок
• Мотивацию поддерживать базу актуальной

Создание токена

1. Перейдите в Пользователь → Токены в настройках аккаунта
2. Нажмите Создать токен
3. Введите имя (например, "Claude Desktop", "API скрипт")
4. Выберите срок действия: 30 дней, 90 дней (по умолчанию), 1 год или Не истекает
5. Нажмите Создать
6. Скопируйте токен — показывается только один раз. Сохраните в безопасном месте

Использование токена

Два формата:

HTTP заголовок Bearer:

curl https://yoursite.com/_system/mcp/tools/call \
  -H "Authorization: Bearer t2g_…" \
  -d '{"method":"search","params":{"query":"дизайн"}}'

Параметр в URL:

curl 'https://yoursite.com/_system/mcp/tools/call?token=t2g_…' \
  -d '{"method":"search","params":{"query":"дизайн"}}'

Контроль доступа

• Администратор: видит все заметки и все подграфы
• Обычный пользователь: видит только заметки в подписанных подграфах
• Токены наследуют ваши разрешения — без дополнительных привилегий

Отзыв токена

1. Перейдите в Пользователь → Токены
2. Найдите токен и нажмите Отозвать
3. Токен прекращает работать немедленно (в течение ~30 секунд при кэшировании)

Использование ключа

curl https://yoursite.com/_system/mcp \
  -H "X-API-Key: <ваш-api-ключ>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Уровень доступа

Аутентификация по API-ключу даёт доступ к контенту на уровне администратора — все заметки и подграфы.

Включить admin-инструменты GraphQL

Чтобы агент получил доступ к graphql_introspection и graphql_request:

1. Перейдите в Администрирование → API-ключи
2. Найдите ключ
3. Включите MCP admin-инструменты

После этого агент сможет изучать схему GraphQL и вызывать любые мутации. Полный сценарий и примеры — в ru/user/agent_admin.

Telegram-боты (планируется)

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