Настройка MCP

Подключение FlowLink к вашему AI-агенту

Обзор

FlowLink работает как MCP gateway — единая точка входа для всех AI-агентов. Агенты подключаются по протоколу MCP (Model Context Protocol), и каждый вызов инструмента проходит через 7-уровневый FlowLink Shield для сканирования безопасности.

Архитектура подключения

AI-агент (Claude Code, Cursor, Copilot и др.) вызывает MCP tool

Запрос отправляется через MCP транспорт (stdio или HTTP) на FlowLink relay

FlowLink Shield анализирует вызов: проверяет политики, sandbox, разрешения

Безопасные команды выполняются, опасные — блокируются или запрашивают одобрение

Результат возвращается через MCP обратно в AI-агент

Транспорты:

Cloud (HTTP) — агент на сервере, MCP через relay. Рекомендуется для продакшена.
Self-hosted (stdio) — локальный бинарник flowlink-relay mcp. Для локальной разработки.

Облачное подключение (рекомендуется)

Для использования FlowLink Cloud не нужно ничего устанавливать локально. Агент работает на сервере, MCP — через наш relay.

Что нужно:

Установить агент на сервер: curl -fsSL https://flowlink.flow-masters.ru/install.sh | sh
Получить API key в Dashboard → API Keys
Добавить конфиг MCP в ваш AI-инструмент (инструкции ниже)

Claude Code

Anthropic Claude Code — CLI-агент для терминала. Поддерживает HTTP и stdio MCP.

Вариант A: Cloud (HTTP)

Файл конфигурации: ~/.claude/mcp.json

json

1{
2  "mcpServers": {
3    "flowlink": {
4      "url": "https://flowlink.flow-masters.ru/mcp",
5      "headers": {
6        "Authorization": "Bearer flk_live_ВАШ_API_KEY"
7      }
8    }
9  }
10}

Или через CLI команду:

bash

1claude mcp add flowlink-relay \
2  --url https://flowlink.flow-masters.ru/mcp \
3  --header "Authorization: Bearer flk_live_ВАШ_API_KEY"

Вариант B: Self-hosted (stdio)

Требуется установленный бинарник flowlink-relay в PATH.

json

1{
2  "mcpServers": {
3    "flowlink": {
4      "command": "flowlink-relay",
5      "args": ["mcp"]
6    }
7  }
8}

bash

1# Или через CLI:
2claude mcp add flowlink-relay -- flowlink-relay mcp

Проверка

После настройки откройте Claude Code и попросите вызвать FlowLink tool:

bash

1# В Claude Code введите:
2"Вызови flowlink_sysinfo чтобы узнать информацию о сервере"

Если подключение успешно, Claude Code покажет список доступных flowlink_* инструментов.

Cursor

AI-powered редактор кода Cursor поддерживает MCP через конфигурационный файл проекта.

Cloud (HTTP)

Создайте файл в корне проекта: .cursor/mcp.json

json

1{
2  "mcpServers": {
3    "flowlink": {
4      "url": "https://flowlink.flow-masters.ru/mcp",
5      "headers": {
6        "Authorization": "Bearer flk_live_ВАШ_API_KEY"
7      }
8    }
9  }
10}

Self-hosted (stdio)

json

1{
2  "mcpServers": {
3    "flowlink": {
4      "command": "flowlink-relay",
5      "args": ["mcp"]
6    }
7  }
8}

Проверка

1. Откройте проект в Cursor.

2. В панели MCP (Ctrl+Shift+P → "MCP") убедитесь, что flowlink-relay подключён.

3. В чате Cursor спросите:

bash

1"Use flowlink_sysinfo to check the server"

VS Code + GitHub Copilot

GitHub Copilot в VS Code поддерживает MCP через настройки редактора.

Cloud (HTTP)

Откройте Settings (JSON) в VS Code: Ctrl+Shift+P → Preferences: Open Settings (JSON)

json

1{
2  "mcp": {
3    "servers": {
4      "flowlink": {
5        "url": "https://flowlink.flow-masters.ru/mcp",
6        "headers": {
7          "Authorization": "Bearer flk_live_ВАШ_API_KEY"
8        }
9      }
10    }
11  }
12}

Self-hosted (stdio)

json

1{
2  "mcp": {
3    "servers": {
4      "flowlink": {
5        "command": "flowlink-relay",
6        "args": ["mcp"]
7      }
8    }
9  }
10}

Проверка

1. Перезапустите VS Code после изменения settings.json.

2. Откройте Copilot Chat и попробуйте:

bash

1"Ask flowlink-relay to run flowlink_sysinfo"

Статус подключения MCP в VS Code: View → Output → выберите "MCP" из выпадающего списка.

Windsurf / Kiro

Codeium AI-редакторы Windsurf и Kiro поддерживают MCP через конфигурационный файл проекта.

Cloud (HTTP)

Создайте файл: .windsurf/mcp.json

json

1{
2  "mcpServers": {
3    "flowlink": {
4      "url": "https://flowlink.flow-masters.ru/mcp",
5      "headers": {
6        "Authorization": "Bearer flk_live_ВАШ_API_KEY"
7      }
8    }
9  }
10}

Self-hosted (stdio)

json

1{
2  "mcpServers": {
3    "flowlink": {
4      "command": "flowlink-relay",
5      "args": ["mcp"]
6    }
7  }
8}

Проверка

Перезапустите Windsurf, затем в чате Cascade:

bash

1"Use flowlink-relay to check server info via flowlink_sysinfo"

