tools/call прогоняется через движок firewall,
прежде чем достигнет реального сервера. Эта страница — карта этой
поверхности: шлюз, вердикт на каждый вызов, управление навыками, egress и
зашифрованные учётные данные — со ссылками на сфокусированный how-to по
каждому.
Каждое управляющее действие здесь настраивается из консоли (или REST
API с вашим session/access-токеном) и защищено ролями. Только
/v1/*
relay-вызовы и gateway-маршруты firewall несут ключ вида
sk-orca-....1. Почему безопасности mcp нужен шлюз
Направьте десять агентов на пять community-MCP-серверов напрямую — и вы получите худшее из всех миров: ни общей политики, ни следа аудита, учётные данные скопированы в десять конфигов агентов, а инструмент по имениshell.exec — в одном редиректе от вашего эндпоинта облачных метаданных.
Шлюз схлопывает это в одно управляемое подключение.
Одно подключение, каждый сервер
Агенты подключаются к единому эндпоинту. Шлюз агрегирует инструменты
каждого включённого, достижимого сервера под пространством имён
<server>.<tool>.Политика на каждом вызове
Каждый
tools/call вычисляется вашей политикой firewall перед
диспетчем.Зашифрованные учётные данные
Секреты аутентификации сервера шифруются в покое, маскируются при
чтении и внедряются при диспетче — они никогда не достигают модели или
клиента.
Egress под контролем
Эндпоинт зарегистрированного сервера валидируется по приватным
диапазонам и диапазонам облачных метаданных по умолчанию. Для
назначений на каждый инструмент примените базовый SSRF egress-denylist
или напишите собственные правила host/CIDR.
2. Четыре строительных блока
Управление MCP на OrcaRouter — это четыре кооперирующихся части. Выберите ту, что соответствует вопросу, на который вы пытаетесь ответить.MCP-шлюз
MCP-шлюз
Единый эндпоинт, к которому ваши агенты подключаются вместо того, чтобы
набирать серверы напрямую. Он агрегирует инструменты каждого
зарегистрированного сервера в пространстве имён
<server>.<tool> и
переэкспонирует входную схему каждого инструмента дословно. Начните с
Подключения MCP-сервера и
Аутентификации; полный справочник
живёт в Firewall: MCP-серверы.Вычисление на каждый вызов
Вычисление на каждый вызов
Шлюз прогоняет каждый
tools/call через firewall на поверхности
mcp и возвращает вердикт — allow, audit, deny, sanitize
или pending_approval — перед диспетчем. См.
Список разрешённых MCP-инструментов
и Очистка аргументов инструмента.Управление навыками
Управление навыками
Зашифрованные учётные данные
Зашифрованные учётные данные
Секрет аутентификации каждого сервера шифруется в покое и маскируется
при чтении. См. Аутентификацию и
Ротацию учётных данных.
3. Как вычисляется tools/call
Когда агент вызывает инструмент через шлюз, вызов не идёт прямо к серверу. Он сопоставляется с политикой вашего рабочего пространства, поверх применяется режим применения владеющего навыка, и только вердиктallow /
audit / sanitize достигает реального сервера.
| Вердикт | Что видит агент |
|---|---|
allow / audit | Переслано. audit также логирует событие. |
sanitize | Переслано с аргументами отредактированными (никогда результат). |
deny / pending_approval | Возвращено как ошибка инструмента, так что агент может адаптироваться, а не падать. |
4. Регистрация сервера (один конкретный пример)
Вы регистрируете каждый сервер один раз. Запись сервера несётname
(уникальный в рамках рабочего пространства, без .), endpoint,
auth_mode (none / bearer / oauth / basic) и его зашифрованные
учётные данные. Делайте это из консоли — запись требует Developer+.
ok / degraded / down):
github.*, точно зная, что
принимает github.create_issue. Сквозное руководство живёт в
Подключении MCP-сервера.
Секреты никогда не хранятся в открытом виде.
auth_json шифруется в
покое и маскируется при чтении; при обновлении верните маску обратно,
чтобы сохранить хранимое значение. См.
Ротацию учётных данных.5. Подключение агента к шлюзу
Когда серверы зарегистрированы, направьте любой MCP-клиент на шлюз с ключом области firewall-gateway (токен без этой области получает 403):<server>.<tool>.
SDK, который проксирует вызовы сам, может читать рантайм-реестр из
GET /api/v1/firewall/mcp_servers с тем же gateway-токеном.
6. Ограничьте, чего могут достичь инструменты
Вердикты на каждый вызов управляют тем, какой инструмент запускается; egress-контроли управляют тем, куда он может достичь. Кооперируют два слоя. Во-первых, когда шлюз подключается к эндпоинту зарегистрированного сервера, этот URL валидируется по приватным (RFC1918), loopback, link-local и cloud-metadata-диапазонам по умолчанию — а хост разрешается по DNS, так что имя, разрешающееся в заблокированный диапазон, тоже отвергается. Так что BYO-сервер, нацеленный на169.254.169.254 или
интранет-адрес, отвергается, если вы явно не внесли его в whitelist.
Во-вторых, для назначений на каждый инструмент egress-правило несёт
список allow/deny host/CIDR, сопоставляемый с исходящим назначением
вызова на поверхности egress. Шаблон базового use-case поставляет
готовое egress-deny-правило, чей список уже покрывает приватные, loopback,
link-local и cloud-metadata-диапазоны (включая 169.254.169.254 и
metadata.google.internal), так что его применение даёт вам защиту от
SSRF/метаданных без написания CIDR вручную.
7. Наблюдайте: события, прогоны и аномалии
Каждый управляемый вызов оставляет след. События firewall записывают вердикт, поверхность и сопоставленное правило; прогоны группируют вызовы сессии; а лента аномалий отмечает всплески частоты и стоимости против выученной базовой линии. Чтения настроек, политик и обнаруженных инструментов открыты любому Member; чтения событий/прогонов/агрегатов требуют Developer+.- Аудит MCP-событий — что логируется и как это читать.
- Чек-лист доверия — pre-flight перед тем, как выпустить агента на новый сервер.
8. Куда двигаться дальше
Подключение MCP-сервера
Зарегистрируйте, зондируйте и выставьте сервер через шлюз.
Список разрешённых MCP-инструментов
Default-deny для сервера и разрешите только проверенные инструменты.
Защита от rug-pull
Управляйте серверами и навыками, которые меняются после вашего
одобрения.
Firewall: MCP-серверы
Полный справочник по полям и маршрутам.
