ctxfile — MCP-сервер для Claude Code: что делает и как установить
Сохраняет рабочее состояние проекта, файлы и git-статус в единый снимок для обмена между ИИ-агентами на одной машине. Пригодится при переходе между терминалом и редактором.
claude mcp add ctxfile -e NOTION_TOKEN=<NOTION_TOKEN> -- npx -y ctxfileЧто делает ctxfile
Сервер собирает данные текущей задачи: ключевые файлы с учётом лимита токенов, состояние git, намеченный план и резюме прошлых шагов. Инструмент get_context передаёт готовый слепок новому агенту. Начинать обсуждение с нуля в другом окне не придётся. Для передачи наработок служат вызовы save_session и continue_thread.
Утилита работает локально и читает только дерево файлов и git. Перед сборкой слепка она отсекает токены доступа, приватные ключи и содержимое файлов .env. В проект сервер ничего не записывает. Он остаётся в режиме только для чтения.
Для запуска требуется Node.js версии не ниже 20 (или от 22 на Windows). Внешние сервисы вроде Notion подключаются только при явной передаче токена в переменных окружения.
Какие задачи решает
- Передавать контекст задачи из терминального агента в редактор без ручного копирования
- Сохранять промежуточные решения и статус ветки git между сессиями
- Очищать контекст от паролей и API-ключей перед передачей агенту
- Формировать единый снимок проекта для быстрого старта новой модели
Примеры запросов агенту
- Вызови get_context и загрузи текущее состояние проекта
- Сохрани итоги текущей сессии через save_session перед переключением в другой агент
- Покажи открытые задачи по проекту через list_tasks
Как установить ctxfile
Командой платформы
claude mcp add ctxfile -e NOTION_TOKEN=<NOTION_TOKEN> -- npx -y ctxfileВместо <…> подставьте свои значения
Командой платформы
codex mcp add ctxfile --env NOTION_TOKEN=<NOTION_TOKEN> -- npx -y ctxfileВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"ctxfile": {
"command": "npx",
"args": [
"-y",
"ctxfile"
],
"env": {
"NOTION_TOKEN": "<NOTION_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"ctxfile": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"ctxfile"
],
"env": {
"NOTION_TOKEN": "<NOTION_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e NOTION_TOKEN=<NOTION_TOKEN> ctxfile npx -y ctxfileВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ctxfile
Как установить ctxfile в Claude Code?
Выполните команду claude mcp add ctxfile -e NOTION_TOKEN=<NOTION_TOKEN> -- npx -y ctxfile. Если интеграция с Notion не требуется, переменную окружения можно убрать.
Что делает MCP-сервер ctxfile?
Он собирает файлы проекта, историю коммитов и резюме прошлых шагов в один структурированный объект. Любой совместимый агент забирает эти данные за один вызов, избавляя от повторного объяснения задачи.
Какие системные требования нужны для запуска?
На машине должен быть установлен Node.js версии не ниже 20, а для пользователей Windows понадобится версия 22 или новее.
