Skip to main content
O MCP da Salvy é aberto a qualquer agente de IA ou aplicação compatível com o protocolo MCP, um protocolo aberto. Isso inclui ferramentas próprias da sua empresa, e não só produtos de mercado. Abaixo, você encontra o passo a passo para Claude, ChatGPT e Codex e Microsoft Copilot, além de orientações para Cursor e outros agentes compatíveis. Esses são apenas exemplos documentados: se o seu agente oferece suporte a MCP, ele pode se conectar à Salvy.

​
Claude

Antes de começarVerifique se você tem permissão para adicionar conectores na sua organização do Claude.Em algumas empresas, somente um administrador da organização no Claude pode adicionar um novo conector.
Conecte sua conta da Salvy ao Claude para consultar informações e realizar tarefas sem precisar navegar pelo Dashboard. Conectar ao Claude Ao clicar, o Claude será aberto com a configuração da Salvy preenchida. Revise as informações e autorize a conexão com sua conta Salvy. Se o Claude solicitar que você escolha ou confirme o método de autenticação, siga as instruções exibidas na tela para concluir a conexão. Caso outros colaboradores com acesso à Salvy tenham acesso ao MCP, eles devem acessar a seção Conectores, no Claude, autorizar a conexão com suas próprias contas Salvy. Depois da autorização, o MCP da Salvy estará disponível no Claude e você poderá começar a fazer perguntas e realizar tarefas usando a Salvy.

​
Primeira chamada

Depois de conectar, experimente perguntar:
Quais linhas estão ativas na minha empresa?
Se o Claude retornar suas linhas, a conexão está funcionando. Para mais exemplos, consulte O que você pode fazer.

​
ChatGPT e Codex

Antes de começarA conexão com aplicativos MCP personalizados é feita pelo ChatGPT na web e pode exigir um plano compatível.
O Codex, agente de programação da OpenAI, também é compatível com MCP e pode se conectar à Salvy. Use a URL do MCP e a autenticação OAuth indicadas nesta seção e siga a documentação do Codex para adicionar um servidor MCP. O passo a passo abaixo é específico do ChatGPT. Se sua empresa já publicou o aplicativo da Salvy no workspace, você pode utilizá-lo diretamente. Caso ainda não esteja disponível, um administrador ou usuário autorizado precisa criar, testar e publicar o aplicativo antes que ele possa ser utilizado pelos demais usuários. A disponibilidade dos recursos depende do plano e das permissões do workspace.

​
Se o aplicativo da Salvy já estiver disponível

  1. Acesse Configurações → Apps.
  2. Encontre o aplicativo Salvy entre os aplicativos disponíveis.
  3. Selecione o aplicativo e inicie a conexão.
  4. Autorize o acesso à sua conta Salvy.
  5. Depois da autorização, o aplicativo estará disponível para uso nas suas conversas.
Como a conexão utiliza OAuth, cada usuário precisa autorizar sua própria conta Salvy antes de utilizar o aplicativo. O acesso concedido continua limitado às permissões que esse usuário já possui na Salvy.

​
Se você é administrador e ainda precisa configurar o aplicativo

  1. Acesse Plugins, do ChatGPT e clique em Adicionar (+) → Criar servidor MCP personalizado (Create custom MCP server).
  2. Informe os dados do MCP da Salvy:
    • Nome: Salvy
    • URL do MCP: https://mcp.salvy.com.br/mcp
    • Autenticação: OAuth
    • Logo: envie o ícone da Salvy.

    Baixar a logo Salvy

    PNG · 512×512 · 21 KB
  3. Clique em Escanear ferramentas (Scan Tools) e conclua a autorização quando solicitado. Aguarde o término da verificação.
  4. Clique em Criar.
  5. Revise e publique o aplicativo, caso essa etapa seja solicitada, para disponibilizá-lo para outros colaboradores.
O acesso ao aplicativo pode depender das permissões e das políticas definidas pelo administrador do workspace.

