Skip to main content
O servidor MCP da Flexxible permite conectar assistentes de inteligência artificial, como o Claude ou o ChatGPT, à plataforma. Uma vez conectado, o assistente pode consultar em linguagem natural as informações da organização (workspaces, sessões, aplicativos instalados, grupos, fluxos, relatórios etc.) e, se tiver permissão, modificar a configuração ou executar operações nos dispositivos.

​
O que é MCP

Model Context Protocol (MCP) é um padrão aberto que define como os aplicativos de inteligência artificial se conectam a ferramentas e fontes de dados externas. Funciona como um conector universal: qualquer aplicativo compatível com MCP pode utilizar qualquer servidor MCP sem a necessidade de desenvolvimentos específicos. Um servidor MCP publica um conjunto de ferramentas (tools). Cada ferramenta realiza uma ação concreta, como listar os workspaces de uma organização ou reiniciar um dispositivo, e inclui uma descrição que indica ao assistente para que serve e quais parâmetros são necessários. Quando recebe uma solicitação, o assistente:
  1. Interpreta a solicitação e escolhe as ferramentas necessárias.
  2. Chama essas ferramentas no servidor MCP com os parâmetros adequados.
  3. Utiliza os resultados para elaborar a resposta ou decidir o próximo passo.
Por exemplo, diante da pergunta “Quantos dispositivos com Windows 11 estão sem conexão no tenant Contoso?”, o assistente localiza a organização Contoso, conta os workspaces que atendem às condições e responde com o resultado. mcp-diagram

​
Como funciona o servidor MCP da Flexxible

O servidor MCP da Flexxible está disponível no seguinte endereço:
Suas principais características são:
  • Baseado na API da Flexxible. As operações da API Gen 2 (v2) são publicadas como ferramentas independentes que abrangem workspaces, sessões, aplicativos instalados, alertas, patches, grupos de relatório, grupos de workspaces, fluxos, microsserviços, operações, Atividade Digital, localizações, redes, usuários, funções, tenants e auditoria, entre outros.
  • Autorização com chave de API. A conexão é autorizada uma única vez com uma chave de API da plataforma, que é inserida em uma página da Flexxible. O assistente nunca vê a chave: recebe um token de acesso independente que só é válido para o servidor MCP.
  • Permissões escolhidas pelo usuário. Ao autorizar a conexão, são escolhidas as permissões do assistente. O assistente só pode fazer o que for permitido, ao mesmo tempo, por essas permissões e pela função da chave de API.
  • Acesso limitado às organizações da chave. O assistente só pode acessar a organização da chave de API e seus tenants. Qualquer outra organização é rejeitada antes de chegar à API.
  • Ações identificadas. Cada ferramenta indica se apenas consulta dados ou se pode modificá-los ou excluí-los, o que permite que os aplicativos de IA solicitem confirmação antes de executar uma alteração.
  • Operações delimitadas. Cada operação em dispositivos ou sessões (reiniciar, desligar, encerrar sessão, enviar uma notificação etc.) é direcionada a uma lista explícita de, no máximo, 100 elementos.
O servidor MCP funciona com o ambiente Flexxible (api.flexxible.net). As chaves de API do ambiente FXXOne não são compatíveis.

​
Permissões

As chaves de API não têm permissões próprias: o que podem fazer depende da função atribuída à chave. Ao conectar o assistente, são escolhidas, além disso, as permissões da conexão, que atuam como um limite adicional sobre essa função.
As operações em dispositivos atuam sobre equipamentos reais: os usuários de um dispositivo reiniciado ou desligado perdem o trabalho não salvo, e um microsserviço realiza o que seu script indicar. Os fluxos e os agendamentos atuam mais tarde e de forma repetida sobre todos os dispositivos aos quais se destinam, por isso também exigem essa permissão.
Adicionar dispositivos a um grupo de workspaces (permissão de Escrita) os submete aos agendamentos existentes do grupo e aos fluxos direcionados a ele.

