Счётчик Яндекс Метрики
Перейти к основному содержанию
Atomno labs

Devin Desktop — так теперь называется Windsurf

MCP-серверы для Windsurf

18 серверов с российскими государственными данными для Windsurf, который теперь называется Devin Desktop. В приложении два агента, и настраиваются они по-разному: Cascade читает mcp_config.json, Devin Local — свои файлы через команду devin mcp add.

Что такое MCP-сервер в Windsurf?

Windsurf сменил имя: приложение называется Devin Desktop, а документация переехала на docs.devin.ai. Ссылки вида windsurf:// и настройки команды на прежнем домене при этом продолжают работать.

Внутри приложения два агента — это первое, что нужно понять перед настройкой. Cascade, прежний агент, берёт серверы из файла ~/.codeium/windsurf/mcp_config.json. Devin Local, агент по умолчанию для новых вкладок, читает файлы Devin CLI и настройки Cascade не видит вообще.

Сам MCP-сервер в обоих случаях устроен одинаково: это программа с набором инструментов, которую агент запускает и вызывает по ходу задачи. Поддерживаются локальный процесс, Streamable HTTP и устаревший SSE. У Devin Local уровней хранения три — локальный, проектный и личный, — и проектный уезжает в репозиторий вместе с кодом.

У Cascade есть потолок: одновременно доступно не больше ста инструментов на все серверы, лишние выключаются вручную на странице сервера. Devin Local ограничения по числу не ставит, но по умолчанию спрашивает подтверждение на каждый вызов, пока вы не пропишете правила разрешений.

Подключение: сначала выберите агента

Порядок зависит от того, в каком агенте вы работаете. Для Devin Local всё делается одной командой, для Cascade — через магазин серверов или правку файла. Ниже показаны оба пути.

Где лежат настройки

Cascade ~/.codeium/windsurf/mcp_config.json
Devin Local — личный ~/.config/devin/mcp_config.json
Devin Local — личный (Windows) %APPDATA%\devin\mcp_config.json
Devin Local — проектный <проект>/.devin/mcp_config.json
Devin Local — локальный <проект>/.devin/mcp_config.local.json
Из интерфейса Cascade значок MCPs в панели Cascade либо Devin Settings → Cascade → MCP Servers
Про версии до v3000.3 раньше серверы Devin Local хранились в основных файлах config.json — при обновлении записи переносятся в отдельные файлы автоматически
Пути Cascade на Windows и Linux в документации приведён только вариант через домашнюю папку — надёжнее открывать файл из интерфейса приложения
  1. 1

    Devin Local: добавьте сервер командой

    Команда devin mcp add сама понимает тип сервера: команда после двух дефисов означает локальный процесс, переданный адрес — сервер по сети. По умолчанию запись уходит в локальный файл, который исключён из репозитория; уровень меняется флагом -s.

    devin mcp add atomno-cbr-rates -- uvx atomno-mcp-cbr-rates
    
    devin mcp add -s project atomno-rosreestr -- uvx atomno-mcp-rosreestr
    
    devin mcp add -s user atomno-newbuild -- uvx atomno-mcp-newbuild
  2. 2

    Cascade: магазин серверов или правка файла

    Значок MCPs в правом верхнем углу панели Cascade открывает магазин, установка — кнопкой Install. Нужного сервера в магазине нет — впишите его в mcp_config.json сами. Секрет в файл класть необязательно: значение можно подтянуть из переменной окружения или из отдельного файла.

    ~/.codeium/windsurf/mcp_config.json

    {
      "mcpServers": {
        "atomno-cbr-rates": {
          "command": "uvx",
          "args": ["atomno-mcp-cbr-rates"]
        },
        "atomno-fssp": {
          "command": "uvx",
          "args": ["atomno-mcp-fssp"],
          "env": {
            "MCP_FSSP_TOKEN": "${file:~/.secrets/atomno-fssp.txt}"
          }
        }
      }
    }
  3. 3

    Проверьте, что инструменты дошли до агента

    В Devin Local перечень серверов покажет devin mcp list, подробности по одному — devin mcp get с именем. В Cascade откройте страницу сервера через значок MCPs: там список инструментов с переключателями. Держите в голове потолок в сто инструментов — при его превышении часть просто не дойдёт до агента.

    devin mcp list
    devin mcp get atomno-cbr-rates

Что спросить у агента

Сами запросы в обоих агентах одинаковые — разница только в том, где сервер настроен:

  • «Пересчитай смету в евро по курсу ЦБ на дату договора.»
  • «Что известно по кадастровому номеру: площадь, назначение, ограничения?»
  • «Проверь застройщика этого дома: разрешение на строительство, сроки, проблемные объекты.»