​
Primeira chamada

Depois de conectar, experimente perguntar:
Quais linhas estão ativas na minha empresa?
Se o ChatGPT retornar suas linhas, a conexão está funcionando. Para mais exemplos, consulte O que você pode fazer.

​
Microsoft Copilot

Antes de começarVocê precisa ter acesso ao Microsoft Copilot Studio e um agente criado.Depois de configurado e publicado, o agente pode ser disponibilizado para outros usuários da sua organização. Nesse caso, eles não precisam configurar o MCP novamente: basta utilizar o agente que foi disponibilizado e concluir a autenticação quando solicitada.

​
Adicione o MCP da Salvy

  1. Abra o agente que você deseja configurar no Copilot Studio.
  2. Acesse Tools.
  3. Selecione Add a tool.
  4. Selecione New tool.
  5. Escolha Model Context Protocol.
  6. Preencha as informações do servidor:
    • Server name: Salvy
    • Server description: Acesse e gerencie sua operação de telecom da Salvy.
    • Server URL: https://mcp.salvy.com.br/mcp
    • Logo: envie o ícone da Salvy.

    Baixar a logo Salvy

    PNG · 512×512 · 21 KB
  7. Em Authentication, selecione OAuth 2.0.
  8. Em OAuth 2.0 authentication type, selecione Dynamic discovery.
  9. Selecione Create.
O Copilot Studio encontrará automaticamente as informações necessárias para configurar a conexão.

​
Crie a conexão

  1. Depois de configurar o servidor, selecione Next.
  2. Na tela Add tool, selecione Create a new connection para o MCP da Salvy.
  3. Conclua o processo de autenticação quando solicitado.
  4. Depois de criar a conexão, selecione Add to agent.
O MCP da Salvy será adicionado ao seu agente e suas ferramentas ficarão disponíveis no Copilot Studio.

​
Compartilhe o agente

Depois de configurar o MCP da Salvy, você pode publicar e compartilhar o agente com os usuários da sua organização. Os usuários que utilizarem o agente podem precisar autenticar sua própria conta Salvy. Nesse caso, cada pessoa acessará a Salvy de acordo com as permissões da sua própria conta.

​
Primeira chamada

Depois de conectar, experimente perguntar ao seu agente:
Quais linhas estão ativas na minha empresa?
Se o Copilot Studio retornar suas linhas, a conexão está funcionando. Para mais exemplos, consulte O que você pode fazer.

​
Cursor e outros agentes compatíveis com MCP

Você pode conectar o Cursor e qualquer outro agente, aplicação ou ferramenta própria que ofereça suporte a MCP. Como o fluxo de configuração varia de acordo com o cliente, use as configurações de MCP do seu agente (ou a documentação dele) e informe os dados do servidor da Salvy:
  • Nome: Salvy
  • URL do MCP: https://mcp.salvy.com.br/mcp
  • Transporte: Streamable HTTP. O MCP da Salvy não utiliza stdio nem o transporte legado de SSE.
  • Autenticação: OAuth, para conectar um agente em nome de um usuário, ou API Key, para conectar um agente ou integração em nome de uma empresa. Veja os detalhes em Autenticação.
Se você está desenvolvendo uma integração própria, consulte os Requisitos técnicos. Depois de conectar, faça uma primeira chamada para verificar se a conexão está funcionando.

​
Conectar com ajuda de uma IA

Peça para uma IA compatível com MCP configurar a conexão com a Salvy para você. Copie o prompt abaixo e cole no seu agente de IA.

​
Problemas e soluções

