Кто я и где мы

О чём поговорим?

1. 01Агент и MCP за пять минут
2. 02Стартап против инфраструктуры
3. 03Deckhouse и первый MCP-сервер
4. 04spec-first и protoc-gen-mcp
5. 05Сценарии и живое демо

О чём поговорим?

• 01Агент и MCP за пять минут
• 02Стартап против инфраструктуры
• 03Deckhouse и первый MCP-сервер
• 04spec-first и protoc-gen-mcp
• 05Сценарии и живое демо

LLM умна, но безрука

• Модель отлично рассуждает
• Но сама по себе ничего не делает в реальном мире
• → чтобы действовать, ей нужны руки

Анатомия агента

MCP = USB-C для интеграций

• Один протокол вместо зоопарка кастомных коннекторов
• Агент видит и вызывает внешние действия через один стандарт
• MCP-сервер = руки агента

Три примитива

Как агент вызывает tool

→ description и JSON Schema решают, сможет ли агент вообще вызвать tool

О чём поговорим?

• 01Агент и MCP за пять минут
• 02Стартап против инфраструктуры
• 03Deckhouse и первый MCP-сервер
• 04spec-first и protoc-gen-mcp
• 05Сценарии и живое демо

Наша задача

• Нужно управлять Kubernetes-кластером
• Инфраструктурной экспертизы нет
• Денег на DevOps-команду — тоже нет

Вилка ресурсов

Единственная разумная ставка

Не нанимать DevOps, а переложить управление кластером на агента.

Попытка №1: голый k8s-MCP

→ выглядит просто... но только на первый взгляд

Почему не взлетело

• Чтобы управлять k8s-MCP, надо самому знать k8s
• CRD, RBAC, манифесты, неймспейсы
• → инструмент переложил сложность на нас, а не убрал её ❌

О чём поговорим?

• 01Агент и MCP за пять минут
• 02Стартап против инфраструктуры
• 03Deckhouse и первый MCP-сервер
• 04spec-first и protoc-gen-mcp
• 05Сценарии и живое демо

Услышали про Deckhouse

• Готовая Kubernetes-платформа
• Берёт много инфраструктурной рутины на себя
• «А почему бы и нет?» — взяли, потестили

Вердикт

Новая идея

Deckhouse держит платформу, агент разговаривает с ней за нас.

→ нужен мост: MCP-сервер для Deckhouse

Пишем MCP-сервер с агентом

• Сели писать MCP-сервер для Deckhouse
• Агент помогает кодить
• Иии?

Барьер не там, где ждали

Не инфраструктура, а инженерия: агенту не хватало структуры.

Симптом

Диагноз

• Нужен источник истины, который агент не имеет права трогать
• Код для этого — плохое место

О чём поговорим?

• 01Агент и MCP за пять минут
• 02Стартап против инфраструктуры
• 03Deckhouse и первый MCP-сервер
• 04spec-first и protoc-gen-mcp
• 05Сценарии и живое демо

Идём за spec-first

Хотим: спека как контракт, который агент не может сломать.

Нашли два варианта

Делаем свой

• Мы проектируем спецификацию (proto-контракт аннотаций)
• Генератор пишет агент

protoc-gen-mcp

• protobuf — единственный источник истины
• Аннотации в .proto описывают tools / prompts / resources
• Генератор → типизированные MCP-биндинги + JSON Schema

Аннотации в .proto

service DiagnosticsAPI {
  option (mcp.options.v1.service) = { namespace: "deckhouse" };

  // Агрегированный статус кластера: ноды, модули, релизы.
  rpc GetClusterStatus(google.protobuf.Empty)
      returns (GetClusterStatusResponse) {
    option (mcp.options.v1.method) = {
      annotations: { read_only_hint: true }
    };
  }
}

→ read_only_hint, валидация и description — всё в контракте

Почему это лечит «структуру»

• Контракт живёт в .proto, а не в редактируемом коде
• → случайной правкой структуру не разнести

Сгенерированный интерфейс

// Сгенерированный интерфейс — агент его не трогает.
type DiagnosticsAPIToolHandler interface {
    GetClusterStatus(ctx context.Context,
        req *emptypb.Empty) (*GetClusterStatusResponse, error)
    ListNodes(ctx context.Context,
        req *ListNodesRequest) (*ListNodesResponse, error)
    // ...
}

Генерация через easyp

generate:
  inputs:
    - directory: { path: proto, root: "." }
  plugins:
    - name: go
      out: .
      opts: { paths: source_relative }
    - command: ["go", "run",
        "github.com/easyp-tech/protoc-gen-mcp/cmd/protoc-gen-mcp@latest"]
      out: .
      opts: { paths: source_relative }

→ task generate = easyp mod download + easyp generate

Бизнес-логика — в хендлере

server := mcp.NewServer("deckhouse-mcp", "v1")
deckhousev1.RegisterDiagnosticsAPITools(server, handler)
server.ServeSSE(":8080")

О чём поговорим?

• 01Агент и MCP за пять минут
• 02Стартап против инфраструктуры
• 03Deckhouse и первый MCP-сервер
• 04spec-first и protoc-gen-mcp
• 05Сценарии и живое демо

Сценарий A — диагностика

Сценарий C — HTTPS Ingress + TLS

Что важно заметить

5 тезисов

1. Агенту нужны руки
2. MCP — это руки
3. Готовая платформа (Deckhouse) бьёт самописную интеграцию
4. Агент без структуры разносит код
5. spec-first (protoc-gen-mcp) = контракт, который агент не сломает

Когда этот путь оправдан

Куда движемся