# codex-tldraw-mcp

Сервер создаёт редактируемые диаграммы проекта в .tldr и SVG-превью, а также отслеживает изменения в графе импортов JavaScript и TypeScript. Пригодится для документации архитектуры и рабочих процессов.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 25
- Автор: jananadiw
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/jananadiw/codex-tldraw-mcp
- Обновлён: 2026-10-14
- HTML: https://affpapa.org/nevibecode/mcp/codex-tldraw-mcp

## Что делает

\`codex-tldraw-mcp` работает как MCP-сервер через stdio. Он сканирует репозиторий и добавляет диаграмму продуктового процесса или архитектуры в файл `.tldr`; отдельно можно попросить нарисовать схему состояния, план или произвольный процесс. Рядом сохраняется SVG-превью, а существующие доски дополняются новыми схемами.

Для JavaScript и TypeScript сервер строит граф модулей и импортов. Инструмент сравнения показывает изменения и устаревшие элементы; результаты доступны через инструменты для просмотра списка досок и их краткого описания. Для вызовов инструментов плагина укажите абсолютный путь репозитория: относительные пути отклоняются, чтобы не записывать схемы в кэш плагина.

Файлы по умолчанию создаются в `boards/` внутри репозитория. Плагину нужны Node.js версии 20.11 или новее и `npm` в `PATH`; при первом запуске через резервный вариант `npx` нужен доступ к реестру пакетов. MCP-хосты без поддержки приложений всё ещё могут использовать текстовые результаты и SVG-превью.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `TLDRAW_MCP_ALLOWED_ROOTS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env TLDRAW_MCP_ALLOWED_ROOTS=<TLDRAW_MCP_ALLOWED_ROOTS> --transport stdio codex-tldraw-mcp -- npx -y codex-tldraw-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add codex-tldraw-mcp --env TLDRAW_MCP_ALLOWED_ROOTS=<TLDRAW_MCP_ALLOWED_ROOTS> -- npx -y codex-tldraw-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "codex-tldraw-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "codex-tldraw-mcp"
            ],
            "env": {
                "TLDRAW_MCP_ALLOWED_ROOTS": "<TLDRAW_MCP_ALLOWED_ROOTS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "codex-tldraw-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "codex-tldraw-mcp"
            ],
            "env": {
                "TLDRAW_MCP_ALLOWED_ROOTS": "<TLDRAW_MCP_ALLOWED_ROOTS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e TLDRAW_MCP_ALLOWED_ROOTS=<TLDRAW_MCP_ALLOWED_ROOTS> codex-tldraw-mcp npx -y codex-tldraw-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- построить диаграмму рабочего процесса репозитория
- показать архитектуру проекта и связи компонентов
- создать граф импортов модулей JavaScript и TypeScript
- найти устаревшие узлы и связи в сохранённом графе
- добавить SVG-превью к редактируемой доске проекта

## Примеры запросов агенту
- Построй диаграмму рабочего процесса этого репозитория с помощью `codex-tldraw-mcp`.
- Нарисуй схему состояний сброса пароля и сохрани её в доску проекта.
- Сравни граф импортов с текущим кодом и отметь устаревшие элементы.

## Похожие
- [Next AI Draw.io](https://affpapa.org/nevibecode/mcp/next-ai-drawio.md) — MCP-сервер · ★ 36398
- [tldraw](https://affpapa.org/nevibecode/mcp/tldraw.md) — MCP-сервер · ★ 51091
- [Figma-Context-MCP](https://affpapa.org/nevibecode/mcp/figma-context-mcp.md) — MCP-сервер · ★ 16062
- [Agent-Native Assets](https://affpapa.org/nevibecode/mcp/agent-native-assets.md) — MCP-сервер · ★ 7506
- [Remove AI Watermarks](https://affpapa.org/nevibecode/mcp/remove-ai-watermarks.md) — MCP-сервер · ★ 6114
- [Dembrandt](https://affpapa.org/nevibecode/mcp/dembrandt.md) — MCP-сервер · ★ 3821

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md