Vertice AI

oficial

Converse com seus contratos, fornecedores e gastos com SaaS

Ver em vertice.oneExperimente este MCPPatrocinado

O que você pode fazer com Vertice AI MCP?

Consultas de expiração de contratos — Pergunte quais contratos do seu portfólio expiram em um determinado período, por exemplo, nos próximos 90 dias.
Análise de gastos e fornecedores — Pergunte pelo gasto anual total por fornecedor e por outros fornecedores na mesma categoria.
Revisão de documentos de contratos — Pergunte para encontrar o contrato assinado mais recente de um fornecedor e resumir os termos de renovação.
Criação de solicitação de compra — Pergunte para abrir uma nova solicitação de compra, por exemplo, para assentos adicionais de um produto.
Descoberta de ferramentas — Peça ao seu assistente para listar as ferramentas Vertice disponíveis por meio do método MCP tools/list.

Documentação

O conector MCP Vertice AI está atualmente em Preview. O conjunto de clientes com acesso é limitado e o acesso é concedido mediante solicitação por meio do seu Gerente de Conta Vertice.

1. O que é o conector MCP Vertice AI?

O conector MCP Vertice AI é um endpoint hospedado que permite que um assistente de IA externo compatível — por exemplo, Claude — consulte seu espaço de trabalho de compras da Vertice e acione fluxos de trabalho da Vertice em seu nome, usando linguagem natural. Ele implementa o protocolo aberto Model Context Protocol (MCP) sobre a plataforma Vertice existente.

O conector é um canal de acesso adicional à Vertice. Ele expõe os mesmos dados de compras e fluxos de trabalho que você já pode usar por meio do aplicativo web da Vertice, regidos pelos mesmos controles de acesso baseados em funções.

Conectar um assistente de IA não concede acesso a nada que você não pudesse ver na Vertice por conta própria.

Ao longo deste documento, usamos Claude como exemplo prático. O mesmo conector funciona com qualquer assistente de IA compatível com MCP que suporte o transporte HTTP Streamable do MCP e OAuth 2.1 com PKCE (S256).

2. Casos de uso de exemplo

O conector é destinado a perguntas e fluxos de trabalho relacionados a compras. Abaixo estão perguntas ilustrativas que você pode fazer. Cada uma corresponde a uma das ferramentas listadas na seção 4.

"Quais contratos do nosso portfólio expiram nos próximos 90 dias?"
"Qual é o nosso gasto anual total com este fornecedor e quais outros fornecedores estão na mesma categoria?"
"Encontre o contrato assinado mais recente deste fornecedor e resuma os termos de renovação."
"Abra uma nova solicitação de compra para 25 assentos adicionais do produto deste fornecedor."

Estes são exemplos. O conjunto exato de ferramentas, parâmetros e comportamento é determinado pela camada de orquestração da Vertice no momento da solicitação.

3. Compatibilidade e pré-requisitos

Requisito	Detalhe
Assinatura Vertice ativa	Você deve ser um usuário em um tenant Vertice ativo.
Conta de usuário Vertice	Uma conta de usuário em situação regular, com permissão para usar os recursos de IA da Vertice.
Autenticação	O conector autentica você por meio da configuração de autenticação Vertice existente do seu tenant. Se o seu tenant usa single sign-on (SSO) por meio de um provedor de identidade SAML 2.0, você faz login com suas credenciais normais da empresa. Se o seu tenant usa a autenticação nativa da Vertice, você faz login com seu nome de usuário e senha da Vertice.
Assinatura do assistente de IA	Uma assinatura com o provedor do assistente de IA escolhido que suporte a adição de conectores personalizados. Para Claude.ai, isso atualmente requer um plano Team ou Enterprise; consulte a documentação da Anthropic para obter a disponibilidade mais atualizada do plano.

O conector em si é um serviço hospedado. Nenhum software é instalado na sua infraestrutura. Nenhuma chave de API pessoal é emitida.

4. Categorias de ferramentas

O conector expõe ferramentas nas seguintes categorias relevantes para compras. Cada ferramenta anuncia anotações explícitas de MCP readOnlyHint e destructiveHint, para que assistentes de IA compatíveis possam avisar o usuário antes de invocar ações de escrita.

