Перейти к содержимому

Обзор MCP

Model Context Protocol (MCP) — это открытый стандарт, позволяющий Kodik подключаться к внешним серверам, которые предоставляют инструменты и ресурсы. Думайте об этом как о USB-C порте для AI-приложений: один стандартный интерфейс — множество устройств.

Когда вы подключаете MCP сервер, агент Kodik обнаруживает все инструменты и ресурсы, которые публикует этот сервер, и делает их доступными в ходе разговора.

  • Инструменты — это функции, которые агент может вызывать: получить страницу по URL, выполнить запрос к базе данных, запустить команду на удалённом сервере и т.д. Каждый инструмент идентифицируется в контексте агента как mcp__<имя-сервера>__<имя-инструмента>. Например, сервер с именем github, предоставляющий инструмент search_repos, отображается как mcp__github__search_repos.
  • Ресурсы — это потоки данных только для чтения (файлы, строки базы данных, показания датчиков и т.п.), которые агент может читать без отдельного вызова инструмента.

Агент сам решает, когда вызывать инструмент, исходя из контекста разговора. По умолчанию он запрашивает ваше подтверждение перед каждым вызовом; вы можете настроить авто-одобрение глобально или для конкретных инструментов. Подробнее см. Авто-одобрение и Инструменты агента.

Включённые MCP-инструменты доступны во всех режимах чата: Code, Plan, Ask, Debug и Educator. Режимы по-прежнему ограничивают встроенные инструменты Kodik для работы с проектом, но не вводят отдельный список разрешённых MCP-инструментов. Отключить MCP-инструмент только для одного режима можно его переключателем в Настройки → Harness, а сам инструмент или сервер — в Настройки → MCP Servers. MCP-серверы являются внешними возможностями, поэтому их инструменты могут иметь побочные эффекты даже в режиме, где встроенные инструменты доступны только для чтения.

Концепция Описание
MCP хост Клиент, подключающийся к серверам — в данном случае Kodik
MCP сервер Небольшая программа (локальный процесс или удалённый HTTP эндпоинт), предоставляющая инструменты и ресурсы
Инструмент Вызываемая функция; отображается агенту как mcp__<сервер>__<инструмент>
Ресурс Данные только для чтения, которые агент может получить с сервера
Транспорт Способ взаимодействия хоста с сервером (stdio, SSE или streamable HTTP)

MCP серверы могут оборачивать практически любую внешнюю систему:

  • Веб и API — поиск в интернете, публикации в социальных сетях, получение данных в реальном времени
  • Автоматизация браузера — управление реальным браузером для тестирования или парсинга
  • Базы данных — выполнение запросов, генерация отчётов, инспекция схем
  • Управление проектами — создание задач, синхронизация, чтение дорожных карт
  • Инструменты разработки — запуск линтеров, форматтеров, систем сборки или пользовательских скриптов

Kodik поставляется без предустановленных MCP серверов. Выберите подходящий путь:

MCP серверы могут выполнять произвольный код и отправлять сетевые запросы. Подключайте только те серверы, которым вы доверяете. Kodik хранит учётные данные в переменных среды и никогда не передаёт их модели напрямую. Каждый вызов инструмента требует подтверждения, если только вы явно не включили авто-одобрение. См. Авто-одобрение.