Antes de começar
Antes de conectar o MCP da Salvy, você precisa ter acesso à sua conta Salvy e utilizar um cliente de IA compatível com MCP.
A configuração e a forma de autenticação podem variar de acordo com o agente de IA que você utiliza.
Consulte a seção de Integrações para encontrar as instruções específicas para o seu cliente.
Conectar ao MCP Salvy
Para conectar seu agente ao MCP da Salvy, adicione o MCP ao agente de IA que você deseja utilizar.
Para conexões feitas em nome de um usuário, você será direcionado para uma página de autorização da Salvy. Nela, poderá revisar o acesso solicitado e autorizar seu agente a utilizar a Salvy em seu nome.
Depois da autorização, a conexão será concluída e você poderá começar a utilizar as capacidades da Salvy pelo seu agente de IA.
A configuração pode variar de acordo com o agente que você utiliza. Consulte a seção de Integrações para ver o passo a passo específico para cada IA.
Autenticação
Para utilizar o MCP da Salvy, é necessário autenticar o acesso antes que seu agente possa consultar informações ou realizar operações.
O MCP da Salvy oferece duas formas de autenticação:
OAuth: para conectar um agente em nome de um usuário. Esse é o fluxo utilizado quando você conecta seu agente à sua conta Salvy. Você será direcionado para uma página de autorização, onde poderá revisar o acesso solicitado e autorizar a conexão.
API Key: para conectar um agente ou integração em nome de uma empresa. A chave está associada a sua empresa e possui permissões específicas, chamadas de scopes, que determinam quais operações podem ser realizadas através daquela conexão.
OAuth
Quando você utiliza OAuth, o MCP associa a conexão ao seu usuário da Salvy. As permissões disponíveis são determinadas pelos acessos que esse usuário possui na empresa que está sendo consultada ou gerenciada.
Por exemplo, se ele tiver acesso de Financeiro, poderá usar somente as ferramentas relacionadas ao financeiro da empresa, como consultas às faturas e rateio.
Isso significa que conectar seu agente ao MCP não cria um novo conjunto de permissões: o agente utiliza o contexto de acesso que já existe para você na Salvy. A autorização é verificada a cada chamada, considerando as permissões atuais do usuário.
Se sua organização tem mais de uma empresa cadastrada na Salvy, uma conexão OAuth pode operar em todas as empresas às quais você tem acesso, facilitando o trabalho de gestão.
API Key
As API Keys representam o acesso de uma empresa, e não de um usuário individual. Cada chave possui um conjunto de scopes que são configurados na sua criação e definem quais capacidades podem ser utilizadas através dela.
Esse modelo é especialmente útil para integrações e agentes que precisam acessar a Salvy sem depender da sessão de um usuário específico.
Cada API Key está associada a uma única empresa. As operações realizadas através dela ficam limitadas à empresa e aos scopes configurados para aquela chave.
Importante: a API Key deve ser tratada como uma credencial sensível. Nunca compartilhe sua chave em conversas, código público ou ferramentas que não sejam confiáveis.
Primeira chamada
Depois de conectar seu agente ao MCP da Salvy, faça uma pergunta simples ao seu agente de IA para verificar se a conexão está funcionando.
Você pode começar pedindo algo como:
Quais linhas estão ativas na minha empresa?
Seu agente utilizará o MCP para consultar as linhas às quais você tem acesso e apresentar os resultados.
Se a resposta estiver correta, sua conexão está funcionando e você já pode começar a explorar as capacidades da Salvy.
A partir daí, você pode fazer outras perguntas, como:
Quais empresas eu gerencio pela Salvy?
Quais linhas mais consumiram dados este mês?
Quanto gastamos com telecom no mês passado?
Para ver mais exemplos, consulte O que você pode fazer.
