MCP-серверы и инструменты рабочих процессов
MCP-серверы связывают AI Flowi Workflow от Ai Flowi с клиентами и внешними инструментами. MCP Server проекта предоставляет выбранные рабочие процессы как вызываемые инструменты. Настройки MCP Servers сохраняют внешние подключения для рабочих процессов, а MCP Client предоставляет конфигурацию для агентов для разработки кода. В представлении JSON для MCP Server проекта доступны 2 транспорта: SSE или Streamable HTTP. Внешние подключения MCP также поддерживают STDIO.
Опубликовано · Обновлено
Продукт: AI Flowi Workflow от Ai Flowi · Задача: Подключить клиентов и инструменты рабочих процессов · Компонент: MCP Tools для инструментов внешнего сервера
Когда это использовать
Используйте MCP Server, чтобы предоставить MCP-клиенту доступ к выбранным рабочим процессам проекта.
Используйте MCP Servers и MCP Tools, чтобы подключить инструменты внешнего сервера к рабочему процессу.
Используйте MCP Client, чтобы скопировать конфигурацию для агентов для разработки кода, которые создают и запускают рабочие процессы в вашем экземпляре AI Flowi Workflow.
Перед началом
- Выберите проект и рабочие процессы, к которым хотите предоставить доступ, или получите конфигурацию подключения внешнего сервера.
- Используйте обычный сеанс своей учётной записи: во время сеанса поддержки настройки MCP скрыты.
- Храните ключи API в своей приватной конфигурации клиента; в документации используйте заполнитель YOUR_API_KEY.
- Элементы управления аутентификацией проекта появляются только при включённой настройке конструктора MCP.
Порядок действий
1. MCP Server · Flows/Tools
Откройте представление MCP Server проекта и выберите Изменить инструменты в разделе Flows/Tools.
Проверьте названия и описания инструментов, затем включите только рабочие процессы, предназначенные для этого клиента.
Сохранённые настройки инструментов включают название и описание каждого рабочего процесса, а также сведения о том, включён ли он.
2. Auth · Добавить аутентификацию / Изменить аутентификацию
Если отображается Auth, выберите Добавить аутентификацию или Изменить аутентификацию и проверьте способ аутентификации.
Способы обозначены как None, API Key и OAuth; в сводке Auth проект без аутентификации обозначен как None (общедоступный).
Если настройка конструктора отключена, при сохранении выбранных инструментов используется настройка аутентификации None, а сгенерированные заголовки клиента зависят от конфигурации входа в экземпляр.
Прежде чем передавать адрес конечной точки проекта, проверьте сгенерированную конфигурацию и доступ вместе с администратором.
3. JSON · Transport
Выберите JSON, затем macOS/Linux, Windows или WSL, после чего выберите SSE или Streamable HTTP в Transport.
Скопируйте сгенерированную конфигурацию в MCP-клиент и замените YOUR_API_KEY в своей приватной конфигурации во всех местах, где встречается этот заполнитель.
Используйте Создать ключ API, если это действие доступно в представлении JSON и вам нужен ключ.
Для автоматической установки необходимо, чтобы AI Flowi Workflow работал на вашем локальном компьютере, а выбранный клиент был доступен; для удалённого экземпляра используйте JSON.
Проверьте выбранный инструмент на безвредных входных данных и убедитесь, что клиент получает ожидаемый ответ рабочего процесса.
4. MCP Servers · Добавить MCP-сервер
В настройках откройте MCP Servers и выберите Добавить MCP-сервер.
Выберите JSON, чтобы вставить конфигурацию сервера; STDIO, чтобы задать Name, Command, Arguments и Environment Variables; или Streamable HTTP/SSE, чтобы задать Name, Streamable HTTP/SSE URL, Headers и Environment Variables.
Для STDIO убедитесь, что указанная команда и её зависимости доступны на сервере, где работает AI Flowi Workflow.
Выберите Добавить сервер, затем проверьте количество инструментов сохранённого подключения или сообщение об ошибке.
Используйте Изменить и Обновить сервер, чтобы изменить подключение; Удалить открывает подтверждение перед удалением.
5. MCP Tools · MCP Server / Tool
Добавьте MCP Tools в рабочий процесс, выберите сохранённый MCP Server, выберите Tool и заполните отображаемые входные поля.
Запустите компонент и проверьте выход Response — таблицу с результатом выбранного инструмента.
Для подключений HTTPS оставляйте Verify SSL Certificate включённым.
Headers компонента переопределяют заголовки, сохранённые в настройках сервера.
6. MCP Client · Bob (IBM) / Claude Code
В настройках откройте MCP Client и выберите Bob (IBM) или Claude Code.
Для Bob (IBM) откройте Настройки > MCP, выберите Изменить глобальную конфигурацию MCP или Изменить конфигурацию MCP проекта, вставьте отображаемый JSON и сохраните.
Для Claude Code используйте отображаемую команду терминала или добавьте конфигурацию JSON в ~/.claude.json.
В конфигурации клиента адрес текущего экземпляра используется как SERVER_URL, а YOUR_API_KEY — как заполнитель API_KEY.
Создайте ключ в настройках API Keys и замените заполнитель в своей приватной конфигурации.
Частые ошибки
- Путать MCP Server проекта с внешним подключением, сохранённым в MCP Servers.
- Считать, что автоматическая установка работает с удалённым экземпляром.
- Передавать сгенерированную конфигурацию с реальным ключом API.
- Ожидать выполнения подключения к серверу до выбора Tool.
Устранение неполадок
При ошибке «Ошибка конфигурации MCP-сервера» исправьте конфигурацию OAuth проекта перед генерацией конфигурации клиента.
При статусе Превышено время ожидания или Ошибка в MCP Servers изучите подробности ошибки сервера и проверьте настройки подключения.
При сообщении «Инструменты не найдены» проверьте, предоставляет ли внешний сервер инструменты, прежде чем выбирать его в MCP Tools.
Если названия или входные поля инструментов устарели, отключите Use Cached Server, чтобы получить актуальные инструменты и обновления сервера.
При сообщениях «Необходимо указать имя и команду.» или «Необходимо указать имя и URL.» заполните обязательные поля перед добавлением сервера.
Связанные материалы
Документация · AI Flowi Workflow · Рабочие пространства · API Hub · Публикация · Публикация рабочего процесса как веб-приложения · Тарифы · Записаться на демонстрацию