Vertice AI

официальный

Общайтесь со своими контрактами, поставщиками и расходами на SaaS

Смотреть на vertice.oneПопробовать этот MCPСпонсировано

Что можно делать с Vertice AI MCP?

  • Запросы по срокам действия контрактов — Узнайте, какие контракты в вашем портфеле истекают в заданный период, например, в ближайшие 90 дней.
  • Анализ расходов и поставщиков — Запросите общую годовую сумму расходов по каждому поставщику и другим поставщикам в той же категории.
  • Просмотр документов контракта — Попросите найти последний подписанный контракт для поставщика и обобщить условия продления.
  • Создание запроса на закупку — Попросите открыть новый запрос на закупку, например, на дополнительные лицензии продукта.
  • Обнаружение инструментов — Попросите вашего ассистента перечислить доступные инструменты Vertice через метод MCP tools/list.

Документация

Коннектор Vertice AI MCP в настоящее время находится в предварительной версии. Набор клиентов с доступом ограничен, и доступ предоставляется по запросу через вашего менеджера по работе с клиентами Vertice.

1. Что такое коннектор Vertice AI MCP?

Коннектор Vertice AI MCP — это размещенная конечная точка, которая позволяет совместимому внешнему ИИ-ассистенту, например Claude, запрашивать ваше рабочее пространство закупок Vertice и запускать рабочие процессы Vertice от вашего имени с использованием естественного языка. Он реализует открытый протокол Model Context Protocol (MCP) поверх существующей платформы Vertice.

Коннектор является дополнительным каналом доступа к Vertice. Он предоставляет те же данные о закупках и рабочие процессы, которые вы уже можете использовать через веб-приложение Vertice, с теми же элементами управления доступом на основе ролей.

Подключение ИИ-ассистента не предоставляет доступа к тому, что вы не могли бы увидеть в Vertice самостоятельно.

В этом документе мы используем Claude в качестве рабочего примера. Тот же коннектор работает с любым совместимым с MCP ИИ-ассистентом, который поддерживает транспорт MCP Streamable HTTP и OAuth 2.1 с PKCE (S256).

2. Примеры использования

Коннектор предназначен для вопросов и рабочих процессов, связанных с закупками. Ниже приведены примеры вопросов, которые вы можете задать. Каждый из них соответствует одному из инструментов, перечисленных в разделе 4.

  • "Какие контракты в нашем портфеле истекают в ближайшие 90 дней?"
  • "Какова наша общая годовая сумма расходов с этим поставщиком, и какие другие поставщики находятся в той же категории?"
  • "Найдите последний подписанный контракт с этим поставщиком и обобщите условия продления."
  • "Откройте новую заявку на закупку дополнительных 25 мест для продукта этого поставщика."

Это примеры. Точный набор инструментов, параметров и поведение определяется оркестрационным слоем Vertice на момент запроса.

3. Совместимость и предварительные требования

ТребованиеДетали
Активная подписка VerticeВы должны быть пользователем активного тенанта Vertice.
Учетная запись пользователя VerticeУчетная запись пользователя в хорошем состоянии, с разрешением на использование функций Vertice AI.
АутентификацияКоннектор аутентифицирует вас через существующую настройку аутентификации Vertice вашего тенанта. Если ваш тенант использует единый вход (SSO) через поставщика удостоверений SAML 2.0, вы входите с обычными корпоративными учетными данными. Если ваш тенант использует собственную аутентификацию Vertice, вы входите с именем пользователя и паролем Vertice.
Подписка на ИИ-ассистентаПодписка у выбранного вами поставщика ИИ-ассистента, которая поддерживает добавление пользовательских коннекторов. Для Claude.ai в настоящее время требуется план Team или Enterprise; пожалуйста, обратитесь к документации Anthropic для получения самой актуальной информации о доступности планов.

Сам коннектор является размещенным сервисом. Никакое программное обеспечение не устанавливается в вашей инфраструктуре. Личные ключи API не выдаются.

4. Категории инструментов

Коннектор предоставляет инструменты в следующих категориях, связанных с закупками. Каждый инструмент объявляет явные аннотации MCP readOnlyHint и destructiveHint, чтобы совместимые ИИ-ассистенты могли предупредить пользователя перед вызовом операций записи.

КатегорияТолько чтениеВыполняет запись
Аналитика контрактов✔
Аналитика расходов✔
Информация о поставщиках✔
Поиск документов✔
Статус соответствия✔
Создание заявки на закупку✔ (аддитивный — создает только новые сущности)
Обновление метаданных контракта✔ (контролируемая мутация)