Categoria	Somente leitura	Realiza gravações
Análise de contratos	✔
Análise de gastos	✔
Inteligência de fornecedores	✔
Pesquisa de documentos	✔
Status de conformidade	✔
Criação de solicitação de compra		✔ (aditivo — cria apenas novas entidades)
Atualizações de metadados de contrato		✔ (mutação controlada)

A lista autoritativa de ferramentas é descoberta diretamente dentro do seu assistente de IA — o assistente chama o método MCP padrão tools/list contra o conector e exibe os nomes, descrições e anotações para você.

O conjunto exato de ferramentas pode evoluir. As anotações em cada ferramenta continuarão a indicar se ela lê ou grava.

5. Conectando seu assistente de IA

Cada tenant Vertice tem sua própria URL de conector no formato:

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

Substitua <your-account-id> pelo identificador do seu tenant. Se você não souber o identificador do seu tenant, entre em contato com o Suporte da Vertice.

Adicionando o conector no Claude.ai

Abra o Claude.ai
Vá para Configurações → Conectores → Adicionar conector personalizado
Insira um nome (por exemplo, 'Vertice')
Cole a URL do conector acima
Clique em Adicionar
O Claude abre uma janela de autorização. Você será redirecionado para o provedor de autenticação do seu tenant (o single sign-on da sua empresa se o seu tenant usar SSO, ou o login nativo da Vertice caso contrário).
Faça login com suas credenciais existentes. Nenhuma nova senha é criada. Nenhuma chave de API pessoal é emitida.
O Claude confirma que o conector está conectado.

Agora você pode fazer perguntas relacionadas a compras sobre seus dados da Vertice ao Claude em qualquer conversa.

Link de instalação pré-preenchido

Para sua conveniência, o mesmo fluxo pode ser iniciado seguindo este link:

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

6. Autenticação

A autenticação usa OAuth 2.1 com PKCE (S256). O fluxo é:

Seu assistente de IA busca os metadados de recurso protegido RFC 9728 do conector para descobrir o servidor de autorização.
O assistente de IA busca os metadados do servidor de autorização RFC 8414 para descobrir os endpoints OAuth.
O assistente de IA inicia um fluxo de código de autorização OAuth 2.1 com PKCE.
O encaminhador /authorize da Vertice roteia você diretamente para o provedor de autenticação do seu tenant. Se o seu tenant usa SSO via SAML, a Vertice roteia você diretamente para o provedor de identidade SAML configurado, sem nenhuma etapa de seleção da Vertice no meio. Se o seu tenant usa a autenticação nativa da Vertice, você vê o formulário de login da Vertice.
Após o login bem-sucedido, a camada de identidade da Vertice emite um token de acesso de curta duração vinculado ao seu usuário, ao seu tenant e ao escopo de recurso do conector.
O assistente de IA apresenta esse token de acesso como credencial Bearer em cada solicitação MCP à Vertice.

Os tokens expiram automaticamente. Você pode desconectar o conector a qualquer momento nas configurações do seu assistente de IA; isso não afeta sua conta Vertice.

7. Permissões

O conector aplica seus controles de acesso baseados em funções existentes da Vertice. Os dados que você pode acessar por meio do conector são exatamente os dados que você pode acessar por meio do aplicativo web da Vertice, nada além disso.

O mesmo modelo de controle de acesso é compartilhado em todas as superfícies da Vertice — o aplicativo web, as integrações da Vertice para Slack e Microsoft Teams e o conector MCP Vertice AI. Toda ação que modifica dados, independentemente de qual superfície a iniciou, é capturada na trilha de auditoria existente da Vertice.

8. Limites de taxa

Para preservar a qualidade do serviço, o conector aplica limites de taxa na camada de aplicação:

Escopo	Limite
Por usuário autenticado	60 solicitações por minuto
Por tenant Vertice (em todos os usuários da conta)	300 solicitações por minuto

Quando um limite é atingido, o conector retorna um erro JSON-RPC com código -32004, mapeado para HTTP 429 Too Many Requests com os seguintes cabeçalhos:

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

Assistentes de IA bem-comportados honram Retry-After. No uso interativo comum, você não deve atingir esses limites. Eles existem principalmente para proteger contra automação descontrolada. Se a carga de trabalho legítima do seu tenant exigir limites mais altos, entre em contato com seu Gerente de Conta Vertice.

Como o Claude.ai apresenta respostas de limite de taxa

