Обзор источников данных

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

• «Подключи мой аккаунт GitHub»
• «Добавь Slack в этот workspace»
• «Настрой доступ к моему хранилищу Obsidian»

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

Что такое источники данных?

Источник данных — это любое внешнее подключение к данным, которым может пользоваться ваш агент:

• MCP-серверы — стандартизированные интеграции ИИ-инструментов
• REST API — любой сервис с HTTP-эндпоинтами
• Локальные папки — закладки на папки вашего компьютера

Каждый источник предоставляет агенту инструменты, которые он может вызывать во время диалогов. Когда вы просите агента «проверить мои задачи в GitHub» или «поискать в интернете», он использует источники данных за кулисами. Все типы источников — MCP-серверы, API и локальные папки — работают с каждым настроенным LLM-провайдером, включая Anthropic, OpenAI/Codex, Google Gemini, GitHub Copilot и пользовательские эндпоинты.

Типы источников данных

MCP-серверы

Model Context Protocol серверы предоставляют богатые, готовые к использованию интеграции инструментов. Многие сервисы предлагают официальную поддержку MCP.

Примеры: Linear, GitHub, Brave Search

REST API

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

Примеры: Exa Search, пользовательские бэкенды

Локальные папки

Закладывайте папки на вашем компьютере с документацией и быстрым доступом.

Примеры: Заметки, загрузки, справочные директории

Как работают источники данных

Каждый источник находится в папке по пути:

~/.craft-agent/workspaces/{workspace-id}/sources/{source-slug}/

Папка источника содержит:

• config.json — настройки подключения, тип аутентификации, статус (обязательно)
• guide.md — инструкции для агента по использованию этого источника (необязательно)
• permissions.json — пользовательские правила для режима Изучения (необязательно)
• icon.* — визуальная иконка источника (необязательно)

config.json

Файл конфигурации определяет, как подключиться к источнику:

{
  "type": "mcp",
  "name": "Linear",
  "slug": "linear",
  "enabled": true,
  "provider": "linear",
  "mcp": {
    "url": "https://mcp.linear.app",
    "authType": "oauth"
  },
  "isAuthenticated": true,
  "connectionStatus": "connected"
}

Ключевые поля:

• type — тип источника: mcp, api или local
• enabled — активен ли источник
• provider — идентификатор сервиса (например, "linear", "github", "custom")
• isAuthenticated — сохранены ли учётные данные
• connectionStatus — текущее состояние: connected, needs_auth, failed, untested или local_disabled

icon.\*

Поместите файл иконки в папку источника (icon.svg, icon.png) для пользовательского брендинга. Иконки автоматически обнаруживаются — никакой дополнительной конфигурации не требуется.

Как работают иконки:

Рекомендация: При создании источников задавайте icon в виде URL, затем запустите проверку. Иконка будет загружена и кэширована локально для быстрого отображения в офлайне.

guide.md

Файл guide помогает агенту понять, как эффективно использовать источник:

# Linear

Отслеживание задач и проектов для команды iOS.

## Объём

Доступ к проекту "Craft iOS" и связанным задачам.

## Руководство

- Ищите задачи перед созданием дубликатов
- Используйте метки согласованно с командными стандартами
- Проверяйте назначения спринтов перед перемещением задач

Хорошо написанный guide.md делает вашего агента значительно эффективнее. Включайте конкретные названия проектов, командные стандарты и типичные рабочие процессы.

Активация и деактивация

Источники можно включать и выключать, не удаляя их:

1. В интерфейсе: Переключите источник в настройках workspace
2. В config.json: Установите "enabled": false

Отключённые источники остаются настроенными, но недоступны агенту во время диалогов.

Жизненный цикл источника

1. Настройка — создание папки источника и config.json
2. Аутентификация — сохранение учётных данных (OAuth, API-ключ и т.д.)
3. Тестирование — проверка подключения
4. Активное использование — источник доступен в диалогах
5. Деактивация — отключение при отсутствии необходимости

Разрешения в режиме Изучения

По умолчанию источники работают в режиме Изучения с доступом только для чтения. Создайте permissions.json, чтобы определить безопасные операции:

{
  "allowedMcpPatterns": [
    { "pattern": "list", "comment": "Все операции списка" },
    { "pattern": "get", "comment": "Все операции чтения" },
    { "pattern": "search", "comment": "Все операции поиска" }
  ]
}

Паттерны автоматически ограничены источником, поэтому list внутренне становится mcp__linear__.*list.

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

MCP-серверы

Подключитесь к сервисам с поддержкой MCP

REST API

Подключитесь к любому сервису с API

Локальные папки

Закладывайте папки на вашем компьютере

Аутентификация

Настройте безопасные учётные данные