evc-team-relay-mcp

Аутентификация с Relay Control Plane. В режиме agent-key (установлена RELAY_AGENT_KEY): логин не требуется: каждый запрос напрямую содержит X-Agent-Key. В режиме email/пароль: используются переменные окружения RELAY_EMAIL и RELAY_PASSWORD. Токен управляется внутренне; последующие вызовы инструмента используют его автоматически.

Удалить файл из общего доступа к папке. Удаляет файл из реестра метаданных папки. Файл исчезает из Obsidian при следующей синхронизации. Аргументы: share_id: UUID общего доступа к папке. file_path: Путь к файлу внутри папки (например, "old-note.md"). Возвращает: JSON с путём и статусом.

Перечисляет файлы в общей папке. В режиме agent-key (установлены RELAY_AGENT_KEYS или RELAY_AGENT_KEY): используется endpoint agent-key; share_id может быть UUID или веб-слагом. В режиме email/password: share_id должен быть UUID. Аргументы: share_id: UUID или веб-слаг общей папки. Возвращает: JSON с share_id и картой файлов (path -> file).

Получить список всех доступных общих ресурсов. В многоключевом режиме (установлено RELAY_AGENT_KEYS): возвращает метаданные для каждого общего ресурса, у которого настроен ключ, полученные через аутентификацию по ключу агента для каждого ресурса. В одноключевом режиме (только RELAY_AGENT_KEY): возвращает пустой список - единственный ключ привязан к одному общему ресурсу, но его идентификатор неизвестен; вызывайте list_files или tr_search напрямую с известным share_id. В режиме email/пароль: возвращает все общие ресурсы, к которым у пользователя есть доступ. Аргументы: kind: Фильтр по типу общего ресурса - "doc" или "folder". Пустая строка - все. owned_only: Если true, возвращать только общие ресурсы, принадлежащие пользователю (только в режиме email/пароль). Возвращает: Массив JSON с общими ресурсами, содержащий id, kind, path, owned.

Читает содержимое документа по doc_id (низкоуровневая операция). Для шеров документов не передавайте doc_id — по умолчанию используется share_id. Для шеров папок передавайте doc_id файла из list_files. Для папок предпочитайте read_file. Аргументы: share_id: UUID шара (для проверки ACL). doc_id: UUID документа. По умолчанию равен share_id для шеров документов. key: ключ общего типа Yjs. По умолчанию "contents". Возвращает: JSON с полями doc_id, content, format.

Читает файл из общей папки по его пути. В режиме ключа агента (установлен RELAY_AGENT_KEY): загружает через точку скачивания ключа агента; share_id может быть UUID или веб-слагом. В режиме email/пароль: автоматически преобразует путь в doc_id; share_id должен быть UUID. Параметры: share_id: UUID или веб-слаг общей папки. file_path: Путь к файлу внутри папки (например "Marketing/plan.md"). Возвращает: JSON с содержимым, форматом и типом.

Поиск документов TR по пути/имени в общей папке. В режиме агент-ключа (установлен RELAY_AGENT_KEY): share_id может быть UUID или web slug. В режиме email/пароль: share_id должен быть UUID. Аргументы: share_id: UUID или web slug общей папки. query: строка поиска, сравнивается без учёта регистра с путями файлов. limit: максимальное количество результатов (по умолчанию 20). Возвращает: JSON-список соответствующих файлов: [{"id": doc_id_or_null, "title": filename_without_ext, "path": full_path, "relay_url": "relay://<slug>/<path>", "updated_at": null}]

Создать или обновить файл в расшаренной папке. Два режима аутентификации: **Режим ключа агента** (установлен RELAY_AGENT_KEY): - share_id может быть UUID расшаренной папки или веб-слагом (например, "research-vault") - Папки используют /sync-upload — файл попадает в CRDT-синхронизацию и появляется в локальных хранилищах Obsidian у подписчиков при следующей синхронизации - Документы используют /upload (только веб-публикация) - list_files, read_file и tr_search также работают с тем же ключом агента **Режим email/пароль** (установлены RELAY_EMAIL + RELAY_PASSWORD): - share_id — это UUID расшаренной папки - Синхронизация в реальном времени через CRDT - Автоматически определяет создание или обновление Параметры: share_id: UUID расшаренной папки (режим email/пароль) или веб-слаг (режим ключа агента). file_path: Путь к файлу внутри расшаренной папки (например, "notes/todo.md"). content: Полное текстовое содержимое для записи. Возвращает: JSON с путём, размером/операцией и необязательным public_id.

Записывает содержимое в документ по doc_id (только для общих папок). Для общих папок используйте upsert_file. Аргументы: share_id: UUID общей папки (для проверки ACL). doc_id: UUID документа. content: Полный текст для записи (заменяет весь документ). key: Тип ключа Yjs shared type. По умолчанию "contents". Результат: JSON с полями doc_id и content.