Универсальный MCP-клиент

Любой MCP-совместимый клиент (Cline, Aider, Continue, Codex CLI, Gemini CLI и др.) может подключиться к FlowLink.

HTTP транспорт

Для клиентов, поддерживающих Streamable HTTP MCP транспорт:

json

1{
2  "mcpServers": {
3    "flowlink": {
4      "url": "https://flowlink.flow-masters.ru/mcp",
5      "headers": {
6        "Authorization": "Bearer flk_live_ВАШ_API_KEY"
7      }
8    }
9  }
10}

Stdio транспорт

Для клиентов, запускающих MCP-сервер как дочерний процесс:

json

1{
2  "mcpServers": {
3    "flowlink": {
4      "command": "flowlink-relay",
5      "args": ["mcp"]
6    }
7  }
8}

Аргументы команды flowlink-relay mcp

flowlink-relay mcp — запуск MCP сервера на stdin/stdout

flowlink-relay mcp --agent-id my-server — указать конкретный agent_id

flowlink-relay mcp --relay wss://relay.example.com — кастомный relay URL

Верификация подключения

После настройки проверьте, что подключение работает корректно.

Проверка Cloud MCP (curl)

bash

1curl -X POST https://flowlink.flow-masters.ru/mcp \
2  -H "Content-Type: application/json" \
3  -H "Authorization: Bearer flk_live_ВАШ_API_KEY" \
4  -d '{"jsonrpc":"2.0","method":"initialize","id":1,"params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'
5
6# Ожидаемый ответ:
7# {"jsonrpc":"2.0","id":1,"result":{"capabilities":{"tools":{}},"serverInfo":{"name":"flowlink-relay","version":"0.1.0"}}}

Проверка статуса агента

bash

1flowlink-relay status
2
3# Вывод должен содержать:
4# Agent:     connected
5# Relay:     wss://relay.flow-masters.ru
6# MCP:       running

Тестовый вызов инструмента

bash

1flowlink-relay exec --command "echo Hello from FlowLink"
2
3# Если всё настроено правильно, вы увидите:
4# Hello from FlowLink

Проверка аудит-логов

Все MCP-вызовы логируются в FlowLink Dashboard.

bash

1flowlink-relay audit-log --last 5
2
3# Вывод:
4# [2025-01-15 10:30:01] MCP initialize  → ALLOWED  agent=claude-code
5# [2025-01-15 10:30:05] tools/call flowlink_sysinfo → ALLOWED  agent=claude-code

Устранение неполадок

Частые проблемы и их решения:

Бинарник flowlink-relay не найден

error: flowlink: command not found

Убедитесь, что flowlink установлен и добавлен в PATH. Проверьте: which flowlink-relay. Если бинарник не найден, переустановите: curl -fsSL https://flowlink.flow-masters.ru/install.sh | sh

Соединение отклонено

error: connection refused (ECONNREFUSED)

Проверьте, что FlowLink relay запущен. Для self-hosted: flowlink-relay status. Для cloud: проверьте подключение к интернету и DNS резолвинг flowlink.flow-masters.ru.

Отказано в доступе (403)

error: {"code":403,"message":"Forbidden"}

Неверный или просроченный API ключ. Проверьте ключ в Dashboard → API Keys. Убедитесь, что ключ начинается с flk_live_ и не содержит пробелов.

Таймаут подключения

error: request timeout after 30s

Проверьте сетевое соединение. Если за proxy/VPN, убедитесь, что HTTPS трафик разрешён. Для self-hosted проверьте, что relay доступен на указанном порту.

MCP сервер не появляется в списке инструментов

В Cursor/Copilot нет flowlink инструментов

Перезапустите IDE. Проверьте синтаксис конфигурационного файла (валидный JSON). Убедитесь, что файл находится в правильной директории. Для Claude Code: claude mcp list.

Permission denied при запуске flowlink

error: permission denied

Убедитесь, что у бинарника flowlink есть права на исполнение: chmod +x $(which flowlink-relay). Для self-hosted установок может потребоваться sudo.

Настройка нескольких агентов

Вы можете подключить несколько AI-агентов к одному FlowLink relay. Каждый агент будет иметь свой agent_id для идентификации в логах и политиках.

Схема multi-agent

claude

Claude Code → FlowLink relay (agent_id: claude-dev)

cursor

Cursor → FlowLink relay (agent_id: cursor-dev)

copilot

Copilot → FlowLink relay (agent_id: copilot-dev)

↓

Все запросы через единый FlowLink Shield → аудит и политики

Разные agent_id через аргументы

Для stdio транспорта используйте --agent-id:

Claude Code (~/.claude/mcp.json):

json

1{
2  "mcpServers": {
3    "flowlink": {
4      "command": "flowlink-relay",
5      "args": ["mcp", "--agent-id", "claude-dev"]
6    }
7  }
8}

Cursor (.cursor/mcp.json):

json

1{
2  "mcpServers": {
3    "flowlink": {
4      "command": "flowlink-relay",
5      "args": ["mcp", "--agent-id", "cursor-dev"]
6    }
7  }
8}

Разные API ключи для каждого агента

Для cloud транспорта можно создать отдельный API ключ для каждого агента в Dashboard → API Keys. Это позволяет:

Отслеживать, какой агент сделал какой вызов
Установить разные rate limits для каждого агента
Отозвать доступ одного агента без влияния на остальных
Применять разные политики безопасности

← Tools Примеры →

Инструменты

Примеры

Edit this page