Traga seu próprio servidor MCP para a arquitetura de referência do kagent

Visão geral

Essa solução atende à necessidade de um mecanismo padronizado, seguro e escalonável para integrar servidores do Protocolo de Contexto de Modelo (MCP) em ambientes de software do Distributed Cloud (GDC) com o kagent implantado como a plataforma de IA agêntica.

O problema principal que está sendo resolvido é a falta de uma interface unificada para conectar aplicativos de modelos de linguagem grandes (LLMs) a fontes de dados e ferramentas localizadas em clusters regulamentados do GDC. Essa arquitetura oferece um framework Bring Your Own (BYO) que permite aos desenvolvedores implantar servidores MCP personalizados que expõem recursos corporativos específicos como ferramentas para agentes de IA.

Essa arquitetura abrange os protocolos de comunicação entre o kagent e os servidores MCP, além da topologia de componentes no GDC. Ela exclui a lógica interna de servidores MCP de terceiros.

O público-alvo deste documento inclui administradores da plataforma GDC, desenvolvedores de aplicativos de IA e revisores de segurança responsáveis por aprovar integrações de ferramentas externas.

Recursos e funcionalidades

O kagent oferece um framework flexível que permite que as organizações usem servidores MCP BYO para integrar LLMs a ferramentas locais ou proprietárias. Com esse recurso, os agentes podem interagir com fontes de dados especializadas e realizar tarefas complexas dentro do perímetro de um cluster do GDC.

Componentes funcionais e responsabilidades

A arquitetura inclui os seguintes componentes funcionais:

  • Plataforma de agentes de IA (kagent): atua como o orquestrador central. Ele gerencia o ciclo de vida da sessão agêntica, encaminha as consultas do usuário para o LLM e coordena a execução de ferramentas pelo cliente MCP.
  • LLM: lida com o processamento e o raciocínio de linguagem natural. Ele determina quando uma ferramenta específica é necessária para atender a uma solicitação e gera os parâmetros necessários para chamar essa ferramenta.
  • Servidor MCP: expõe ferramentas específicas pelo MCP como um serviço independente. Ele lida com a lógica de baixo nível de interação com sistemas empresariais de back-end ou repositórios de dados.

Interfaces e fluxo de dados

A arquitetura de ponta a ponta depende de interfaces padronizadas para manter a interoperabilidade e a segurança:

  • Transporte do MCP: o kagent se comunica com o servidor MCP usando JSON-RPC padronizado em um transporte do MCP compatível, como HTTP transmissível (ou HTTP com SSE) ou stdio. Essa interface define como as ferramentas são descobertas, descritas e invocadas.
  • Fluxo de dados: o ciclo de vida da solicitação segue estas etapas:
    1. O usuário envia um comando para o kagent.
    2. O kagent encaminha o comando para o LLM.
    3. O LLM identifica uma chamada de ferramenta e a retorna para o kagent.
    4. O kagent encaminha a solicitação ao servidor MCP.
    5. O servidor MCP executa a ferramenta na fonte de dados local e retorna o resultado.
    6. O kagent envia o resultado de volta ao LLM para gerar a resposta final.

Arquitetura

Para demonstrar como implantar e usar um servidor MCP BYO, esta arquitetura de referência usa o aplicativo de código aberto Nextcloud, o servidor MCP dele e o agente do Nextcloud no Solo Enterprise para kagent.

Este exemplo disponibiliza o modelo Gemma 4 usando vLLM.

A arquitetura conecta o Nextcloud, o kagent e o modelo Gemma 4 no ambiente do GDC. Nessa configuração, o kagent usa o Nextcloud como um repositório de dados para que o modelo Gemma 4 possa acessar e processar informações no Nextcloud por meio de interfaces MCP padronizadas.

O Nextcloud é uma plataforma de colaboração e armazenamento em nuvem de código aberto e auto-hospedada que oferece suporte à implantação no local para ajudar você a manter o controle e a privacidade dos dados do usuário. É um componente do openDesk.

O Nextcloud inclui os seguintes recursos:

  • Sincronização de arquivos e compartilhamento: armazene arquivos, sincronize-os em computadores e dispositivos móveis usando apps dedicados e compartilhe-os usando links.
  • Ferramentas de produtividade: use os clientes de e-mail, agenda, contatos e gerenciamento de tarefas integrados.
  • Colaboração: integre pacotes de escritório, como o Collabora Online ou o ONLYOFFICE, diretamente ao Nextcloud para coeditar documentos, planilhas e apresentações em tempo real.
  • Extensibilidade: instale plug-ins da app store para adicionar recursos como gerenciadores de senhas, quadros Kanban ou players de música.

Essa solução requer o GDC com o kagent e o vLLM disponibilizando o modelo Gemma 4. O diagrama a seguir ilustra a configuração de validação:

Configuração de validação com GDC, kagent, Nextcloud e vLLM disponibilizando o Gemma 4.

Outros recursos