Подключение MCP-серверов

Просто спросите своего агента. Самый простой способ подключить MCP-серверы — сообщить агенту, что вам нужно:

• «Подключи MCP-сервер поиска Exa»
• «Добавь мой локальный файловый систем к этому workspace»
• «Настрой MCP-сервер SQLite для моей базы данных»

Агент автоматически обрабатывает конфигурацию и аутентификацию.

Это руководство показывает, как подключать MCP-серверы как источники, предоставляя агентам доступ к внешним инструментам и сервисам.

Схема конфигурации источника

MCP-серверы настраиваются с помощью стандартизированной конфигурации источника:

{
  "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"
  }
}

Удалённые серверы (HTTP/SSE)

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

{
  "type": "mcp",
  "name": "Exa Search",
  "tagline": "Neural search and content extraction",
  "icon": "https://exa.ai/favicon.ico",
  "mcp": {
    "transport": "http",
    "url": "https://mcp.exa.ai",
    "authType": "bearer"
  }
}

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

Локальные серверы (Stdio)

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

{
  "type": "mcp",
  "name": "Local MCP",
  "tagline": "MCP Description",
  "mcp": {
    "transport": "stdio",
    "command": "npx",
    "args": ["-y", "@package/name", "/Users/me/projects"]
  }
}

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

Пакеты NPX:

{
  "type": "mcp",
  "name": "SQLite",
  "tagline": "Query SQLite databases",
  "mcp": {
    "transport": "stdio",
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-sqlite", "/path/to/database.db"]
  }
}

Скрипты Node.js:

{
  "type": "mcp",
  "name": "Custom Server",
  "tagline": "Custom MCP server",
  "mcp": {
    "transport": "stdio",
    "command": "node",
    "args": ["/path/to/my-mcp-server.js"]
  }
}

Скрипты Python:

{
  "type": "mcp",
  "name": "Python MCP",
  "tagline": "Python-based MCP server",
  "mcp": {
    "transport": "stdio",
    "command": "python",
    "args": ["/path/to/mcp_server.py"]
  }
}

Исполняемые файлы:

{
  "type": "mcp",
  "name": "Binary Servers",
  "tagline": "Compiled MCP server",
  "mcp": {
    "transport": "stdio",
    "command": "/usr/local/bin/my-mcp-server"
  }
}

Несколько серверов

Вы можете настроить несколько MCP-источников в своём workspace. Каждый источник становится доступным с инструментами, префикс которых — имя источника:

Using exa_search to find articles...
Using github_list_issues to get open issues...

Обнаружение серверов

При подключении MCP-источника AIKraft Agents:

1. Подключается к серверу с использованием настроенного транспорта
2. Запрашивает доступные инструменты с сервера
3. Делает инструменты доступными с префиксированными именами (например, exa_search, github_list_repos)

Просмотр подключённых инструментов:

> /tools -v

Обновление подключений

Если инструменты сервера изменятся или вам нужно переподключиться:

> /source reload <source-name>

Это повторно устанавливает соединение MCP и обновляет доступные инструменты.

Устранение неполадок

Сервер не подключается

• Проверьте, что URL указан правильно и доступен (для транспорта HTTP)
• Проверьте, что команда существует и находится в PATH (для транспорта stdio)
• Проверьте, требует ли сервер аутентификации
• Убедитесь, что ваша сеть разрешает подключение
• Попробуйте открыть URL напрямую в браузере (для HTTP)

Инструменты не отображаются

• Нажмите на источник в боковой панели, чтобы просмотреть его статус
• Перезапустите AIKraft Agents для перезагрузки подключений
• Проверьте, что синтаксис конфигурации указан правильно
• Проверьте логи сервера на наличие ошибок

Ошибки аутентификации

• Подтвердите, что ваш API-ключ или токен указан правильно
• Проверьте, что ключ имеет необходимые разрешения
• Некоторые серверы требуют определённых областей действия — проверьте их документацию
• Убедитесь, что authType соответствует ожиданиям сервера

Локальный сервер не запускается

• Проверьте, что команда существует: which npx или which node
• Проверьте, что аргументы указаны правильно
• Попробуйте запустить команду вручную в терминале, чтобы увидеть ошибки
• Убедитесь, что необходимые зависимости установлены

Рекомендации

Используйте понятные имена

Выбирайте имена источников, которые описывают их назначение: web-search, github-repo, company-wiki вместо server1, server2.

Добавляйте поясняющие тэглайны

Включайте тэглайн, объясняющий, что делает сервер — это помогает при просмотре доступных источников.

Добавляйте иконки при наличии

Устанавливайте icon, чтобы источники были визуально идентифицируемы в интерфейсе. Вы можете использовать URL, эмодзи или разместить файл icon.svg или icon.png в папке источника.

Ограничивайте количество источников на workspace

Подключайте только те источники, которые необходимы вашему workspace. Слишком много инструментов может увеличить задержку ответа и запутать модель в выборе.

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

Настройка аутентификации

Узнайте о OAuth, bearer-токенах и публичной аутентификации для MCP-серверов.