​
Endereços por domínio

Além do endereço principal, o servidor oferece endereços que incluem apenas as ferramentas de uma área específica. Eles foram pensados para aplicativos que carregam ao mesmo tempo todas as ferramentas de um conector, como o Microsoft Copilot Studio, nos quais um conjunto mais reduzido funciona melhor. No Claude e no ChatGPT, recomenda-se usar o endereço principal. Cada endereço é formado adicionando o caminho a https://mcp.flexxible.net (por exemplo, https://mcp.flexxible.net/mcp/devices). Todos os endereços incluem, além disso, duas ferramentas gerais: uma que mostra a identidade da conexão (organização, chave de API e permissões) e outra que lista as organizações acessíveis. É possível adicionar vários endereços ao mesmo aplicativo.

​
Requisitos

  • Uma chave de API da plataforma (API Gen 2).
  • Um aplicativo de IA compatível com servidores MCP remotos com autenticação OAuth, como o Claude ou o ChatGPT. O plano contratado ou as políticas da organização podem restringir a possibilidade de adicionar conectores personalizados.

​
Criar uma chave de API para o assistente

Para criar a chave, é necessário ter a função de Administrador de organização.
  1. Acessar Configurações → Organização.
  2. Selecionar a aba Chaves de API.
  3. Clicar em Criar chave de API.
  4. Preencher o formulário:
api-3
  • Nome. Identificador da chave de API. Por exemplo, Assistente IA - Claude.
  • Função. Função com as permissões mínimas necessárias para o que se deseja que o assistente faça.
  • Duração. Tempo de validade da chave. A conexão com o assistente deixa de funcionar quando a chave expira.
  1. Clicar em Salvar e copiar a chave.
Utilizar uma chave de API específica para o assistente facilita auditar sua atividade e revogar o acesso sem afetar outras integrações.
A chave de API só deve ser inserida na página de autorização da Flexxible. Ela nunca deve ser colada em uma conversa com o assistente.

​
Conectar um assistente de IA

O processo é semelhante em todos os aplicativos compatíveis com MCP:
  1. No aplicativo de IA, adicionar um conector ou servidor MCP personalizado.
  2. Inserir um nome (por exemplo, Flexxible) e o endereço https://mcp.flexxible.net/mcp.
  3. Se o aplicativo solicitar o tipo de autenticação, selecionar OAuth. Não é necessário inserir um ID nem um segredo de cliente: o aplicativo se identifica automaticamente perante o servidor.
  4. Iniciar a conexão. O aplicativo abre a página de autorização da Flexxible no navegador.
  5. Concluir as duas etapas da página de autorização, descritas a seguir.
  6. Voltar ao aplicativo de IA e verificar se o conector está ativo na conversa.
Nas seções Conectar o Claude e Conectar o ChatGPT, são detalhados os passos para cada aplicativo.

​
Página de autorização

Ao iniciar a conexão, o aplicativo de IA abre uma página da Flexxible com duas etapas. A página está disponível em espanhol, inglês, catalão, basco e português do Brasil, e o idioma pode ser alterado no seletor localizado no canto superior direito.

​
Etapa 1: Revisar o acesso

mcp-consent-step1 A página mostra as seguintes informações:
  • Aplicativo que solicita o acesso. Os aplicativos que se identificam com uma identidade publicada, como o Claude ou o ChatGPT, mostram Publicado por e seu domínio. Os aplicativos que se registram de forma automática aparecem como Aplicativo não verificado, já que qualquer aplicativo pode se registrar com qualquer nome. Nesse caso, só se deve continuar se a conexão tiver acabado de ser iniciada a partir de um aplicativo confiável.
  • O acesso será enviado para. Domínio do aplicativo que receberá o acesso. Se for um aplicativo instalado no próprio computador, é exibido um aviso.
  • Servidor MCP. Endereço do servidor que está sendo autorizado.
  • Permissões. Leitura está sempre incluída. Escrita aparece marcada se o aplicativo a solicitar. Administração e Operações em dispositivos nunca são marcadas automaticamente, mesmo que o aplicativo as solicite (nesse caso, aparecem como Solicitado): para concedê-las, é preciso marcá-las manualmente.
