Vertice AI
oficialChatea con tus contratos, proveedores y gastos de SaaS
¿Qué puedes hacer con Vertice AI MCP?
- Consultas de vencimiento de contratos — Pregunta qué contratos de tu cartera vencen en un período determinado, por ejemplo, los próximos 90 días.
- Análisis de gastos y proveedores — Pregunta por el gasto anual total por proveedor y otros proveedores en la misma categoría.
- Revisión de documentos de contratos — Pregunta para encontrar el último contrato firmado de un proveedor y resumir los términos de renovación.
- Creación de solicitudes de compra — Pregunta para abrir una nueva solicitud de compra, por ejemplo, para asientos adicionales de un producto.
- Descubrimiento de herramientas — Pide a tu asistente que liste las herramientas de Vertice disponibles mediante el método MCP
tools/list.
Documentación
El conector MCP de Vertice AI se encuentra actualmente en Vista previa. El conjunto de clientes con acceso es limitado y el acceso se otorga a solicitud a través de tu Gerente de Cuenta de Vertice.
1. ¿Qué es el conector MCP de Vertice AI?
El conector MCP de Vertice AI es un endpoint alojado que permite que un asistente de IA externo compatible — por ejemplo, Claude — consulte tu espacio de trabajo de adquisiciones de Vertice y active flujos de trabajo de Vertice en tu nombre, utilizando lenguaje natural. Implementa el Protocolo de Contexto de Modelo (MCP) abierto sobre la plataforma existente de Vertice.
El conector es un canal de acceso adicional a Vertice. Expone los mismos datos de adquisiciones y flujos de trabajo que ya puedes utilizar a través de la aplicación web de Vertice, gobernados por los mismos controles de acceso basados en roles.
Conectar un asistente de IA no otorga acceso a nada que no pudieras ver tú mismo en Vertice.
A lo largo de este documento utilizamos Claude como ejemplo práctico. El mismo conector funciona con cualquier asistente de IA compatible con MCP que admita el transporte HTTP Streamable de MCP y OAuth 2.1 con PKCE (S256).
2. Casos de uso de ejemplo
El conector está diseñado para preguntas y flujos de trabajo relacionados con adquisiciones. A continuación se presentan preguntas ilustrativas que podrías plantear. Cada una se asigna a una de las herramientas enumeradas en la sección 4.
- "¿Qué contratos de nuestro portafolio vencen en los próximos 90 días?"
- "¿Cuál es nuestro gasto anual total con este proveedor, y qué otros proveedores están en la misma categoría?"
- "Encuentra el contrato firmado más reciente para este proveedor y resume los términos de renovación."
- "Abre una nueva solicitud de compra para 25 asientos adicionales del producto de este proveedor."
Estos son ejemplos. El conjunto exacto de herramientas, parámetros y comportamiento está determinado por la capa de orquestación de Vertice en el momento de la solicitud.
3. Compatibilidad y requisitos previos
| Requisito | Detalle |
|---|---|
| Suscripción activa de Vertice | Debes ser un usuario en un tenant activo de Vertice. |
| Cuenta de usuario de Vertice | Una cuenta de usuario en buen estado, con permiso para utilizar las funciones de IA de Vertice. |
| Autenticación | El conector te autentica a través de la configuración de autenticación existente de tu tenant en Vertice. Si tu tenant utiliza inicio de sesión único (SSO) a través de un proveedor de identidad SAML 2.0, inicias sesión con tus credenciales corporativas normales. Si tu tenant utiliza la autenticación nativa de Vertice, inicias sesión con tu nombre de usuario y contraseña de Vertice. |
| Suscripción del asistente de IA | Una suscripción con tu proveedor de asistente de IA elegido que admita agregar conectores personalizados. Para Claude.ai, esto actualmente requiere un plan Team o Enterprise; consulta la documentación de Anthropic para conocer la disponibilidad de planes más actualizada. |
El conector en sí es un servicio alojado. No se instala software en tu infraestructura. No se emiten claves API personales.
4. Categorías de herramientas
El conector expone herramientas en las siguientes categorías relevantes para adquisiciones. Cada herramienta anuncia anotaciones MCP explícitas readOnlyHint y destructiveHint, para que los asistentes de IA compatibles puedan advertir al usuario antes de invocar acciones de escritura.
| Categoría | Solo lectura | Realiza escrituras |
|---|---|---|
| Análisis de contratos | ✔ | |
| Análisis de gastos | ✔ | |
| Inteligencia de proveedores | ✔ | |
| Búsqueda de documentos | ✔ | |
| Estado de cumplimiento | ✔ | |
| Creación de solicitudes de compra | ✔ (aditiva — solo crea entidades nuevas) | |
| Actualizaciones de metadatos de contratos | ✔ (mutación controlada) |
La lista autoritativa de herramientas es descubrible directamente dentro de tu asistente de IA — el asistente llama al método MCP estándar tools/list contra el conector y te muestra los nombres, descripciones y anotaciones.
El conjunto exacto de herramientas puede evolucionar. Las anotaciones en cada herramienta continuarán indicando si lee o escribe.
5. Conexión de tu asistente de IA
Cada tenant de Vertice tiene su propia URL de conector con la forma:
https://ai.vertice.one/accounts//mcp
Reemplaza <your-account-id> con tu identificador de tenant. Si no conoces tu identificador de tenant, contacta al Soporte de Vertice.
Agregar el conector en Claude.ai
- Abre Claude.ai
- Ve a Configuración → Conectores → Agregar conector personalizado
- Ingresa un nombre (por ejemplo, 'Vertice')
- Pega la URL del conector de arriba
- Haz clic en Agregar
- Claude abre una ventana de autorización. Serás redirigido al proveedor de autenticación de tu tenant (el inicio de sesión único de tu empresa si tu tenant usa SSO, o el inicio de sesión nativo de Vertice en caso contrario).
- Inicia sesión con tus credenciales existentes. No se crea ninguna contraseña nueva. No se emite ninguna clave API personal.
- Claude confirma que el conector está conectado.
Ahora puedes hacer preguntas relacionadas con adquisiciones sobre tus datos de Vertice a Claude en cualquier conversación.
Enlace de instalación prellenado
Por conveniencia, el mismo flujo se puede iniciar siguiendo este enlace:
https://app.vertice.one/preferences/user/integrations
6. Autenticación
La autenticación utiliza OAuth 2.1 con PKCE (S256). El flujo es:
- Tu asistente de IA obtiene los metadatos del recurso protegido RFC 9728 del conector para descubrir el servidor de autorización.
- El asistente de IA obtiene los metadatos del servidor de autorización RFC 8414 para descubrir los endpoints de OAuth.
- El asistente de IA inicia un flujo de código de autorización OAuth 2.1 con PKCE.
- El reenviador
/authorizede Vertice te dirige directamente al proveedor de autenticación de tu tenant. Si tu tenant usa SSO a través de SAML, Vertice te dirige directamente a tu proveedor de identidad SAML configurado sin ningún paso de selección de Vertice en el medio. Si tu tenant usa la autenticación nativa de Vertice, verás el formulario de inicio de sesión de Vertice. - Después de un inicio de sesión exitoso, la capa de identidad de Vertice emite un token de acceso de corta duración vinculado a tu usuario, tu tenant y el alcance de recursos del conector.
- El asistente de IA presenta ese token de acceso como credencial Bearer en cada solicitud MCP a Vertice.
Los tokens expiran automáticamente. Puedes desconectar el conector en cualquier momento desde la configuración de tu asistente de IA; esto no afecta tu cuenta de Vertice.
7. Permisos
El conector aplica tus controles de acceso basados en roles existentes de Vertice. Los datos a los que puedes acceder a través del conector son exactamente los datos a los que puedes acceder a través de la aplicación web de Vertice, ni más.
El mismo modelo de control de acceso se comparte en todas las superficies de Vertice — la aplicación web, las integraciones de Vertice para Slack y Microsoft Teams, y el conector MCP de IA de Vertice. Cada acción que modifica datos, independientemente de qué superficie la haya iniciado, se captura en el registro de auditoría existente de Vertice.
8. Límites de velocidad
Para preservar la calidad del servicio, el conector aplica límites de velocidad a nivel de aplicación:
| Alcance | Límite |
|---|---|
| Por usuario autenticado | 60 solicitudes por minuto |
| Por tenant de Vertice (en todos los usuarios de la cuenta) | 300 solicitudes por minuto |
Cuando se alcanza un límite, el conector devuelve un error JSON-RPC con el código -32004, mapeado a HTTP 429 Demasiadas Solicitudes con los siguientes encabezados:
Retry-After: X-RateLimit-Limit: X-RateLimit-Remaining: 0 X-RateLimit-Reset:
Los asistentes de IA con buen comportamiento respetan Retry-After. En el uso interactivo normal no deberías alcanzar estos límites. Existen principalmente para proteger contra la automatización descontrolada. Si la carga de trabajo legítima de tu tenant requiere umbrales más altos, contacta a tu Gerente de Cuenta de Vertice.
Cómo Claude.ai muestra las respuestas de límite de velocidad
Cuando se alcanza un límite de velocidad durante una conversación con Claude, el cliente de Claude.ai puede mostrar la respuesta al usuario final como un mensaje genérico de error de herramienta en lugar de un mensaje explícito de límite de velocidad. La respuesta a nivel de protocolo cumple con la especificación; el texto visible para el usuario está determinado por el asistente de IA, no por Vertice. Si encuentras tal error, espera unos segundos antes de reintentar.
9. Tamaño de respuesta de las herramientas
El conector apunta al límite de respuesta de 25,000 tokens definido por la guía del Directorio de Conectores de Anthropic. Para mantener los resultados utilizables en consultas muy grandes, se aplica un truncamiento de red de seguridad en aproximadamente 20,000 tokens; si se activa, la respuesta incluye un pie de página explícito que indica que se produjo el truncamiento y cómo acotar la consulta. En el uso normal, la orquestación subyacente de Vertice está diseñada para paginar operaciones de listas grandes y no deberías ver el pie de página de truncamiento.
10. Manejo de datos
Una descripción de la postura de seguridad de IA más amplia de Vertice — SOC 2 Tipo 2, cifrado, aislamiento de tenants, proveedores de modelos y controles de precisión — se establece en nuestra Política de Privacidad del Conector MCP de IA. Materiales de seguridad adicionales están disponibles en el Portal de Confianza de Vertice.
Importante
Cuando haces una pregunta a cualquier asistente de IA externo que invoca el conector, tu mensaje y la respuesta del conector se transmiten al proveedor de ese asistente de IA. Su política de privacidad y términos rigen lo que hacen con esos datos.
Vertice no controla ni audita el procesamiento posterior por parte del proveedor del asistente de IA. Revisa las políticas del proveedor del asistente de IA antes de habilitar el conector.
11. Soporte
| Motivo | Canal |
|---|---|
| Problemas funcionales, ayuda de configuración | Soporte de Vertice ([email protected]) |
| Preguntas sobre la cuenta | Tu Gerente de Cuenta |
| Preguntas de privacidad, solicitudes de derechos de interesados | [email protected] |
| Divulgación de vulnerabilidades de seguridad | [email protected] — consulta también nuestra Política de Divulgación de Vulnerabilidades |
12. Preguntas frecuentes
¿El conector envía mis datos de Vertice al proveedor de mi asistente de IA? Cuando haces una pregunta a un asistente de IA externo que invoca el conector, tu mensaje y la respuesta de la herramienta del conector se transmiten a la infraestructura del proveedor del asistente de IA (por ejemplo, a Anthropic para el conector de Claude.ai). Esta es la naturaleza inevitable de un conector MCP. Vertice no controla ni audita lo que el proveedor del asistente de IA hace con esos datos; eso se rige por tu acuerdo con el proveedor del asistente de IA. Te recomendamos encarecidamente que revises la política de privacidad del proveedor del asistente de IA antes de habilitar el conector.
¿El conector ve mi historial de chat de Claude o cualquier otro dato dentro de Claude?
No. El conector recibe únicamente los sobres de solicitud MCP explícitos que envía Claude: el nombre de la herramienta y los parámetros de la herramienta. No tiene acceso a la memoria de Claude, resúmenes de conversaciones, conversaciones anteriores ni archivos subidos a Claude.
¿El conector realizará cambios en mis datos de Vertice sin mi aprobación?
Las herramientas que realizan escrituras llevan anotaciones explícitas de MCP destructiveHint y readOnlyHint=false, que indican a los asistentes de IA compatibles que confirmen con el usuario antes de invocarlas. Claude sigue este patrón. Si usas un asistente de IA que no respeta estas anotaciones, utiliza el conector solo con herramientas de lectura o desactívalo.
¿Pueden dos usuarios del mismo tenant compartir una configuración de conector?
Cada usuario final se autentica individualmente con su propia identidad. La URL del conector es por tenant; la conexión en sí es por usuario. Cada usuario solo ve lo que su rol de Vertice permite.
¿El conector funciona sin conexión o en entornos aislados?
No. El conector es un servicio alojado. Requiere conectividad HTTPS entrante desde la infraestructura del proveedor del asistente de IA. No existe opción local o autoalojada.
¿Dónde puedo reportar un error o solicitar una nueva herramienta?
Los informes de errores y las solicitudes de funciones se gestionan a través del equipo de soporte de Vertice. Los problemas de seguridad deben reportarse directamente a [email protected].