Pular para o conteúdo principal
Além dos agentes do Flexxible Assist, você pode conectar à base de conhecimento os seus próprios agentes de IA: Claude, Cursor, GitHub Copilot no VS Code ou qualquer cliente compatível com MCP. Um agente conectado busca, lê e escreve páginas assim como o Teammate, e tudo o que ele faz fica registrado.
Esta página trata do servidor MCP do Flexxible KB, que dá acesso à base de conhecimento. O servidor MCP da Flexxible, que dá acesso a workspaces, sessões e operações da plataforma, é um serviço diferente, com outro endereço e outra autorização.

Como funciona

  • Um agente é uma identidade da sua organização. Você o cria em Configurações → Agentes, com um nome, como “Claude Code”.
  • Cada agente tem as suas chaves. Uma chave para cada lugar em que ele é executado, para que você possa revogá-las uma a uma.
  • A chave é enviada como token Bearer. Quem tiver a chave atua como esse agente na sua organização.
  • Tudo fica em nome dele. As suas alterações aparecem no Histórico com o nome do agente, e as suas chamadas em Atividade.
Somente os proprietários e os administradores criam agentes e gerenciam as suas chaves.

Criar um agente e a sua chave

1

Crie o agente

Em Configurações → Agentes, em Seus agentes, selecione Novo agente, dê um nome a ele e selecione Criar agente.
2

Crie uma chave

Abra o agente, selecione Nova chave e dê a ela o nome do lugar em que será usada, por exemplo “Claude no notebook da Marta”. Selecione Criar chave.
3

Copie a chave

Copie a chave nesse momento: ela não será exibida novamente. Copiar para Claude Code copia diretamente o comando de configuração com a chave incluída.
Trate uma chave de agente como uma senha. Não a cole em uma conversa com o assistente, em uma página nem em um repositório. Se ela vazar, revogue-a a partir do agente: o que a estiver usando deixará de funcionar na hora.

Endereços

Os endereços da sua organização são exibidos em Configurações → Agentes → Conectar um agente, com um botão para copiar cada um. Em todos os casos, a chave é enviada no cabeçalho Authorization: Bearer <clave de agente>.
Seção Conectar um agente das configurações: endereços do servidor MCP e da API REST, e a configuração para Claude Code, Claude Desktop, Cursor, VS Code e curl.

Configurar o cliente

A seção Como conectar das configurações oferece a configuração pronta para copiar. Substitua <clave de agente> pela sua chave.
Execute o comando em um terminal. Adicione --scope user para tê-lo em todos os projetos.
Depois de conectado, teste com uma pergunta como: “Qual cliente de VPN nós usamos? Busque no flx-kb.”

Ferramentas do servidor MCP

O servidor MCP publica ferramentas com nomes e descrições pensados para modelos de IA, e inclui instruções sobre como utilizá-las. A API REST oferece as mesmas operações. A especificação OpenAPI descreve todas elas.

Regras para os agentes

As mesmas regras se aplicam a qualquer agente, seja do Flexxible Assist ou seu:
  • Nunca obtêm o valor de uma credencial. Veem nomes, tipos, hosts e usuários, e podem vincular uma credencial em uma página.
  • Não podem escrever segredos. Toda escrita passa por um detector de segredos. Se ela adicionar uma senha, um token ou uma chave, é rejeitada com a indicação de usar o Cofre.
  • Editam, não reescrevem. As alterações são enviadas como substituições exatas de texto sobre a página tal como ela está, de modo que uma pessoa que esteja editando a mesma página preserve o seu trabalho. Se alguém tiver alterado o mesmo texto nesse meio-tempo, a escrita é rejeitada e o agente deve ler a página novamente.
  • Podem desfazer os seus próprios erros. Um agente não pode desfazer a alteração que criou uma página, porque isso equivaleria a excluí-la.
  • Somente pessoas validam. Um agente pode marcar uma página como pronta para revisão, mas não validá-la.
  • Acessam somente a sua organização. Uma chave dá acesso às páginas da sua organização e às que outras organizações compartilham com ela, que são somente leitura.

Gerenciar agentes e chaves

Abra um agente em Configurações → Agentes para ver as suas chaves, com a data de criação e de último uso de cada uma.
  • Revogar invalida uma chave na hora.
  • Excluir agente invalida todas as suas chaves. As suas edições permanecem no Histórico.
  • Atividade mostra cada chamada do agente e com qual chave ela foi feita. Consulte Atividade dos agentes.

Próximos passos