Executando o servidor remoto ONLYOFFICE DocSpace MCP: o que significa e como começar

O servidor MCP do DocSpace da ONLYOFFICE é o componente que transforma o DocSpace de uma ferramenta de colaboração baseada apenas em interface gráfica em uma solução automatizada e orientada por IA. As atualizações recentes tornam trivial a execução do servidor MCP do DocSpace em uma máquina remota e permitem que vários aplicativos, bots ou agentes de IA se conectem a ele com segurança. Essa abordagem centraliza a automação e simplifica as integrações entre equipes e ferramentas.

A seguir, você encontrará o que é um servidor DocSpace MCP remoto, por que executá-lo remotamente, como se conectar a ele rapidamente, as melhores práticas de segurança e casos de uso práticos.

O que é um servidor MCP em uma máquina remota?

O Servidor MCP Remoto do DocSpace é simplesmente o Servidor MCP do DocSpace executado em um servidor acessível via HTTP. Ele expõe um conjunto de ferramentas MCP (operações de arquivos, gerenciamento de salas, geração de documentos, etc.) que os clientes — agentes de IA, scripts de automação ou aplicativos — podem acessar via HTTP.

Por que executar o servidor MCP remotamente?

Um servidor MCP remoto oferece diversas vantagens em comparação a um servidor local. Algumas delas são:

• Manutenção centralizada. Reduz os custos operacionais, melhora a segurança e a consistência, e agiliza as atualizações e a resolução de problemas.
• Fluxos de trabalho previsíveis. Com um servidor MCP implantado remotamente, a disponibilidade das ferramentas é gerenciada centralmente. O proprietário do servidor decide quais ferramentas são expostas, garantindo uma experiência previsível para qualquer pessoa conectada ao servidor.
• Automação consistente para todas as equipes. Marketing, RH, produto, desenvolvimento, administração — todos usam o mesmo conjunto de ferramentas.
• Fácil de usar para o usuário final. A ausência de configuração manual resulta em integração mais rápida e menos erros de configuração.

Como funcionam as conexões remotas

Conectar-se a um servidor MCP remoto do DocSpace é simples. Você executa o servidor MCP em qualquer máquina acessível via HTTP: uma instância na nuvem, uma máquina virtual ou um contêiner. Em seguida, você o vincula ao seu DocSpace.

Depois disso, basta compartilhar a URL do servidor MCP com sua equipe ou com as ferramentas que precisam de acesso, usando OAuth ou chaves de API, e o servidor MCP gerencia toda a comunicação com o DocSpace em nome deles.

A partir desse ponto, eles podem executar tarefas, carregar arquivos, criar salas, gerar documentos ou executar fluxos de trabalho automatizados sem qualquer instalação local ou configuração complexa. Tudo flui por meio de um serviço central e seguro, um ponto de conexão transparente que mantém suas integrações simples, escaláveis e fáceis de gerenciar.

Arquitetura e transportes subsidiados

Um servidor MCP remoto expõe o Protocolo de Contexto do Modelo (Model Context Protocol) em um ou mais protocolos de transporte, permitindo que clientes de IA descubram e invoquem ferramentas:

• Streamable HTTP, o transporte moderno recomendado para respostas em fluxo contínuo.
• Eventos enviados pelo servidor SSE, com suporte para clientes legados que dependem de SSE.

O suporte a ambos os protocolos de transporte aumenta a flexibilidade da conexão, pois amplia a cobertura para uma gama mais ampla de clientes sem deixar de oferecer suporte aos protocolos legados.

Como conectar-se a um servidor MCP remoto público

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

A instância pública suporta autenticação usando OAuth, chave de API, Token de Acesso Pessoal (PAT), par nome de usuário/senha ou cabeçalho “Authorization” bruto. Dê preferência à autenticação OAuth sempre que possível.

A instância pública fornece acesso a todas as ferramentas disponíveis por padrão. A seleção de ferramentas pode ser personalizada usando parâmetros de consulta ou cabeçalhos personalizados. No entanto, prefira usar a interface do cliente MCP para configurar as ferramentas, quando compatível.

Para tornar as coisas práticas, aqui estão exemplos simples que mostram como os clientes se conectam a um servidor MCP remoto público. Estes exemplos refletem os métodos de autenticação atualmente suportados.

OAuth com aplicativo público. Conecte-se usando o aplicativo OAuth público sem credenciais personalizadas: https://mcp.onlyoffice.com/mcp

OAuth com aplicativo personalizado. Conecte-se usando seu próprio ID de cliente OAuth e segredo do cliente: https://mcp.onlyoffice.com/mcp (ID do cliente e segredo do cliente obrigatórios)

Chave de API com cabeçalhos. Conecte-se usando uma chave de API e URL base fornecidas em cabeçalhos personalizados:

• X-Mcp-Base-Url: https://your-instance.onlyoffice.com/
• X-Mcp-Api-Key: sk-a499e…

Chave de API com cabeçalho de autorização. Conecte-se usando uma chave de API no cabeçalho de autorização e a URL base em um parâmetro de consulta:

• https://mcp.onlyoffice.com/mcp?base_url=https://your-instance.onlyoffice.com
• Authorization: Bearer sk-a499e…

Nome de usuário e senha na URL. Conecte-se usando credenciais codificadas em URL e a URL base em um parâmetro de consulta:

• https://henry.milton%40onlyoffice.com:password@mcp.onlyoffice.com/mcp?base_url=https://your-instance.onlyoffice.com/

Isso oferece opções flexíveis e seguras para autenticar suas ferramentas ou fluxos de trabalho com a instância pública do MCP Server.

Experimente a automação de fluxos de trabalho no ONLYOFFICE DocSpace

Executar o servidor ONLYOFFICE DocSpace MCP remotamente leva o DocSpace para o mundo da colaboração programável. Com segurança OAuth, hospedagem flexível e conexões fáceis para ferramentas e agentes, o MCP se torna uma camada de automação confiável que pode atender a toda a sua organização.

Seja você uma pequena equipe ou uma grande empresa, o MCP Server permite otimizar o trabalho, automatizar tarefas repetitivas e aprimorar sua experiência com o DocSpace.

COMECE HOJE MESMO