У FISYCO есть MCP-сервер, через который ИИ-агенты получают вашу дизайн-систему. Прежде чем писать интерфейс, агент находит готовые компоненты, смотрит, как команда их вызывает, узнаёт имена токенов и проверяет свой код по тем же замечаниям, что оставляет проверка pull request. Здесь описано, как подключить Claude Code, Cursor, VS Code с GitHub Copilot или Windsurf.
Перед началом
- У вас есть аккаунт FISYCO с доступом к проекту, в котором будет работать агент.
- Для проекта настроена дизайн-система в коде, см. Подключение дизайн-системы в коде. Без проиндексированного репозитория агент получит токены и правила команды, но не компоненты.
Подключите агента
Сервер удалённый, ставить ничего не нужно. Агент подключается по одному адресу и входит через ваш браузер.
- Откройте меню аккаунта, затем Настройки аккаунта → ИИ-агенты.
- В блоке 1. Добавьте FISYCO в агента выберите вкладку своего агента и скопируйте фрагмент. Адрес в нём уже нужный.
- Выполните его в терминале или добавьте в файл, который назван на вкладке, и запустите агента.
- При первом подключении агент откроет страницу FISYCO в браузере. Проверьте, как представился агент и куда уйдёт ответ, и нажмите Разрешить.
Фрагменты на странице выглядят так:
Режим агента GitHub Copilot в VS Code читает .vscode/mcp.json, поэтому для Copilot берите вкладку VS Code.
Предупреждение на странице согласия стоит не зря. Нажимайте Разрешить, только если сами начали подключать этого агента и только что. Если ссылку прислали со стороны, нажмите Запретить.
Дальше агент действует от вашего имени. Он видит только те пространства и проекты, что видите вы, и с вашей ролью.
Вход по токену
Агент, который не может открыть браузер, например в CI или на удалённой машине, может передать личный токен. Создайте его на странице Токены доступа. После создания FISYCO покажет конфиг с токеном в заголовке Authorization:
{
"mcpServers": {
"fisyco": {
"type": "http",
"url": "https://api.fisyco.com/mcp",
"headers": { "Authorization": "Bearer <ваш токен>" }
}
}
}Инструментам, которые читают дизайн-систему в коде, нужна область чтения кодовой базы, а на странице Токены доступа её нет. С нужными областями такой токен покрывает инструменты библиотек Figma, токены и руководство по дизайн-системе. Для остальных инструментов, включая поиск компонентов и check_ui_code, используйте вход через браузер.
Про области и срок действия: Токены доступа.
Что получает агент
Четырнадцать инструментов. Все только читают, кроме одного, который запускает синхронизацию библиотеки. Описание каждого инструмента подсказывает агенту, когда его вызывать.
check_ui_code читает фрагмент и не сохраняет его. Правила, которые команда задала для агентов, доходят до них через get_design_system_rules, поиск и check_ui_code, см. Правила для ИИ-агентов.
Инструменты работают с конкретным проектом. Если агент спросит, какой проект, дайте ему ID проекта: часть адреса страницы проекта после /projects/.
Чтобы попробовать, попросите агента сделать что-то обычное, например модальное окно подтверждения удаления, и сначала найти готовые компоненты и токены.
Что делали агенты
- Настройки аккаунта → ИИ-агенты → Подключённые агенты: все агенты, которые обращались к FISYCO с вашим аккаунтом за 30 дней. Видно, как агент вошёл, сколько было вызовов и когда последний.
- Авторизованные агенты на той же странице: агенты, которым вы разрешили вход через браузер. Отозвать сразу выводит агента из аккаунта.
- В проекте, в разделе Дизайн-система в коде → ИИ-агенты, есть отчёт за 30 дней: разработчики с агентами, предложенные готовые компоненты, отведённые от устаревших, замечания в pull request и Недостающие компоненты, которые агенты искали и не нашли. Владельцы пространства получают этот отчёт письмом раз в месяц.
FISYCO записывает, какой инструмент вызван, каким агентом и с каким исходом. Исходный код он не хранит.