Clicar em Continuar para passar à próxima etapa, ou em Negar para cancelar a conexão.

​
Etapa 2: Inserir a chave de API

mcp-consent-step2 A página resume o aplicativo e as permissões escolhidas. O botão Alterar permite voltar à etapa anterior sem perder a seleção.
  1. Colar a chave de API no campo Chave de API.
  2. Clicar em Autorizar.
A plataforma verifica a chave antes de salvar a autorização. Se a chave não for válida, é exibida uma mensagem de erro e é possível corrigi-la sem sair da página. Uma vez autorizada a conexão, o navegador volta ao aplicativo de IA.

​
Conectar o Claude

Os conectores personalizados estão disponíveis no Claude (web), no Claude Desktop e no Cowork para os planos Free, Pro, Max, Team e Enterprise. No plano Free, só é possível adicionar um conector personalizado.
Os nomes dos menus do Claude correspondem à sua interface em inglês. Se o Claude estiver configurado em português, os menus aparecem traduzidos (por exemplo, Personalizar → Conectores).

​
Planos Free, Pro e Max

  1. Acessar Customize → Connectors. No Claude Desktop, selecionar Customize na barra lateral e, em seguida, Connectors.
  2. Clicar em + Add → Add custom connector.
  3. Inserir um nome para o conector (por exemplo, Flexxible) e o endereço do servidor: https://mcp.flexxible.net/mcp. Clicar em Continue.
  4. Revisar a configuração de autenticação que o Claude detectou e clicar em Continue.
  5. Configurar as seguintes opções:
    • Authentication. Manter uma opção com login (Sign in now ou Sign in when needed). Não selecionar No sign in.
    • OAuth client. Selecionar Use Claude’s published identity (Recommended). Com essa opção, a página de autorização mostra o aplicativo como Publicado por claude.ai.
    • Request headers. Deixar vazio. O servidor não aceita chaves de API nos cabeçalhos: a chave é sempre inserida na página de autorização.
  6. Clicar em Add. Se a página de autorização não abrir automaticamente, clicar em Connect ao lado do conector.
  7. Concluir as duas etapas da página de autorização. Ao terminar, o conector aparece como conectado.

​
Planos Team e Enterprise

Nesses planos, um proprietário da organização adiciona o conector uma única vez e, depois, cada membro o conecta com sua própria chave de API. Para adicionar o conector à organização (somente proprietários ou, no Enterprise, funções personalizadas com a permissão Manage access to Libraries):
  1. Acessar Organization settings → Connectors.
  2. Clicar em Add, posicionar o cursor sobre Custom e selecionar Web.
  3. Seguir os passos 3 a 6 da seção anterior.
Para começar a usar o conector (cada membro):
  1. Acessar Customize → Connectors.
  2. Localizar o conector adicionado pelo proprietário. Normalmente ele exibe a etiqueta Custom.
  3. Clicar em Connect e concluir a página de autorização com uma chave de API própria.

​
Utilizar o conector em uma conversa

  1. Em uma conversa, clicar no botão + no canto inferior esquerdo da caixa de texto.
  2. Selecionar Connectors e ativar Flexxible.
  3. Escrever a solicitação.
Quando o Claude vai usar uma ferramenta da Flexxible, ele solicita permissão com as opções Allow once (permitir uma vez) ou Always allow (permitir sempre). Para alterar essa configuração mais tarde, acessar Customize → Connectors, selecionar o conector e, em Tool permissions, escolher para cada grupo de ferramentas (somente leitura ou de escrita e exclusão) ou para cada ferramenta entre Always allow, Needs approval ou Blocked.
Recomenda-se manter Needs approval para as ferramentas que modificam ou excluem dados, de modo que o Claude solicite confirmação antes de cada alteração.
Para mais informações, consulte a documentação oficial do Claude.

