> ## Documentation Index > Fetch the complete documentation index at: https://docs.salvy.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Integrações ## Claude **Antes de começar** Verifique 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**](https://claude.ai/customize/connectors?modal=add-custom-connector\&connectorName=Salvy\&connectorUrl=https%3A%2F%2Fmcp.salvy.com.br%2Fmcp) 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. Caso outros colaboradores com acesso à Salvy tenham acesso ao MCP, eles devem acessar a seção Conectores, no Claude, e fazer a autorização da sua conta. 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](/mcp-guide/use-cases). *** ## ChatGPT **Antes de começar** A conexão com aplicativos MCP personalizados é feita pelo ChatGPT na web e pode exigir um plano compatível. 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 do workspace precisa criar, testar e publicar o aplicativo antes que ele possa ser utilizado pelos demais usuários. ### 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. Ative o **Developer Mode** nas configurações do workspace. 2. Acesse **Apps → Criar**. 3. Informe os dados do MCP da Salvy: * **Nome:** `Salvy` * **URL do MCP:** `https://mcp.salvy.com.br/mcp` * **Autenticação:** `OAuth` 4. Clique em **Escanear ferramentas (Scan Tools)** e conclua a autorização quando solicitado. 5. Clique em **Criar**. 6. Revise e publique o aplicativo para o workspace. O administrador do workspace pode definir quem terá acesso ao aplicativo, de acordo com as configurações disponíveis no plano utilizado. ### Primeira chamada Depois de conectar, selecione ou mencione o app da Salvy na mensagem e experimente perguntar: > **Quais linhas estão ativas na minha empresa?** A seleção do app vale para a mensagem em que ele é utilizado: mencione o app novamente quando uma nova pergunta precisar consultar a Salvy. Se o ChatGPT retornar suas linhas, a conexão está funcionando. Para mais exemplos, consulte [O que você pode fazer](/mcp-guide/use-cases). *** ## Microsoft Copilot **Antes de começar** Você 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` 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](/mcp-guide/use-cases). *** ## 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. 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 com MCP é feita por meio do Developer Mode e pode depender do plano utilizado. **No Claude,** a conexão é feita por meio de um custom connector. **No Microsoft Copilot Studio,** o MCP é adicionado como uma ferramenta usando o Model Context Protocol. 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 a versão mais recente do cliente. 4. Se a opção para adicionar um servidor MCP está habilitada nas configurações do cliente. 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 necessário, atualize ou reinicie o cliente de IA e tente novamente. 4. 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, verifique: 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 se a operação exige confirmação.**
Algumas ações precisam ser confirmadas antes da execução. Nesses casos, o agente apresentará os detalhes da operação e solicitará sua confirmação. 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. 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 ativa 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 exige uma confirmação.**
Algumas ações, especialmente operações com cobrança, precisam ser confirmadas antes da execução. 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. 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 variar entre os agentes. Depois de conectar, faça uma [primeira chamada](/mcp-guide/getting-started#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.