Подключить курсор

Используйте Cursor с моделями, инструментами MCP и навыками через Unity Gateway. Настройте доступ к модели в настройках Cursor IDE. Используйте Unity Gateway CLI (ug) для добавления инструментов и навыков MCP или настройте их вручную.

Перед тем как начать

Вам нужен URL вашего рабочего пространства Azure Databricks и доступ к моделям, сервисам MCP и навыкам, которые вы хотите использовать. Установите Cursor. Чтобы использовать интеграцию ug с MCP, также установите Cursor Agent, который выполняет cursor-agent команду.

Если администратор уже настроил устройство, следуйте инструкциям организации по настройке.

Cursor IDE

1. Настройте базовый URL и ключ API

Открыть настройки > курсора > Настройки > курсора Модели > Ключи API.

Включите Override OpenAI Base URL и введите:

https://<workspace-hostname>/ai-gateway/cursor/v1

Замените <workspace-hostname> на имя узла рабочей области Azure Databricks. Вставьте ваш персональный токен доступа Azure Databricks в OpenAI API Key.

2. Добавить кастомные модели

Нажмите кнопку +Добавить настраиваемую модель в параметрах курсора. Введите полное название фундаментальной модели, доступной в вашем рабочем пространстве, затем включите её переключатель. Повторяйте это для каждой модели, которую хотите использовать.

Примеры названий моделей:

Provider Имя модели
OpenAI system.ai.gpt-5-5
Gemini system.ai.gemini-2-5-flash
Клод system.ai.claude-opus-4-6

Доступные модели зависят от вашего рабочего пространства и разрешений. Это соединение использует модели, предоставленные Azure Databricks.

3. Проверьте соединение

Откройте режим Ask сочетанием Cmd+L в macOS или Ctrl+L в Windows/Linux. Выберите модель и отправьте сообщение. Запросы, использующие эту пользовательскую модель, проходят через Unity Gateway.

Агент курсора в терминале

Используйте Unity Gateway CLI

Установите ug, затем выполните эту команду из вашей директории проекта:

ug cursor

Это открывает Cursor Agent в вашем терминале. Начните работать с теми же подсказками и командами, которые уже используете. Модели запускаются через ваш аккаунт Cursor; ug не настраивает маршрутизацию модели для Cursor Agent.

Добавить инструменты MCP

Используйте Unity Gateway CLI

После установки Cursor Agent выполните:

ug mcp add --agents cursor

Выберите сервисы, которые хотите добавить. ug регистрирует их в ~/.cursor/mcp.json, который используют IDE и агент терминала. Перезагрузите Cursor или сессию агента, затем попросите использовать подключённый инструмент.

Настройка MCP-сервисов вручную

Объединим эту запись в ~/.cursor/mcp.json:

{
  "mcpServers": {
    "dbsql": {
      "url": "https://<workspace-hostname>/ai-gateway/mcp-services/system.ai.dbsql",
      "headers": {
        "Authorization": "Bearer <databricks-pat>"
      }
    }
  }
}

Замените имя хоста и токен. Для другого сервиса используйте уникальное имя сервера и замените system.ai.dbsql его на трёхчастное имя Unity Catalog. Сохранить записи сервера, не связанные с этим.

Перезапусти курсор и попроси агента использовать инструмент. Для конфигурации OAuth см. документацию Cursor по MCP.

Добавление навыков

Используйте Unity Gateway CLI

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

ug skills add

Курсор считывает скачанные навыки из ~/.agents/skills/. Начните новую сессию, чтобы использовать их. Загрузки — это локальные снимки; повторите команду для получения обновлений.

Подключите реестр навыков вручную

Чтобы загрузить опубликованные навыки через MCP, объедините эту запись в ~/.cursor/mcp.json:

{
  "mcpServers": {
    "databricks-skill-registry": {
      "url": "https://<workspace-hostname>/ai-gateway/skills/",
      "headers": {
        "Authorization": "Bearer <databricks-pat>"
      }
    }
  }
}

Замените имя хоста и токен, сохранив конечный слеш в URL. Перезапусти курсор и попроси его использовать навык, например Use <catalog>.<schema>.<skill-name> to review this query.

Реестр предоставляет доступ к навыкам через MCP. Чтобы установить файлы навыков, которые у вас уже есть, поместите всю папку целиком, включая SKILL.md и связанные файлы, в ~/.agents/skills/ или в каталог .cursor/skills/ вашего проекта. См. документацию по навыкам Cursor.

Навыки Unity Gateway — в бета-версии. См. раздел «Управление навыками » для поддержки и разрешений.

Troubleshooting

ug cursor не могу найти Cursor Agent: Установите Cursor Agent и проверьте, есть ли cursor-agent он в вашем терминале.

Пользовательская модель не работает в IDE: Проверьте URL шлюза, срок действия токена, название модели и разрешения вашей модели. Выберите пользовательскую модель в разговоре.

Сбой подключения MCP или навыка: Проверьте URL-адрес, разрешения службы и ошибку коннектора. Для ручного подключения также проверьте истечение срока действия токенов. При ug проблемах с настройкой запустите ug doctor.

Отсутствует скачанный навык: Проверьте , содержит ли его папка SKILL.md и находится ли в поддерживаемой папке навыков. Загрузки на уровне пользователя распространяются на ваш локальный компьютер; они не доступны автоматически для облачных агентов.

Дальнейшие действия

  • Last updated on