tela — вики команды с MCP для агентов
tela
Вики на Markdown с самостоятельным хостингом и встроенным MCP-сервером: агенты ищут, читают и пишут страницы по правам
- 95 ★ репозитория
- Последний коммит
- AGPL-3.0
Широкий доступ
Почему такой уровень
- Токен дает агенту читать и, при выданных правах, менять и перемещать страницы вики вашей команды
- Содержимое страниц попадает в контекст модели, а в нем бывают внутренние данные
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/telaОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Токен дает агенту читать и, при выданных правах, менять и перемещать страницы вики вашей команды
- Содержимое страниц попадает в контекст модели, а в нем бывают внутренние данные
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
tela — командная вики на Markdown, которую можно развернуть у себя. Бэкенд написан на Go с PostgreSQL, редактор на React 19 и Milkdown, а совместное редактирование идет в реальном времени через Yjs, с комментариями, обратными ссылками и историей версий. Основа страницы всегда обычный Markdown в поле `pages.body`, синхронизация возможна по WebDAV, экспорт идет в zip и PDF. MCP-сервер встроен в бэкенд по адресу `/api/mcp` и не запускается отдельным процессом. Он принимает личный токен доступа в заголовке и дает агентам искать, читать и создавать страницы, перемещать их и оставлять комментарии. Права записи задаются по инструментам и проверяются на сервере. Клиенты с поддержкой HTTP подключаются напрямую и входят через OAuth, для остальных есть пакет `tela-mcp`, тонкий прокси из stdio в HTTP на Node 20 и новее. Полнотекстовый поиск PostgreSQL работает сразу, а при подключенном эмбеддере включается семантический поиск на `pgvector` и ответы на вопросы по документации. Функция Atlas набрасывает и поддерживает страницы по вашим источникам. Для развертывания нужны Docker и make: `make setup`, затем `make up`.
Для кого. Команды разработки и поддержки, которые ведут документацию в своей вики и хотят, чтобы Claude Code и Cursor читали и дописывали ее.
Подходит, если
- Нужна вики на собственном сервере, где Markdown остается основным форматом
- Агент должен искать по документации и отвечать со ссылками на страницы
- Надо, чтобы агент дописывал страницы, но без права удалять
- Документация устаревает, и ее нужно подтягивать из кода
- Хотите открыть пространство как блог без входа и с личными страницами авторов
Не подходит, если
- Вики нужна без своей инфраструктуры: развертывание требует Docker, PostgreSQL и Caddy, есть облачный вариант на telawiki.com
- Вики должна быть на закрытой лицензии: ядро выпущено под AGPL-3.0, а для встраивания в закрытый сервис нужна коммерческая лицензия
- Агенту нужен лишь доступ к существующему трекеру: для этого есть отдельные серверы
Пример запроса к агенту
Найди в нашей вики страницы про выкатку релиза, ответь как деплоить, со ссылками на страницы, и добавь комментарий к устаревшей.MCP
- Транспорт
- http, stdio
- Авторизация
- API-ключ
Переменные окружения
TELA_BASE_URLобязательная- Адрес экземпляра tela
TELA_API_KEYобязательная, секрет- Личный токен доступа tela_pat_
Ограничения
Ядро выпущено под AGPL-3.0: если вы запускаете измененную версию как сетевой сервис, нужно дать пользователям исходный код. Пакет `tela-mcp` выпущен под `AGPL-3.0-only`, он не реализует инструменты сам и только пробрасывает протокол на `/api/mcp`. Для семантического поиска нужен эмбеддер и расширение `pgvector`, без них работает только полнотекстовый. Вход через OAuth для Claude.ai и ChatGPT включается настройкой WorkOS AuthKit, иначе доступ идет по личному токену. Инструмент `generate_deck_image` отвечает 503, пока не задан адрес сервиса изображений. Прокси для stdio требует Node 20 и новее.
Как отключить. Удалите запись `tela` из конфигурации клиента и отзовите токен в разделе Settings, API Keys. Сам сервер останавливает команда `make down`.
Частые вопросы
Как подключить tela к Claude Code?
Для HTTP-клиентов адрес `https://telawiki.com/api/mcp` или `/api/mcp` вашего сервера, вход через OAuth. Для stdio используйте `npx -y tela-mcp` с `TELA_BASE_URL` и `TELA_API_KEY`.
Где хранится содержимое страниц?
В поле `pages.body` как обычный Markdown, без таблицы блоков. Данные можно синхронизировать по WebDAV и выгрузить в zip или PDF.
Можно ли дать агенту права только на чтение?
Да. Права записи задаются по инструментам и проверяются на сервере, личный токен выдается в разделе Settings, API Keys.
Что нужно для самостоятельного запуска?
Docker с Compose и make. Команды `make setup` и `make up` собирают образы и поднимают стек за Caddy на `http://localhost:8780`, мастер `/setup` создает администратора.
Как включить семантический поиск?
Подключите эмбеддер и включите `pgvector`. В Compose есть необязательный профиль с Ollama, адрес эмбеддера задается переменной `TELA_RAG_EMBED_URL`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыWiki команды в Git с MCP-сервером на 51 инструмент: агент читает и правит страницы, таблицы и доски.
MCP-сервер для Яндекс Вики: чтение страниц по slug или ссылке, создание, обновление и дописывание, есть режим только чтения
Официальный MCP-сервер Kibela ищет, читает и правит заметки, папки и комментарии вашей вики прямо из чата с ассистентом
MCP-сервер на Go для чтения Яндекс Трекера и Яндекс Вики: задачи, очереди, спринты, комментарии, страницы и динамические таблицы
MCP-сервер для вики BookStack: поиск и чтение по умолчанию, запись включается отдельно, права берутся из токена.
MCP-сервер к базе знаний, которую Beever Atlas строит из чатов Slack, Discord, Teams и Mattermost: ответы с цитатами, вики по каналам, граф связей
Коротко о README
README объясняет, чем tela отличается, затем дает быстрый старт на Docker Compose, облачный запуск в один клик, полезные цели `make` и необязательный семантический поиск. Дальше идут переменные окружения, аутентификация (OAuth для MCP и федеративный вход), подключение агентов к MCP и условия лицензии AGPL-3.0 с коммерческим вариантом.