Conecte seus apps de IA à sua comunidade com o servidor MCP integrado do Discourse

O Discourse agora possui um servidor MCP integrado, permitindo que você peça aos seus aplicativos de IA favoritos para encontrar um tópico, acompanhar uma discussão ou preparar um relatório sobre a atividade na sua comunidade.

O MCP (Model Context Protocol) é uma forma de aplicativos de IA utilizarem ferramentas fornecidas por outro serviço. O Discourse fornece essas ferramentas, e você conecta seu aplicativo fazendo login com sua conta do Discourse e aprovando o acesso solicitado. :slight_smile:

O servidor é executado como parte do seu site do Discourse. Existe um pacote separado discourse-mcp, que é uma ferramenta que você instala e executa localmente - ele não é necessário para este novo recurso. Você pode se conectar diretamente ao novo servidor integrado da sua comunidade sem configurar um ambiente de desenvolvimento local. Role a página para dar uma olhada :backhand_index_pointing_right:t2:

O que você pode fazer com isso?

Você pode pesquisar e ler tópicos, explorar categorias e tags, verificar perfis e atividades de usuários, e consultar seus marcadores e notificações. Com o acesso de escrita habilitado, seu aplicativo também pode criar tópicos, responder, editar posts, salvar rascunhos e enviar arquivos. As mensagens privadas (PMs) têm permissões de leitura e escrita separadas.

Por exemplo, você poderia pedir:

  • “Encontre discussões sobre a configuração de SSO e resuma as abordagens que as pessoas tentaram. Inclua links para os tópicos.”
  • “Leia este tópico e me explique como se eu tivesse cinco anos (ELI5)”
  • “Encontre meu rascunho salvo e me ajude a descobrir onde parei”

Também existem ferramentas para chat, eventos, reações, tópicos resolvidos e votação em tópicos quando os plugins e ferramentas MCP correspondentes estão habilitados.

Um ótimo recurso é o suporte para moderação e configurações do site. Colaboradores com acesso adequado podem inspecionar a fila de revisão, ler os detalhes por trás de uma sinalização, verificar revisões de posts e consultar o histórico de moderação de um usuário. Administradores também podem encontrar configurações do site e atualizar as configurações suportadas.

Quem pode acessar o quê?

Como administradores, você escolhe quais ferramentas seu site expõe e quais permissões cada grupo pode conceder a um aplicativo. As permissões de leitura e escrita são separadas, então você pode permitir pesquisa e leitura sem permitir alterações.

Os usuários fazem login no Discourse e aprovam o acesso solicitado pelo aplicativo. O aplicativo atua com as permissões normais do Discourse daquele usuário, dentro do acesso concedido a ele.

:warning: Conceder a um aplicativo a permissão para ler conteúdo não dá ao usuário acesso a conteúdo que ele não poderia ver antes. Todas as permissões típicas de aplicativos ainda se aplicam, independentemente dos escopos MCP permitidos ao usuário. Para repetir: Um usuário concedido o escopo de PM não será capaz de ver uma PM que ele não pode ver de outra forma no aplicativo. As ferramentas de configurações do site exigem uma conta de administrador, e os valores de configurações secretas não são expostos.

Você pode revisar aplicativos conectados e autorizações, revogar acesso, bloquear um cliente e inspecionar a atividade das ferramentas nas páginas administrativas do MCP. Os usuários também podem revogar suas próprias conexões em Preferências → Segurança → Aplicativos MCP.

Configuração

O servidor MCP está desabilitado por padrão. Em uma versão do Discourse que inclui este recurso:

  1. Vá para /admin/config/mcp e habilite mcp_server_enabled em Configurações.
  2. Em Capacidades, habilite as ferramentas que você deseja que seu site exponha. Novas ferramentas ficam desabilitadas até que você as habilite explicitamente.
  3. Em Acesso, escolha quais grupos podem se conectar e quais permissões eles podem conceder. O grupo de administradores é pré-registrado; adicione outros grupos conforme necessário.
  4. Conecte seu aplicativo de IA usando o endpoint do servidor mostrado em Visão Geral, tipicamente https://your-community.example/mcp.
  5. Faça login no Discourse e aprove o acesso solicitado.

Seu aplicativo precisa suportar MCP remoto via Streamable HTTP e OAuth. Alguns aplicativos podem se identificar automaticamente. Se seu aplicativo precisar de um cliente pré-registrado, use Clientes OAuth → Adicionar cliente OAuth e insira os detalhes correspondentes do cliente no seu aplicativo. O formulário inclui predefinições para aplicativos comuns.

A configuração mcp_oauth_client_id_metadata_policy controla se os aplicativos podem se identificar por meio de uma URL de metadados do cliente. Você pode permitir qualquer domínio, restringir isso a domínios aprovados ou exigir clientes pré-registrados.

Aqui está uma gravação completa [1] conectando o ChatGPT ao servidor MCP da Meta (disponível apenas para administradores) :video_camera:

Experimente :woman_technologist:t2:

Nos diga qual aplicativo você está usando e onde as ferramentas poderiam melhorar!

Há mais trabalho a caminho aqui:

  • mais escopos / ferramentas
  • e estamos explorando a criação de plugins oficiais para aplicativos bem conhecidos como ChatGPT, Claude, etc.

  1. Algumas partes aceleradas ↩︎

9 curtidas

Isso é ótimo. Acompanho o projeto desde seus primórdios nos repositórios. Sua publicação veio logo depois que encontrei problemas (provavelmente por falta de conhecimento da minha parte) ao tentar usar o cliente anterior a partir de um proxy para atender a finalidades semelhantes.

Vou usá-lo e, depois de fazer alguns testes, publicarei como funciona e qual é a experiência a partir do Pi, que é um harness leve, para aqueles de nós que preferem escolher o que usar, o que não usar e manter tudo leve.

Permitir que a equipe ative o servidor abre possibilidades extraordinárias que, de outra forma, seriam impossíveis de oferecer.

Parabéns à equipe!


Me pergunto se há planos para permitir que os usuários utilizem o servidor Meta MCP embutido?

Tenho alguns fluxos de trabalho, prompts e dicas gerais de uso que podem ser úteis para a comunidade, e o uso do servidor MCP pode simplificar o tempo necessário para publicar tudo isso.

2 curtidas

(publicação excluída pelo autor)