Быстрый старт: подключение ИИ-агента к Альбато MCP

Эта статья объясняет, как подключить вашего ИИ-агента к Альбато MCP: единому вайт-лейбл MCP-серверу, через который агент выполняет действия в 1 000+ приложениях по одному подключению. Что это такое и когда его использовать — в статье Что такое Альбато MCP.

1. Что вам понадобится

Токен Альбато — токен сессии пользователя, который ваша платформа получает через Embedded API Альбато с помощью вашего мастер-токена.
Адрес MCP-сервера и секретный ключ регистрации — их предоставляет ваш менеджер Альбато.

Токен Альбато — не статичный ключ, который выдают один раз, а токен сессии пользователя, который ваша платформа запрашивает у Embedded API Альбато по требованию, авторизуясь мастер-токеном. Если у вас ещё нет мастер-токена, адреса MCP-сервера или секретного ключа регистрации, обратитесь к менеджеру Альбато: всё это настраивается на стороне Альбато.

2. Получите виртуальный ключ

Выполните запрос, подставив свои значения от менеджера Альбато и собственный токен Альбато:

curl -s -X POST <MCP_SERVER_URL>/auth/register \
  -H "Authorization: Bearer YOUR_REGISTRATION_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"albatoToken": "YOUR_ALBATO_TOKEN", "label": "my-agent"}'

В ответ вы получите виртуальный ключ:

{
  "virtualKey": "mcp_vk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "contractId": "client-id",
  "albatoUserId": 136027,
  "albatoEmail": "user@example.com",
  "albatoName": "Jane Doe",
  "createdAt": "2026-07-24T10:05:00.000Z"
}

Сохраните значение virtualKey — это персональный ключ доступа к MCP-серверу.

Поля albatoUserId, albatoEmail и albatoName определяют аккаунт Альбато, стоящий за переданным токеном — они заполняются автоматически, без дополнительного ввода. Подробнее об управлении ключами в масштабе читайте в статье Виртуальные ключи.

3. Подключите ИИ-агента

Используйте следующие настройки в вашем MCP-клиенте (Claude Desktop, Cursor или любом MCP-совместимом агенте):

Параметр	Значение
Транспорт	Streamable HTTP
URL	`<MCP_SERVER_URL>/mcp`
Заголовок авторизации	`Authorization: Bearer mcp_vk_...`

Claude Desktop — добавьте в claude_desktop_config.json

{
  "mcpServers": {
    "albato": {
      "type": "http",
      "url": "<MCP_SERVER_URL>/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_VIRTUAL_KEY"
      }
    }
  }
}

Cursor — добавьте в настройки MCP

{
  "albato": {
    "url": "<MCP_SERVER_URL>/mcp",
    "headers": {
      "Authorization": "Bearer YOUR_VIRTUAL_KEY"
    }
  }
}

4. Проверьте подключение

Выполните быструю проверку работоспособности:

curl -s <MCP_SERVER_URL>/health

Ожидаемый ответ: {"result":{"ok":true,...}}

Затем убедитесь, что сервер видит ваш токен:

curl -s -X POST <MCP_SERVER_URL>/mcp \
  -H "Authorization: Bearer YOUR_VIRTUAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

В ответ вы должны получить список доступных инструментов. Подключение готово к работе.

Что умеет ваш агент

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

Ротация и отзыв ключа

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