MCP Интеграция

Единый gateway для всех AI-агентов — ни у кого больше этого нет

~5 мин чтения

Что такое MCP?

MCP (Model Context Protocol) — открытый протокол от Anthropic для подключения внешних инструментов к AI-агентам. FlowLink работает как MCP сервер через stdio JSON-RPC, а также через HTTP JSON-RPC endpoint для удалённых подключений.

MCP Architecture

AI агент (Claude Code, Cursor, Copilot) вызывает MCP tools

MCP client (flowlink-relay mcp) подключается к FlowLink relay

FlowLink анализирует команду через 7-уровневый Shield

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

Безопасные команды выполняются на агенте

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

Transport Modes

FlowLink поддерживает два транспорта MCP:

stdio (local)

Для локальных агентов. flowlink-relay mcp запускает MCP сервер на stdin/stdout.

Use: Claude Code, Cursor на локальной машине

flowlink-relay mcp

HTTP (remote)

Для удалённых агентов. MCP сервер доступен по HTTP/HTTPS.

Use: Copilot, Windsurf, cloud IDEs

https://relay.flow-masters.ru:9081/mcp

Поддерживаемые агенты

FlowLink работает с любым MCP-совместимым AI агентом:

Claude Code

native

Cursor

native

GitHub Copilot

native

Windsurf

native

Cline

tested

Aider

tested

Continue

community

Codex CLI

community

Gemini CLI

community

Native = официально поддерживается

Tested = протестировано командой, Community = работает по отзывам сообщества

Настройка

Добавьте в конфиг вашего AI агента:

json

1// Claude Code: ~/.claude/mcp.json
2// Cursor:     ~/.cursor/mcp.json
3// VS Code:    settings.json → "mcp.servers"
4{
5  "mcpServers": {
6    "flowlink": {
7      "command": "flowlink-relay",
8      "args": ["mcp"]
9    }
10  }
11}

Подробнее: Настройка для каждого агента →

Аутентификация

Для HTTP MCP транспорта требуется API ключ. stdio транспорт использует локальную аутентификацию агента.

stdio (local)

Аутентификация через локальный агент. API ключ не требуется.

text

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

HTTP (remote)

API ключ в заголовке Authorization или x-api-key.

text

1{
2  "mcpServers": {
3    "flowlink": {
4      "url": "https://relay.flow-masters.ru:9081/mcp",
5      "headers": {
6        "Authorization": "Bearer flk_live_abc123..."
7      }
8    }
9  }
10}

Public vs Private endpoints

PUBLICtools/list, initialize— для discovery

PRIVATEtools/call— требует API ключ

Rate Limits

MCP endpoint имеет rate limiting для предотвращения abuse:

Starter

100 req/min

Burst: 10 req/s

Team

500 req/min

Burst: 50 req/s

Business

2 000 req/min

Burst: 200 req/s

Enterprise

Безлимит

Burst: Безлимит

Rate limit response заголовки

X-RateLimit-Limit: 1000

X-RateLimit-Remaining: 950

X-RateLimit-Reset: 1642245600

Available Tools

FlowLink MCP сервер предоставляет 43 инструмента (21 gateway + 22 standalone):

flowlink_agentsagent

Список агентов и статус безопасности

flowlink_execagent

Выполнить команду на агенте

flowlink_readagent

Прочитать файл с агента

flowlink_writeagent

Записать файл на агент

flowlink_listagent

Список файлов/директорий

flowlink_sysinfosystem

Системная информация агента

flowlink_deployagent

Деплой с авто-rollback

flowlink_secretssystem

Доступ к секретам из Vault

flowlink_healthsystem

Health check агентов

flowlink_auditaudit

Audit trail для compliance

flowlink_killagent

Завершить процесс на агенте

flowlink_deregisteradmin

Отключить и удалить агента

flowlink_config_updateconfig

Обновить конфигурацию агента

flowlink_policypolicy

Получить/обновить политики агента

flowlink_approveapproval

Одобрить pending запрос

flowlink_denyapproval

Отклонить pending запрос

flowlink_sandbox_statusagent

Статус sandbox агента

Подробно: Все 43 Tools →

Standalone инструменты — работают без relay/agent:

scan_commandsecurity

Сканирование shell-команды

scan_scriptsecurity

Сканирование многострочного скрипта

scan_filesecurity

Сканирование пути к файлу

scan_urlsecurity

URL risk scan (SSRF)

detect_injectionsecurity

Детекция prompt injection

guard_codesecurity

Универсальный сканер кода/диффа/.env

check_depssecurity

CVE scanner зависимостей (OSV API)

risk_snapshotsecurity

Композитный risk score A-F

red_team_scansecurity

Red team scan

get_policypolicy

Текущая security policy

explain_riskpolicy

Подробное объяснение риска

policy_block_commandpolicy

Блокировать команду

policy_protect_pathpolicy

Защитить путь файловой системы

set_modepolicy

Режим безопасности

Пример вызова

AI агент вызывает flowlink_exec для выполнения команды:

json

1// Request (от AI агента)
2{
3  "jsonrpc": "2.0",
4  "id": 1,
5  "method": "tools/call",
6  "params": {
7    "name": "flowlink_exec",
8    "arguments": {
9      "agent_id": "my-server",
10      "command": "ls -la /var/log"
11    }
12  }
13}
14
15// Response (от FlowLink)
16{
17  "jsonrpc": "2.0",
18  "id": 1,
19  "result": {
20    "content": [
21      {
22        "type": "text",
23        "text": "total 48\ndrwxr-xr-x  2 root root 4096 Jan 15 10:30 .\ndrwxr-xr-x 12 root root 4096 Jan 15 09:00 ..\n-rw-r--r--  1 root root  12345 Jan 15 10:30 app.log\n..."
24      }
25    ]
26  }
27}
28
29// Error response (команда заблокирована)
30{
31  "jsonrpc": "2.0",
32  "id": 1,
33  "error": {
34    "code": -32000,
35    "message": "Command blocked by Shield L4: Destructive command",
36    "data": {
37      "level": "L4",
38      "decision": "BLOCKED",
39      "reason": "Destructive command: recursive force delete"
40    }
41  }
42}

Все 43 Tools →Попробовать →

← Концепции 43 Tools →

Changelog

Инструменты

Edit this page