Se você não consegue concluir a autorização do MCP no Claude, verifique se está usando uma conta Salvy com acesso à empresa que deseja consultar ou gerenciar.O e-mail usado para entrar no Claude não precisa ser o mesmo e-mail da sua conta Salvy. Por exemplo, você pode estar conectado ao Claude com joao@empresa.com.br e autorizar o MCP na Salvy usando joao@gmail.com, desde que essa conta tenha as permissões necessárias.Durante a configuração, o Claude abrirá uma página da Salvy para autorizar o acesso. É nessa etapa que você deve entrar com a conta Salvy correta.Para resolver:
  1. Na página de autorização, confirme qual conta está conectada à Salvy.
  2. Certifique-se de que essa conta possui acesso à empresa que deseja utilizar.
  3. Se necessário, saia da conta Salvy atual e entre com a conta correta.
  4. Tente realizar a conexão novamente.
Se você não conseguir adicionar o conector, verifique também se tem permissão para adicionar conectores na sua organização do Claude. Em algumas organizações, essa configuração é restrita a administradores.
A forma de conectar o MCP pode variar de acordo com o agente de IA, o plano e as configurações da sua conta.No ChatGPT, a conexão é feita pela versão web e a criação de aplicativos MCP personalizados pode depender do plano e das permissões do workspace.No Claude, a conexão é feita por meio de um conector personalizado. A possibilidade de adicionar um conector pode depender das permissões da organização.No Microsoft Copilot Studio, o MCP é adicionado como uma ferramenta de um agente no Copilot Studio.No Codex e no Cursor, o MCP é adicionado nas configurações de servidores MCP do próprio cliente. Consulte a seção sobre outros agentes.Se você não encontrar uma opção para adicionar ou conectar um servidor MCP, verifique:
  1. Se o seu agente de IA oferece suporte a MCP.
  2. Se o recurso está disponível no seu plano ou conta.
  3. Se você está utilizando uma versão compatível do cliente.
  4. Se você tem permissão para adicionar um servidor ou aplicativo MCP.
  5. Se a opção está habilitada nas configurações do cliente ou do workspace.
Se o aplicativo ou conector já tiver sido disponibilizado pela sua organização, talvez você só precise selecioná-lo e autorizar sua própria conta Salvy, sem configurar o MCP novamente.
Se a autenticação não for concluída, verifique se você está usando a conta Salvy correta e se ela possui acesso à empresa que deseja consultar ou gerenciar.Durante a autenticação, o MCP utiliza as permissões da sua conta Salvy para determinar quais informações e operações podem ser acessadas.Para resolver:
  1. Verifique qual conta Salvy está sendo utilizada na autorização.
  2. Confirme se essa conta possui acesso à empresa que você deseja consultar.
  3. Se você tiver mais de uma conta Salvy, saia da conta atual e entre com a conta que possui as permissões necessárias.
  4. Tente realizar a autenticação novamente.
Se o problema persistir, verifique se o seu agente de IA já possui uma conexão com o MCP da Salvy usando outra conta. Nesse caso, pode ser necessário remover ou substituir a conexão existente antes de tentar novamente.
Depois de conectar o MCP da Salvy, seu agente deve conseguir acessar as ferramentas disponíveis no servidor.Se o agente não encontrar ou não conseguir utilizar as ferramentas da Salvy, verifique:
  1. Confirme se a conexão com o MCP da Salvy foi concluída corretamente.
  2. Verifique se o MCP da Salvy está habilitado no agente ou na conversa que você está utilizando.
  3. Se o cliente oferecer uma opção para atualizar ou redescobrir as ferramentas, execute essa etapa.
  4. Se necessário, atualize ou reinicie o cliente de IA e tente novamente.
  5. Tente iniciar uma nova conversa e peça ao agente para consultar alguma informação da Salvy.
