
Serena MCP
Даёт агенту возможности IDE: искать символы и ссылки на них, переименовывать по всему проекту, менять тело функции целиком. Понимание кода берётся из языковых серверов, поддерживается больше 40 языков.
Как подключить
Что сделать до подключения
Менеджер пакетов uv
Установка: uv tool install -p 3.13 serena-agent, затем serena init
Для некоторых языков нужны дополнительные зависимости языкового сервера
Конфиг для вашего клиента
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --transport stdio serena \
-- serena start-mcp-server --context=ide --project-from-cwdПроверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.serena]
command = "serena"
args = ["start-mcp-server", "--context=ide", "--project-from-cwd"]Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"serena": {
"command": "serena",
"args": ["start-mcp-server", "--context=ide", "--project-from-cwd"]
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"serena": {
"type": "stdio",
"command": "serena",
"args": ["start-mcp-server", "--context=ide", "--project-from-cwd"]
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"serena": {
"command": "serena",
"args": ["start-mcp-server", "--context=ide", "--project-from-cwd"]
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"serena": {
"command": "serena",
"args": ["start-mcp-server", "--context=ide", "--project-from-cwd"]
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"serena": {
"type": "local",
"command": ["serena", "start-mcp-server", "--context=ide", "--project-from-cwd"]
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"serena": {
"command": "serena",
"args": ["start-mcp-server", "--context=ide", "--project-from-cwd"]
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"serena": {
"command": "serena",
"args": ["start-mcp-server", "--context=ide", "--project-from-cwd"]
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
find_symbolищет символ по проектуget_symbols_overviewпоказывает структуру файлаfind_referencing_symbolsнаходит, где используется символfind_declarationнаходит объявлениеfind_implementationsнаходит реализацииget_diagnostics_for_fileпоказывает ошибки в файлеreplace_symbol_bodyзаменяет определение символаinsert_after_symbolвставляет код после символаinsert_before_symbolвставляет код перед символомrename_symbolпереименовывает по всему проектуreplace_contentзаменяет текст по регуляркеsearch_for_patternищет по регуляркеread_fileчитает файлexecute_shell_commandвыполняет команду в терминалеwrite_memoryсохраняет заметку о проектеread_memoryчитает заметкуactivate_projectоткрывает проектЧто попросить агента
Для каких задач
Ограничения
Перенос символов и файлов, инлайн, поиск по зависимостям и иерархия типов есть только в платном плагине Serena для JetBrains
Сервер выполняет команды в терминале и меняет файлы; полностью защищает только запуск в песочнице
Ставить из маркетплейсов MCP не нужно: там устаревшие команды установки
Клиенту нужен путь к команде serena; если клиент её не находит, укажите полный путь