Подключение AI-агентов через MCP

Как создать MCP-токен и подключить внешний AI-клиент к OK, Bob!

С помощью вкладки MCP в настройках можно подключить внешний AI-клиент или AI-агента к вашему рабочему пространству в OK, Bob!.

Через MCP клиент получает доступ к данным и действиям в вашем аккаунте по защищённому токену.

Вкладка MCP доступна в веб-интерфейсе OK Bob! в настройках аккаунта.

Где находится MCP

Откройте настройки аккаунта и перейдите во вкладку MCP.

Во вкладке есть три основных блока:

  • Endpoint — адрес, к которому должен подключаться MCP-клиент.
  • Шаблон подключения — готовый JSON-пример для конфигурации клиента.
  • Токены доступа — список персональных токенов для AI-клиентов.
Вкладка MCP в настройках
Вкладка MCP в настройках

Как создать токен

  1. Откройте вкладку MCP.
  2. В блоке Токены доступа введите название токена.
  3. Нажмите «Создать MCP-токен».

Название нужно только для вашего удобства. Например, можно создать отдельные токены для Codex, Claude Desktop, Cursor или другого клиента.

Полный текст токена показывается только один раз сразу после создания. Сохраните его сразу в конфигурации вашего клиента или в безопасном менеджере секретов.

Как подключить MCP-клиент

Для подключения используйте:

  • Endpoint: https://api.okbob.app/api/mcp
  • Авторизация: Bearer <ваш токен>
  • Тип транспорта: streamable-http

Пример конфигурации:

{
  "mcpServers": {
    "okbob": {
      "command": "",
      "url": "https://api.okbob.app/api/mcp",
      "type": "streamable-http",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

В самой вкладке MCP этот шаблон уже доступен в готовом виде, его можно скопировать кнопкой «Копировать».

Как читать список токенов

Для каждого токена показываются:

  • название токена;
  • сокращённый вид токена;
  • дата создания;
  • дата и время последнего использования.

Если токен ещё не использовался, в списке будет показано сообщение «ещё не использовался».

Как отозвать токен

Если токен больше не нужен или вы хотите заменить его новым, нажмите «Удалить» рядом с нужным токеном и подтвердите действие в модальном окне.

После удаления этот токен перестанет работать во всех MCP-клиентах, где он был настроен.

Подтверждение удаления MCP-токена
Подтверждение удаления MCP-токена

Когда стоит выпустить новый токен

Новый токен стоит создать, если:

  • вы подключаете нового AI-агента;
  • хотите разделить доступ между разными клиентами;
  • подозреваете, что старый токен мог быть скомпрометирован;
  • хотите отключить старый клиент без влияния на остальные подключения.

Практически удобнее выпускать отдельный токен на каждый MCP-клиент.