​
Conectar o ChatGPT

A conexão com servidores MCP personalizados está disponível no ChatGPT web para os planos Business e Enterprise/Edu. Não está disponível nos aplicativos móveis.
  • Business. Somente os administradores e proprietários do espaço de trabalho podem adicionar e publicar servidores MCP personalizados.
  • Enterprise/Edu. Os administradores e proprietários podem adicioná-los e conceder a outros membros a permissão Create plugins with MCPs em Workspace settings → Permissions & roles. Somente os administradores e proprietários podem publicá-los para o espaço de trabalho.
No plano Pro, o ChatGPT só permite conectar servidores MCP personalizados com permissões de leitura. Os nomes dos menus correspondem à interface em inglês do ChatGPT, na qual os conectores são chamados de Plugins.

​
Adicionar o servidor

  1. Acessar Plugins na barra lateral.
  2. Clicar no botão + e selecionar Add custom MCP server.
  3. Inserir um nome (por exemplo, Flexxible) e, opcionalmente, uma descrição.
  4. Em Connection, inserir o endereço do servidor: https://mcp.flexxible.net/mcp.
  5. Na autenticação, selecionar OAuth. Não é necessário inserir um ID nem um segredo de cliente.
  6. Revisar o aviso de risco e marcar a caixa I understand and want to continue.
  7. Clicar em Create as a plugin.
  8. Concluir as duas etapas da página de autorização da Flexxible quando o ChatGPT abri-la e revisar as ferramentas detectadas.
  9. Instalar o plugin criado.
Dependendo de como o ChatGPT se identifica perante o servidor, a página de autorização o mostra como Publicado por chatgpt.com ou como Aplicativo não verificado. Ambos os casos são normais se a conexão tiver acabado de ser iniciada a partir do ChatGPT.
Para que outros membros do espaço de trabalho possam utilizá-lo, um administrador ou proprietário deve publicá-lo no console de administração do ChatGPT. Cada membro autoriza depois a conexão com sua própria chave de API.

​
Utilizar o plugin em uma conversa

  1. Iniciar uma nova conversa.
  2. Digitar @ na caixa de texto e selecionar Flexxible.
  3. Escrever a solicitação.
A seleção se aplica somente à mensagem em que é feita. Se uma solicitação posterior precisar de novos dados da Flexxible, mencionar novamente o plugin com @. O ChatGPT solicita confirmação antes de executar as ações que modificam dados, de acordo com as permissões configuradas no ChatGPT e com o contexto da ação.
Nos espaços de trabalho, o ChatGPT utiliza uma cópia fixa das ferramentas do servidor obtida no momento da publicação. Quando a Flexxible adiciona novas ferramentas, um administrador deve atualizar a lista de ferramentas (Refresh) na configuração do espaço de trabalho para que fiquem disponíveis.
Para mais informações, consulte a documentação oficial do ChatGPT.

​
Exemplos de uso

Uma vez conectado, basta pedir ao assistente o que for necessário em linguagem natural. Alguns exemplos: Workspaces e sessões
  • “Quantos dispositivos com Windows 11 estão sem conexão no tenant Contoso?”
  • “Quais dispositivos têm atualizações do Windows pendentes?”
  • “Mostre os alertas e o uso de disco do dispositivo LAPTOP-042.”
  • “Quais dispositivos têm o Zoom instalado e em qual versão?”
  • “Quem tem uma sessão iniciada nos servidores de sessões neste momento?”
  • “Reinicie os dispositivos KIOSK-01 e KIOSK-02.” (Operações em dispositivos)
Grupos
  • “Crie um grupo de workspaces chamado Quiosques com estes três dispositivos.” (Escrita)
  • “Adicione uma reinicialização diária às 2h, horário de Madri, ao grupo Quiosques.” (Operações em dispositivos)
  • “Liste os grupos de relatório e sua configuração de produto.”
  • “Obtenha o relatório mensal do grupo de relatório Escritórios de setembro de 2026.”
