# Обзор MCP

> Что такое MCP в Kodik, как агент вызывает инструменты и читает ресурсы с подключённых серверов, и как именуются инструменты.

Источник: https://docs.kodik.ru/mcp/overview

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

## Как Kodik использует MCP

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

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

Агент сам решает, когда вызывать инструмент, исходя из контекста разговора. По умолчанию он запрашивает ваше подтверждение перед каждым вызовом; вы можете настроить авто-одобрение глобально или для конкретных инструментов. Подробнее см. [Авто-одобрение](https://docs.kodik.ru/agent/auto-approve) и [Инструменты агента](https://docs.kodik.ru/agent/tools).

## Ключевые концепции

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

## Что можно делать с MCP серверами

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

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

## Начало работы

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

- **Быстрая установка из маркетплейса** — [MCP Легко и Просто](https://docs.kodik.ru/mcp/made-easy)
- **Добавить сервер с GitHub** — [Добавление MCP Серверов из GitHub](https://docs.kodik.ru/mcp/add-from-github)
- **Подключиться к удалённому серверу** — [Настройка MCP Серверов](https://docs.kodik.ru/mcp/configuring)
- **Написать конфигурацию вручную** — [Настройка MCP Серверов](https://docs.kodik.ru/mcp/configuring)

## Безопасность

MCP серверы могут выполнять произвольный код и отправлять сетевые запросы. Подключайте только те серверы, которым вы доверяете. Kodik хранит учётные данные в переменных среды и никогда не передаёт их модели напрямую. Каждый вызов инструмента требует подтверждения, если только вы явно не включили авто-одобрение. См. [Авто-одобрение](https://docs.kodik.ru/agent/auto-approve).

## Ресурсы

- [Официальные MCP серверы](https://github.com/modelcontextprotocol/servers)
- [Awesome MCP Servers](https://github.com/punkpeye/awesome-mcp-servers)
- [mcpservers.org](https://mcpservers.org/)
- [mcp.so](https://mcp.so/)
- [glama.ai/mcp/servers](https://glama.ai/mcp/servers)
- [PulseMCP](https://www.pulsemcp.com/)