Главная/Документация/Источники данных/Обзор MCP-серверов
Источники данных

Обзор MCP-серверов

Подключайте агентов AIKraft Agents к сервисам через MCP — GitHub, базы данных, поисковики и другие инструменты. Руководство охватывает конфигурацию, типы транспортов и безопасность.

Подключайте агентов AIKraft Agents к сервисам, которые вы используете каждый день — GitHub, поисковые системы, базы данных, внутренние инструменты и многие другие. MCP (Model Context Protocol) — это стандарт, который делает это возможным, и многие сервисы уже предоставляют поддержку MCP из коробки.

Что можно подключить?

Когда вы подключаете MCP-сервер к источнику, ваш агент получает доступ к возможностям этого сервиса. Подключите GitHub — агент сможет проверять статус PR, сводить задачи и автоматически обновлять ваши документы Craft. Подключите базу данных — он сможет запрашивать данные напрямую. Подключите Slack — он сможет публиковать обновления для вашей команды.

Каждое подключение добавляет новые инструменты, которые агент может использовать естественно в диалоге — без написания кода.

Почему использовать MCP-серверы?

  • Подключите ваш стек — GitHub, Slack, базы данных, поисковые системы, внутренние инструменты: если сервис поддерживает MCP, ваш агент может им пользоваться.
  • Создавайте реальные рабочие процессы — объединяйте сервисы: извлекайте данные из одного, обрабатывайте их и отправляйте в другой.
  • Стандартизировано и безопасно — MCP обеспечивает согласованные шаблоны интеграции с scoped-учётными данными для каждого источника.
  • Растущая экосистема — новые сервисы регулярно добавляют поддержку MCP. Проверьте реестр MCP-серверов.

Конфигурация источника

MCP-серверы настраиваются как источники с определённой схемой:

terminaljson
{
  "type": "mcp",
  "name": "Server Name",
  "tagline": "Description of the server",
  "icon": "https://example.com/icon.png",
  "mcp": {
    "transport": "http",
    "url": "https://mcp-server.example.com",
    "authType": "oauth"
  }
}

Поля конфигурации

Поле Обязательно Описание
type Да Должно быть "mcp" для MCP-серверов
name Да Отображаемое имя сервера
tagline Нет Краткое описание назначения сервера
icon Нет URL-адрес иконки, эмодзи или локальный файл (авто-обнаружение: icon.svg, icon.png)
mcp.transport Нет Тип транспорта: "http" (по умолчанию), "sse" или "stdio" для локальных серверов
mcp.url Да (HTTP/SSE) Полный URL-адрес конечной точки MCP-сервера (для транспорта HTTP/SSE)
mcp.command Да (stdio) Команда для запуска локального сервера (для транспорта stdio)
mcp.args Нет (stdio) Аргументы для команды (для транспорта stdio)
mcp.authType Да (HTTP/SSE) Тип аутентификации: "oauth", "bearer" или "none". Не требуется для stdio.

Типы транспортов

Транспорт HTTP/SSE (удалённые серверы)

Для удалённых MCP-серверов, доступных по сети:

terminaljson
{
  "type": "mcp",
  "name": "Exa Search",
  "tagline": "Neural search for the web",
  "icon": "https://exa.ai/icon.png",
  "mcp": {
    "transport": "http",
    "url": "https://mcp.exa.ai/mcp",
    "authType": "bearer"
  }
}

Транспорт HTTP автоматически поддерживает как протоколы Streamable HTTP, так и Server-Sent Events (SSE).

Транспорт stdio (локальные серверы)

Для локальных MCP-серверов, которые работают как процессы на вашей машине:

terminaljson
{
  "type": "mcp",
  "name": "MCP Name",
  "tagline": "MCP Description",
  "mcp": {
    "transport": "stdio",
    "command": "npx",
    "args": ["-y", "@package/name", "/path/to/directory"]
  }
}

Распространённые шаблоны локальных серверов:

Шаблон Пример команды
npx package "command": "npx", "args": ["-y", "package-name"]
Node script "command": "node", "args": ["/path/to/server.js"]
Python script "command": "python", "args": ["/path/to/server.py"]
Binary "command": "/usr/local/bin/mcp-server"

Поиск MCP-серверов

Многие сервисы предоставляют MCP-серверы. Вот несколько мест, где их можно найти:

  • Реестр MCP-серверов — официальный список доступных серверов
  • Документация сервиса — многие API уже предлагают MCP-конечные точки
  • Самостоятельный хостинг — запустите собственные MCP-серверы для внутренних инструментов

Нужен Google, Microsoft или Slack? AIKraft Agents имеет встроенную поддержку OAuth для этих сервисов. Просто попросите вашего агента «подключить Google Calendar» или «добавить Slack» — он проведёт вас через процесс OAuth без необходимости внешних агрегаторов.

Соображения безопасности

При подключении MCP-серверов к вашим источникам:

  • Источники и учётные данные scoped — каждый workspace имеет собственные источники и сохранённые учётные данные. Источники не разделяются между workspace, если не настроено иное.
  • Учётные данные шифруются — хранятся безопасно в ~/.craft-agent/credentials.enc

Дальнейшие шаги

Подключить сервер — пошаговое руководство по добавлению MCP-серверов как источников.

Аутентификация — настройка OAuth, bearer-токенов и API-ключей.

Нужен такой агент в вашей компании?

Устанавливаем под ключ: настройка на компьютерах сотрудников, единый аккаунт, интеграция с 1С и внутренними системами, обучение команды. Подробнее о внедрении →