Quando um limite de taxa é atingido durante uma conversa com o Claude, o cliente Claude.ai pode exibir a resposta ao usuário final como uma mensagem genérica de erro de ferramenta, em vez de uma mensagem explícita de limite de taxa. A resposta no nível do protocolo está em conformidade com a especificação; o texto exibido ao usuário é determinado pelo assistente de IA, não pela Vertice. Se você encontrar esse erro, aguarde alguns segundos antes de tentar novamente.

9. Tamanho da resposta da ferramenta

O conector visa o limite de resposta de 25.000 tokens definido pelas diretrizes do Diretório de Conectores da Anthropic. Para manter os resultados utilizáveis em consultas muito grandes, uma truncagem de segurança é aplicada em aproximadamente 20.000 tokens; se ela for acionada, a resposta inclui um rodapé explícito indicando que a truncagem ocorreu e como restringir a consulta. No uso normal, a orquestração subjacente da Vertice é projetada para paginar operações de lista grandes e você não deve ver o rodapé de truncagem.

10. Tratamento de dados

Uma descrição da postura de segurança de IA mais ampla da Vertice — SOC 2 Tipo 2, criptografia, isolamento de tenant, provedores de modelo e controles de precisão — está descrita em nossa Política de Privacidade do Conector MCP de IA. Materiais de segurança adicionais estão disponíveis no Portal de Confiança da Vertice.

Importante

Quando você faz uma pergunta a qualquer assistente de IA externo que chama o conector, seu prompt e a resposta do conector são transmitidos ao provedor desse assistente de IA. A política de privacidade e os termos deles regem o que eles fazem com esses dados.

A Vertice não controla nem audita o processamento downstream pelo provedor do assistente de IA. Revise as políticas do provedor do assistente de IA antes de habilitar o conector.

11. Suporte

Motivo	Canal
Problemas funcionais, ajuda na configuração	Suporte da Vertice ([email protected])
Perguntas sobre a conta	Seu Gerente de Conta
Perguntas sobre privacidade, solicitações de direitos do titular de dados	[email protected]
Divulgação de vulnerabilidade de segurança	[email protected] — consulte também nossa Política de Divulgação de Vulnerabilidades

12. Perguntas frequentes

O conector envia meus dados da Vertice para o provedor do meu assistente de IA? Quando você faz uma pergunta a um assistente de IA externo que chama o conector, seu prompt e a resposta da ferramenta do conector são transmitidos para a infraestrutura do provedor do assistente de IA (por exemplo, para a Anthropic no caso do conector do Claude.ai). Essa é a natureza inevitável de um conector MCP. A Vertice não controla nem audita o que o provedor do assistente de IA faz com esses dados — isso é regido pelo seu acordo com o provedor do assistente de IA. Recomendamos fortemente que você revise a política de privacidade do provedor do assistente de IA antes de ativar o conector.

O conector vê meu histórico de conversas do Claude ou qualquer outro dado dentro do Claude?

Não. O conector recebe apenas os envelopes explícitos de solicitação MCP que o Claude envia — o nome da ferramenta e os parâmetros da ferramenta. Ele não tem acesso à memória do Claude, resumos de conversas, conversas anteriores ou arquivos enviados para o Claude.

O conector fará alterações nos meus dados da Vertice sem minha aprovação?

Ferramentas que realizam escritas trazem anotações explícitas de MCP destructiveHint e readOnlyHint=false, que sinalizam a assistentes de IA compatíveis que devem confirmar com o usuário antes de invocá-las. O Claude segue esse padrão. Se você usar um assistente de IA que não honra essas anotações, use o conector apenas com ferramentas de leitura ou desative-o.

Dois usuários no mesmo tenant podem compartilhar uma configuração de conector?

Cada usuário final autentica individualmente com sua própria identidade. A URL do conector é por tenant; a conexão em si é por usuário. Cada usuário só vê o que sua própria função na Vertice permite.

O conector funciona offline ou em ambientes isolados (air-gapped)?

Não. O conector é um serviço hospedado. Ele requer conectividade HTTPS de entrada a partir da infraestrutura do provedor do assistente de IA. Não há opção on-premises ou auto-hospedada.

Onde posso relatar um bug ou solicitar uma nova ferramenta?

Relatórios de bugs e solicitações de recursos são encaminhados pela equipe de Suporte da Vertice. Problemas de segurança devem ser relatados diretamente para [email protected].