Авторитетный список инструментов можно обнаружить непосредственно в вашем ИИ-ассистенте — ассистент вызывает стандартный метод MCP tools/list для коннектора и отображает вам названия, описания и аннотации.

Точный набор инструментов может меняться. Аннотации на каждом инструменте будут по-прежнему указывать, читает ли он или записывает.

5. Подключение вашего ИИ-ассистента

Каждый тенант Vertice имеет свой собственный URL коннектора вида:

https://ai.vertice.one/accounts//mcp

Замените <your-account-id> на идентификатор вашего тенанта. Если вы не знаете идентификатор вашего тенанта, обратитесь в службу поддержки Vertice.

Добавление коннектора в Claude.ai

  1. Откройте Claude.ai
  2. Перейдите в Настройки → Коннекторы → Добавить пользовательский коннектор
  3. Введите имя (например, 'Vertice')
  4. Вставьте URL коннектора из приведенного выше
  5. Нажмите Добавить
  6. Claude открывает окно авторизации. Вы будете перенаправлены к поставщику аутентификации вашего тенанта (корпоративный единый вход, если ваш тенант использует SSO, или собственный вход Vertice в противном случае).
  7. Войдите с использованием существующих учетных данных. Новый пароль не создается. Личный ключ API не выдается.
  8. Claude подтверждает, что коннектор подключен.

Теперь вы можете задавать Claude вопросы, связанные с закупками, о ваших данных Vertice в любом разговоре.

Предварительно заполненная ссылка для установки

Для удобства тот же процесс можно запустить, перейдя по этой ссылке:

https://app.vertice.one/preferences/user/integrations

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

Аутентификация использует OAuth 2.1 с PKCE (S256). Процесс выглядит следующим образом:

  1. Ваш ИИ-ассистент получает метаданные защищенного ресурса RFC 9728 коннектора, чтобы обнаружить сервер авторизации.
  2. ИИ-ассистент получает метаданные сервера авторизации RFC 8414, чтобы обнаружить конечные точки OAuth.
  3. ИИ-ассистент инициирует поток кода авторизации OAuth 2.1 с PKCE.
  4. Переадресатор /authorize Vertice направляет вас напрямую к поставщику аутентификации вашего тенанта. Если ваш тенант использует SSO через SAML, Vertice направляет вас прямо к настроенному поставщику удостоверений SAML без промежуточного шага выбора Vertice. Если ваш тенант использует собственную аутентификацию Vertice, вы видите форму входа Vertice.
  5. После успешного входа слой идентификации Vertice выдает кратковременный токен доступа, привязанный к вашему пользователю, вашему тенанту и области ресурса коннектора.
  6. ИИ-ассистент предъявляет этот токен доступа как учетные данные Bearer в каждом запросе MCP к Vertice.

Токены истекают автоматически. Вы можете отключить коннектор в любое время в настройках вашего ИИ-ассистента; это не влияет на вашу учетную запись Vertice.

7. Разрешения

Коннектор применяет ваши существующие элементы управления доступом на основе ролей Vertice. Данные, к которым вы можете получить доступ через коннектор, точно такие же, как и через веб-приложение Vertice, не более.

Одна и та же модель управления доступом используется во всех поверхностях Vertice — веб-приложении, интеграциях Vertice для Slack и Microsoft Teams, а также коннекторе Vertice AI MCP. Каждое действие, изменяющее данные, независимо от того, какая поверхность его инициировала, фиксируется в существующем журнале аудита Vertice.

8. Лимиты запросов

Для сохранения качества обслуживания коннектор применяет лимиты запросов на уровне приложения:

ОбластьЛимит
На одного аутентифицированного пользователя60 запросов в минуту
На тенант Vertice (для всех пользователей учетной записи)300 запросов в минуту

Когда лимит достигнут, коннектор возвращает ошибку JSON-RPC с кодом -32004, сопоставленную с HTTP 429 Too Many Requests со следующими заголовками:

Retry-After: X-RateLimit-Limit: X-RateLimit-Remaining: 0 X-RateLimit-Reset:

Корректно работающие ИИ-ассистенты соблюдают Retry-After. При обычном интерактивном использовании вы не должны достигать этих лимитов. Они существуют в первую очередь для защиты от неконтролируемой автоматизации. Если легитимная рабочая нагрузка вашего тенанта требует более высоких порогов, обратитесь к вашему менеджеру по работе с клиентами Vertice.