Se o agente encontrar as ferramentas, mas uma operação específica não puder ser realizada, o problema pode estar relacionado às permissões da sua conta ou ao tipo de operação. Nesse caso, consulte a mensagem retornada pelo agente para entender o que precisa ser ajustado.
Algumas operações do MCP da Salvy dependem das permissões da sua conta e podem exigir uma confirmação antes de serem executadas.Se o agente não conseguir realizar uma ação:
  1. Confirme se sua conta possui permissão para realizar a operação.
    No caso de conexões feitas com OAuth, o agente utiliza as permissões que você já possui na Salvy.
  2. Verifique o resultado da operação.
    Algumas operações podem ser processadas por etapas ou retornar resultados diferentes para cada linha. Confira se a ação foi concluída antes de tentar executá-la novamente.
  3. Confira se todas as informações necessárias foram fornecidas.
    Algumas operações precisam de informações específicas, como a empresa, as linhas ou outros identificadores. Seu agente pode consultar essas informações antes de realizar a ação.
  4. Confira a mensagem retornada pelo agente.
    Ela pode indicar se a operação não está disponível para sua conta, se falta alguma informação ou se existe outra condição que impede a execução.
O agente pode solicitar sua confirmação antes de executar uma operação, mas isso depende do comportamento do cliente de IA. A confirmação não substitui a autorização: a operação só pode ser realizada se a conexão tiver as permissões necessárias.Se a ação que você precisa realizar não estiver disponível no MCP, peça ao seu agente para utilizar submit_mcp_feedback. Assim, você pode enviar esse pedido diretamente para o time responsável pelo MCP.
Se uma ferramenta retornar um erro, leia a mensagem apresentada pelo agente. Em muitos casos, ela indica o que precisa ser corrigido antes de tentar novamente.Verifique:
  1. Se as informações fornecidas estão corretas.
    Alguns campos precisam seguir formatos específicos ou corresponder a informações existentes na sua conta.
  2. Se a operação pode ser realizada no estado atual.
    Algumas ações só podem ser executadas quando determinadas condições são atendidas. Por exemplo, uma linha precisa estar em um estado compatível para ser bloqueada.
  3. Se sua conta possui permissão para realizar a operação.
    A autorização da sua conexão é verificada quando a operação é executada.
  4. Se a operação respeita os limites da ferramenta.
    Algumas operações possuem limites de quantidade de linhas, valores ou frequência.
  5. Se a operação foi concluída ou ainda está em processamento.
    Se o resultado indicar que a solicitação foi aceita, mas ainda não foi concluída, consulte o estado da operação antes de tentar novamente.
Depois de corrigir o problema indicado na mensagem, peça ao agente para tentar a operação novamente.Se o erro persistir, entre em contato com o suporte da Salvy informando a operação que você tentou realizar e a mensagem de erro apresentada pelo agente.
O MCP é um protocolo aberto que pode ser utilizado por diferentes agentes de IA, incluindo Cursor, Codex e ferramentas próprias da sua empresa. A forma de configurar a conexão, porém, pode variar de acordo com o agente que você utiliza.Se o seu agente oferece suporte a MCP, você pode pedir para ele orientar a configuração ou consultar a documentação específica da IA.De forma geral, você precisará informar os dados do servidor da Salvy:
  1. Abra as configurações de MCP do seu agente.
  2. Adicione um novo servidor MCP com o nome Salvy.
  3. Informe a URL do servidor: https://mcp.salvy.com.br/mcp.
  4. Conclua a autenticação quando solicitado.
  5. Depois da autenticação, as ferramentas da Salvy estarão disponíveis para uso no agente.
A configuração pode exigir etapas adicionais de acordo com o cliente, o método de autenticação e as permissões da sua conta. Nem todo cliente compatível com MCP oferece o mesmo fluxo de conexão.Depois de conectar, faça uma primeira chamada para verificar se a conexão está funcionando.
Se você seguiu as orientações acima e ainda não conseguiu utilizar o MCP da Salvy, entre em contato com o suporte da Salvy.Para agilizar o atendimento, envie:
  • o cliente de IA que você está utilizando;
  • a operação que estava tentando realizar;
  • a mensagem de erro apresentada pelo agente, se houver;
  • e, se possível, uma captura de tela do problema.
Com essas informações, nossa equipe poderá investigar o que aconteceu e ajudar você a concluir a configuração ou realizar a operação.