Automação
  • “Quais fluxos estão habilitados e o que eles fazem?”
  • “Quais microsserviços estão habilitados nesta organização?”
  • “Execute o microsserviço de limpeza de disco no dispositivo LAPTOP-042.” (Operações em dispositivos)
  • “A reinicialização de ontem à noite foi concluída corretamente em todos os dispositivos?”
Administração
  • “Quem excluiu o grupo Quiosques e quando?”
  • “Liste os usuários com a função Helpdesk.”
  • “Quantos grupos de workspaces, fluxos e usuários esta organização pode ter?”
A maioria dos aplicativos de IA solicita confirmação antes de executar uma ferramenta que modifica dados. Antes de aprová-la, recomenda-se revisar os detalhes (nomes, dispositivos, horários).
As operações executadas a partir do assistente são registradas em Operações, assim como as executadas a partir da plataforma, e são executadas de forma assíncrona: o assistente pode consultar seu status e o resultado em cada dispositivo.

​
Trabalhar com várias organizações

Se a chave de API pertencer a uma organização com tenants, o assistente pode trabalhar com qualquer organização dessa árvore:
  • Por padrão, as solicitações são aplicadas à organização da chave de API.
  • Para trabalhar com um tenant, basta mencioná-lo na solicitação (por exemplo, “…no tenant Contoso”). O assistente o busca pelo nome.
  • As perguntas de contagem e resumo podem abranger várias organizações ao mesmo tempo (por exemplo, “…em todos os meus tenants”). As organizações são processadas em lotes de 25 e o assistente pode continuar com o lote seguinte.
  • As organizações que não pertencem à árvore da chave são rejeitadas, mesmo que seu ID seja conhecido.
  • Um tenant recém-criado pode levar até cinco minutos para ficar disponível.

​
Gerenciar a conexão

​
Ampliar ou reduzir as permissões

Não é necessário conceder todas as permissões ao conectar. Quando uma solicitação precisa de uma permissão que não foi concedida, o servidor solicita ao aplicativo de IA uma nova autorização: a página de autorização é aberta com a permissão adicional solicitada e, depois de marcá-la e inserir novamente a chave de API, a solicitação continua. Se o aplicativo não mostrar essa solicitação, desconectar o conector e conectá-lo novamente marcando a permissão necessária. Para reduzir as permissões, desconectar o conector no aplicativo de IA e conectá-lo novamente com menos permissões marcadas.

​
Revogar o acesso

Para cortar o acesso por completo, revogar ou excluir a chave de API em Configurações → Organização → Chaves de API. Todas as conexões que utilizam essa chave deixam de funcionar.

​
Duração da conexão

A conexão é renovada automaticamente enquanto é utilizada: cada renovação a mantém ativa por mais 30 dias. É necessário conectar novamente nos seguintes casos:
  • A conexão não foi utilizada durante 30 dias.
  • A chave de API expirou. Uma conexão nunca dura mais do que sua chave.
  • A chave de API foi revogada.

​
Limites de uso

Cada conexão pode realizar, por minuto, até:
  • 60 consultas.
  • 30 alterações de escrita ou administração.
  • 5 operações em dispositivos, incluindo as alterações em fluxos e agendamentos.
Além disso, a API da Flexxible limita o número de solicitações por chave de API. Esse limite é compartilhado por todas as conexões que utilizam a mesma chave.

​
Solução de problemas

​
Boas práticas

  • Criar uma chave de API específica para o assistente, com a função mínima necessária e uma duração limitada.
  • Conceder apenas as permissões necessárias e ampliá-las quando for preciso.
  • Revisar com atenção as ações que o assistente propõe antes de confirmá-las, especialmente as operações em dispositivos.
  • Revogar a chave de API quando ela deixar de ser utilizada ou se houver suspeita de que foi comprometida.