Pular para o conteúdo principal

Como conectar o servidor MCP do ONLYOFFICE Apps ao Mistral

Introdução​

O servidor MCP do ONLYOFFICE Apps é uma ferramenta para gerenciar a interação com modelos de linguagem projetados para aumentar a eficiência, otimizar os fluxos de trabalho impulsionados por IA, gerenciamento de documentos e tarefas, e para explorar todo o potencial do ONLYOFFICE Apps.

O servidor MCP do ONLYOFFICE Apps pode ser conectado a clientes que suportam conexão com servidores MCP em execução em uma máquina remota.

A instância pública está disponível em https://mcp.onlyoffice.com/mcp para clientes que suportam transporte HTTP Streamable moderno e em https://mcp.onlyoffice.com/sse para clientes que suportam apenas o transporte SSE legado. Recomendamos o uso do transporte HTTP Streamable sempre que possível.

Os seguintes dois métodos de autenticação podem ser usados para conectar o servidor MCP do ONLYOFFICE Apps ao Mistral: OAuth e Autenticação por Token de API. Este último é usado com clientes que permitem passar a configuração em cabeçalhos personalizados e parâmetros de consulta. Recomendamos o uso da autenticação OAuth sempre que possível.

Para adicionar o conector do servidor MCP do ONLYOFFICE Apps ao Mistral:

  1. Acesse sua conta do Mistral Chat;

  2. Vá para Inteligência → Conectores no painel esquerdo e clique no botão Adicionar conector.

    Conectores do Mistral

  3. Escolha Conector MCP Personalizado no canto superior direito e configure os parâmetros do servidor MCP:

    Conector personalizado

Autenticação OAuth​

  1. Digite o nome do conector.

    Conector personalizado

  2. Servidor do Conector - cole a URL do Servidor MCP do ONLYOFFICE:

    https://mcp.onlyoffice.com/mcp

  3. Descrição – forneça uma breve descrição para o Servidor MCP para melhorar a identificação do servidor. É um parâmetro opcional;

  4. Método de Autorização - escolha o OAuth2.1 como método de autorização para o servidor MCP do Apps e clique em Conectar;

  5. Complete o processo de autenticação OAuth:

    • Preencha suas credenciais do Apps.

      Conector personalizado

    • Permita que o Servidor Remoto MCP acesse sua conta Apps.

      Conector personalizado

Autenticação por Token de API​

Use este método de autenticação apenas se não puder usar OAuth por algum motivo, pois é menos seguro. Este método permite conectar o servidor MCP usando a chave de API no cabeçalho padrão e a URL base no parâmetro de consulta.

  1. Gere sua própria chave de API do Apps. Não é aconselhável usar as chaves de API do Proprietário ou do Gerente de Sala. Para gerar uma chave de API, vá para o seu Apps. Clique na guia Ferramentas de Desenvolvedor no painel esquerdo. Escolha a guia Chaves de API no topo e clique no botão Criar nova chave secreta. Copie a chave gerada.

    Gerar chave de API

  2. Digite o nome do conector;

  3. Servidor do Conector - adicione a URL base da sua instância do Apps à URL do servidor MCP do ONLYOFFICE Apps e passe-a via parâmetros de consulta seguindo a estrutura abaixo:

    https://mcp.onlyoffice.com/mcp?base_url=https://your-instance.onlyoffice.com

  4. Descrição – forneça uma breve descrição para o Servidor MCP para melhorar a identificação do servidor. É um parâmetro opcional;

  5. Método de Autorização - escolha a Autenticação por Token de API como método de autorização para o servidor MCP do Apps.

    Cabeçalho padrão - adicione sua chave de API do Apps ao cabeçalho de Autorização como um token Bearer. É um parâmetro obrigatório, pois este cabeçalho é usado para autorizar solicitações ao Apps.

    Authorization: Bearer sk-a499e...

  6. Clique em Criar para adicionar o servidor MCP do Apps aos conectores do Mistral.

Usando o servidor MCP do ONLYOFFICE​

  • Após uma autenticação bem-sucedida, o conector Apps aparece entre os conectores disponíveis.

    Apps conectado

  • Clique nele para exibir a visão geral do conector e suas funções. A guia Visão Geral fornece a descrição do conector que você forneceu durante a configuração e a possibilidade de excluir o conector clicando nos três pontos.

    Conector personalizado

  • A guia Funções permite que você percorra as ferramentas disponíveis e ative as necessárias.

    Conector personalizado

  • Abra o chat e forneça seu comando. Na lista de Conectores, certifique-se de que o Apps (ou o nome que você atribuiu a ele) esteja selecionado;

  • Clique em Continuar para confirmar a lista de ferramentas usadas para responder ao seu comando.

    Aprovar ferramentas