AACSearch / руководство
MCP для ИИ-клиентов
Подключите ИИ-клиент к сгенерированному серверу инструментов AACSearch.
Что делает сервер
MCP-сервер предоставляет инструменты из публичного OpenAPI-контракта. Запросы используют ваш API-ключ, те же ограничения доступа и квоты. MCP не заменяет поисковый индекс и не обходит права.
Запуск из репозитория
Сгенерированный пакет приватный в этом репозитории; инструкция не предполагает опубликованный npm-пакет. При наличии исходников выполните в sdks/mcp:
npm ci
npm run buildВ ИИ-клиенте задайте локальную команду node и абсолютный путь к sdks/mcp/build/index.js в аргументе. Используйте транспорт stdio. Настройте переменные через хранилище секретов или окружение клиента:
{
"API_BASE_URL": "https://api.aacsearch.com/v1",
"API_KEY_API_KEY_HEADER": "YOUR_API_KEY"
}Поисковый ключ разрешает только операции поисковой области. Для административных операций нужен полный ключ. Осознанно подтверждайте запись в ИИ-клиенте и начните с тестовой организации. Не добавляйте реальные реквизиты в Git.
Проверка подключения
Подключите клиент, получите список инструментов и выполните разрешённую ключом операцию чтения. При ошибке входа проверьте базовый URL, область ключа и ограничения коллекций. При 429 изучите квоту и время повторения. См. ключи, ошибки и API.