Как Claude.ai отображает ответы о лимитах запросов

Когда во время разговора с Claude достигается лимит запросов, клиент Claude.ai может отобразить ответ конечному пользователю как общее сообщение об ошибке инструмента, а не как явное сообщение о лимите запросов. Ответ на уровне протокола соответствует спецификации; текст, отображаемый пользователю, определяется ИИ-ассистентом, а не Vertice. Если вы столкнулись с такой ошибкой, подождите несколько секунд перед повторной попыткой.

9. Размер ответа инструмента

Коннектор ориентируется на ограничение ответа в 25 000 токенов, определенное в руководстве Anthropic Connectors Directory. Чтобы результаты оставались полезными для очень больших запросов, применяется усечение безопасности примерно на 20 000 токенов; если оно срабатывает, ответ включает явный нижний колонтитул, указывающий, что усечение произошло и как сузить запрос. При обычном использовании базовая оркестрация Vertice предназначена для разбиения больших операций списка на страницы, и вы не должны видеть нижний колонтитул усечения.

10. Обработка данных

Описание более широкой позиции Vertice в области безопасности ИИ — SOC 2 Type 2, шифрование, изоляция тенантов, поставщики моделей и контроль точности — изложено в нашей Политике конфиденциальности коннектора AI MCP. Дополнительные материалы по безопасности доступны на портале доверия Vertice.

Важно

Когда вы задаете любому внешнему ИИ-ассистенту вопрос, который вызывает коннектор, ваш запрос и ответ коннектора передаются поставщику этого ИИ-ассистента. Их политика конфиденциальности и условия определяют, что они делают с этими данными.

Vertice не контролирует и не проверяет последующую обработку данных поставщиком ИИ-ассистента. Пожалуйста, ознакомьтесь с политиками поставщика ИИ-ассистента перед включением коннектора.

11. Поддержка

ПричинаКанал
Функциональные проблемы, помощь в настройкеПоддержка Vertice ([email protected])
Вопросы по учетной записиВаш менеджер по работе с клиентами
Вопросы конфиденциальности, запросы о правах субъектов данных[email protected]
Раскрытие уязвимостей безопасности[email protected] — см. также нашу Политику раскрытия уязвимостей

12. Часто задаваемые вопросы

Отправляет ли коннектор мои данные Vertice поставщику моего ИИ-ассистента? Когда вы задаёте внешнему ИИ-ассистенту вопрос, который вызывает коннектор, ваш запрос и ответ инструмента коннектора передаются в инфраструктуру провайдера ИИ-ассистента (например, в Anthropic для коннектора Claude.ai). Это неизбежная природа MCP-коннектора. Vertice не контролирует и не проверяет, что провайдер ИИ-ассистента делает с этими данными — это регулируется вашим соглашением с провайдером ИИ-ассистента. Мы настоятельно рекомендуем вам ознакомиться с политикой конфиденциальности провайдера ИИ-ассистента перед включением коннектора.

Видит ли коннектор мою историю чатов в Claude или любые другие данные внутри Claude?

Нет. Коннектор получает только явные MCP-запросы, которые отправляет Claude — имя инструмента и параметры инструмента. У него нет доступа к памяти Claude, сводкам разговоров, предыдущим беседам или файлам, загруженным в Claude.

Будет ли коннектор вносить изменения в мои данные Vertice без моего одобрения?

Инструменты, выполняющие запись, несут явные аннотации MCP destructiveHint и readOnlyHint=false, которые сигнализируют совместимым ИИ-ассистентам о необходимости подтверждения у пользователя перед их вызовом. Claude следует этому шаблону. Если вы используете ИИ-ассистента, который не учитывает эти аннотации, используйте коннектор только с инструментами чтения или отключите его.

Могут ли два пользователя одного тенанта использовать общую конфигурацию коннектора?

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

Работает ли коннектор офлайн или в изолированных средах?

Нет. Коннектор — это размещённый сервис. Он требует входящего HTTPS-соединения из инфраструктуры провайдера ИИ-ассистента. Варианта локального развёртывания или самостоятельного хостинга не существует.

Куда я могу сообщить об ошибке или запросить новый инструмент?

Сообщения об ошибках и запросы функций направляются через команду поддержки Vertice. О проблемах безопасности следует сообщать напрямую на [email protected].