С чего начать в Windsurf

У Cascade есть потолок по числу инструментов, а Devin Local просит подтверждение на каждый вызов, поэтому начинать разумно с небольших серверов только на чтение.

18 серверов для Windsurf

Имя пакета после uvx — единственное, что меняется от сервера к серверу. Настраивать придётся дважды, если работаете и в Cascade, и в Devin Local: общего списка серверов у агентов нет.

ФНС / Налоги (3)

Финансы (2)

Юр. данные (6)

Недвижимость (2)

Госзакупки (1)

SEO / Маркетинг (2)

Бизнес-системы (2)

Фильтры по категории и лицензии — в общем каталоге.

Типовые ошибки в Windsurf

Ошибки, которые встречаются именно здесь:

Настроили Cascade, а работаете в Devin Local

Новые вкладки открываются с агентом Devin Local, а он файл mcp_config.json от Cascade не читает. Серверы для него добавляются командой devin mcp add. Это самая частая причина жалобы «сервер добавлен, но агент его не видит».

Ищут инструкцию под старым именем

Разделы про MCP переехали на docs.devin.ai, а страницы про Cascade помечены как относящиеся к прежнему агенту. Прежде чем повторять чужую инструкцию, проверьте эту пометку: половина статей в сети описывает настройку, которая в новых вкладках уже не применяется.

Упёрлись в потолок ста инструментов

Cascade держит не больше ста инструментов одновременно, и считаются они по всем серверам сразу. Когда предел превышен, часть инструментов не доходит до агента без внятного сообщения. Лишние выключаются на странице сервера в разделе MCPs.

Ключ попал в общий файл проекта

Файл .devin/mcp_config.json специально коммитится, чтобы набор серверов был у всей команды. Личные ключи держите в .devin/mcp_config.local.json — он исключён из репозитория. В Cascade вместо самого значения можно подставить ссылку на переменную окружения или на файл с секретом.

Администратор включил список разрешённых серверов

Стоит команде добавить в список хотя бы один сервер, как все остальные блокируются. Идентификатор в списке сверяется с именем ключа посимвольно и с учётом регистра, поэтому расхождение в одну букву выглядит как неработающий сервер.

Вопросы и ответы

Как теперь называется Windsurf? +
Devin Desktop. Документация лежит на docs.devin.ai, ссылки вида windsurf:// и настройки команды на прежнем домене продолжают работать. Привычное имя мы сохраняем на странице, чтобы его можно было найти поиском.
Чем Cascade отличается от Devin Local при настройке? +
Местом хранения серверов. Cascade читает ~/.codeium/windsurf/mcp_config.json. Devin Local берёт их из файлов Devin CLI — локального, проектного и личного. Один и тот же сервер для двух агентов придётся описать дважды.
Какой уровень выбрать в devin mcp add? +
По умолчанию используется локальный: запись уходит в .devin/mcp_config.local.json, который не попадает в репозиторий. Флаг -s project кладёт сервер в общий файл проекта, -s user — в личный, действующий во всех ваших проектах.
Сколько серверов выдержит Cascade? +
Ограничение считается не по серверам, а по инструментам: одновременно доступно не больше ста. Ненужные инструменты выключаются на странице сервера, поэтому несколько небольших серверов уживаются спокойно.
Devin Local спрашивает разрешение на каждый вызов — это меняется? +
Да, правилами разрешений: разрешить, запретить или всегда спрашивать. Правило записывается как имя сервера и инструмента, звёздочка охватывает все инструменты сервера сразу. Пишущие инструменты в разрешённые добавлять не стоит.
Где лежит файл настроек на Windows? +
Для Devin Local это %APPDATA%\devin\mcp_config.json — путь указан в документации Devin CLI. Для Cascade раскладки по операционным системам в документации нет, приведён только вариант через домашнюю папку, поэтому файл надёжнее открывать из интерфейса приложения.

Официальная документация Devin по MCP

Мы описали короткий путь до рабочего сервера. Полный список полей, вход по OAuth, правила разрешений и командные ограничения лежат в документации Devin: отдельно для Devin Local и отдельно для прежнего агента Cascade.

Открыть документацию

Проверьте, в каком агенте вы работаете

Определитесь с агентом, добавьте курсы ЦБ — ключ им не нужен — и убедитесь, что инструменты появились именно в той вкладке, где вы работаете.

Atomno MCP не аффилирован с Windsurf. Данные — из открытых государственных реестров; ответственность за соблюдение условий использования источников остаётся на пользователе.