Desenvolvedores MCP

Conecte um assistente de IA

O app para computador do mssgs tem um servidor MCP integrado. Conecte o Claude, o Cursor ou o Codex e eles podem ler, resumir e responder nos canais que você escolher, direto do seu computador.

O que você pode fazer

Lê e resumeCanais, DMs, menções e mensagens fixadas, só nos canais que você expuser.
Escreve quando você permiteEnvia, responde, reage, edita e fixa, depois que você ativa o envio.
JogaAceita um convite, lê o tabuleiro e faz jogadas de verdade.
Você no controleDesativado por padrão, primeiro só leitura, apenas local, um token revogável para cada ferramenta de IA.

No app

> Resuma o #general em três tópicos e publique no #daily

● read_channel (channel: "general", limit: 50)

● send_message (channel: "daily")

Publicado no #daily.

daily

maya09:31

Resumo do #general de hoje:
• O lançamento passou para sexta-feira.
• A Dani cuida das notas de versão.
• A reunião diária agora é às 09:30.

Você pede na sua ferramenta de IA; ela lê o #general pelo servidor MCP e publica o resumo como você, porque você permitiu o envio.

Visão geral

O app para computador do mssgs traz um servidor MCP (Model Context Protocol) integrado, para que assistentes de IA como o Claude ou o Cursor possam ler e agir no seu espaço de trabalho. Ele roda localmente na sua máquina e conversa com a sua sessão do mssgs já conectada; não é preciso uma conta de bot separada nem hospedagem.

Você decide o que ele vê

O servidor roda só em localhost, enquanto o mssgs está aberto e você está conectado. Você escolhe quais canais expor e ativa, grupo por grupo, o que o assistente pode fazer. Hoje são 127 ferramentas em 14 grupos.

Conexão

MCP http://127.0.0.1:7444/mcp

Autenticado com um token Bearer da página de configurações AI / MCP do app: ative o servidor, escolha os canais a expor e clique em "Copy config"; o bloco copiado já contém sua porta e seu token. O servidor escuta só em localhost (porta padrão 7444) e roda enquanto o mssgs está aberto e você está conectado.

Conecte o Claude Code

claude mcp add --transport http mssgs http://127.0.0.1:7444/mcp \
  --header "Authorization: Bearer <your-token>"

No Claude Desktop ou no Cursor: cole o bloco do "Copy config" nas configurações de MCP da sua ferramenta de IA. Veja o guia passo a passo na Central de ajuda.

Permissões e tokens

As ferramentas que um assistente vê dependem das opções que você ativa. As ferramentas só de leitura estão sempre ativas; todo o resto fica atrás da opção de um grupo. O gerenciamento de servidor e a moderação também verificam as suas permissões reais na conta.

Grupo	Libera
Leitura	Sempre ativo: ler mensagens, presença, menções e fixados nos canais expostos
Envio e interação	Enviar, responder, reagir, editar, apagar, fixar, digitação, além de presença em DMs, chamadas de voz e jogos
Watch parties	Iniciar, entrar e controlar sessões para assistir juntos
Pedidos de DM	Ver, aceitar e recusar pedidos de DM recebidos
Social	Perfis, stories e os seus filtros do mapa
Canais de voz	Entrar em canais de voz, ver os participantes e controlar seu microfone
Conta e privacidade	Amigos, bloqueios, silenciamentos, estado de leitura, clipes e compartilhamento de localização
Controle de agentes	Configurar os agentes do canal, projetos e tarefas ao vivo
Gerenciamento de servidor	Canais, categorias, grupos de permissão, membros, convites, emojis, webhooks e triggers (as permissões reais de gerenciamento continuam valendo)
Moderação da comunidade	Filas de revisão e votos (continua sendo necessária uma conta de moderador ou da equipe)
Manter o computador acordado	Impede que a máquina durma enquanto o assistente trabalha
Ferramentas de conta de bot	Cartões embed interativos e os eventos deles (só contas de bot)

Tokens

Os tokens têm nome, são separados por ferramenta de IA e podem ser revogados com um clique, com um gráfico de atividade por token para você ver exatamente quando cada um foi usado. Boa prática: um token por ferramenta, com um nome claro. Perdeu o notebook? Revogue o token dele e ele não serve para mais nada.

Eventos em tempo real via SSE

Abra o endpoint MCP como stream (GET /mcp com Accept: text/event-stream) e você recebe notificações JSON-RPC à medida que as coisas acontecem:

Notificação	Disparada quando
`notifications/mssgs/message`	Novas mensagens nos canais que você pode ver
`notifications/mssgs/bot_event`	Cliques em botões, reações e respostas às mensagens que seu assistente publicou via send_bot_message
`notifications/mssgs/presence`	Mudanças de presença
`notifications/mssgs/typing`	Indicadores de digitação
`notifications/mssgs/call`	Eventos de chamada de voz

Cartões de bot interativos

Cartões de bot interativos a partir do seu assistente

Publique um cartão embed com botões via send_bot_message, escute bot_event no stream (ou consulte get_bot_events) e atualize o cartão no lugar com edit_message. É o mesmo modelo de cartão da documentação de mensagens de bot.

Referência de ferramentas (127)

Cada ferramenta abaixo é uma ação real no mssgs. Os nomes são os identificadores MCP exatos. As ferramentas só aparecem depois que o grupo delas é ativado.

Leitura

Sempre ativo

Ferramentas só de leitura, disponíveis assim que o servidor é ligado. Elas só enxergam os canais que você expôs.

Ferramenta	O que faz
`list_channels`	Lista os canais que você expôs às ferramentas de IA.
`read_channel`	Lê as mensagens recentes de um canal exposto.
`get_new_messages`	Busca mensagens mais novas que um timestamp em todos os canais expostos.
`get_channel_stamp`	O estado de lido/não lido de um canal, com a contagem de não lidas e de menções.
`get_presence`	Quem está presente num canal e com qual status.
`get_message`	Busca uma mensagem completa pelo id, incluindo embeds e prévias de links.
`search_messages`	Pesquisa o texto das mensagens nos canais expostos de um servidor.
`get_message_context`	Lê as mensagens logo antes e depois de um resultado da pesquisa.
`get_account`	Mostra a conta conectada e os recursos disponíveis para ela.
`get_typing`	Quem está digitando num canal agora.
`list_mentions`	Mensagens recentes que @mencionam você.
`list_pinned_messages`	As mensagens fixadas de um canal.
`subscribe_channel`	Assina um canal para receber atualizações em tempo real.
`unsubscribe_channel`	Para as atualizações em tempo real de um canal.
`list_subscriptions`	Lista os canais que você assina em tempo real.

Envio e interação

Opção de envio

Publica e age como o usuário conectado. Tudo aqui escreve num canal, por isso fica atrás de uma única opção.

Ferramenta	O que faz
`send_message`	Envia uma mensagem para um canal como você.
`reply_message`	Responde a uma mensagem específica, em thread.
`add_reaction`	Adiciona uma reação com emoji a uma mensagem.
`remove_reaction`	Remove uma das suas reações com emoji.
`edit_message`	Edita uma das suas mensagens.
`delete_message`	Apaga uma das suas mensagens.
`pin_message`	Fixa uma mensagem (requer permissão para fixar).
`unpin_message`	Desafixa uma mensagem fixada.
`open_one_view_attachment`	Abre uma foto ou um vídeo de visualização única numa DM.
`set_typing`	Mostra um indicador "digitando…" ao vivo.
`stop_typing`	Remove o indicador de digitação.

Presença em DMs e chamadas

Opção de envio

Esteja presente numa DM e faça chamadas de voz de verdade: start_dm_call usa o microfone deste computador, exatamente como apertar o botão de chamada no app.

Ferramenta	O que faz
`enter_dm_chat`	Mostra você como presente numa DM.
`leave_dm_chat`	Deixa de mostrar você como presente numa DM.
`start_dm_call`	Inicia uma chamada de voz numa DM (usa o microfone deste computador).
`answer_dm_call`	Atende uma chamada de DM que está tocando.
`decline_dm_call`	Recusa uma chamada de DM que está tocando.
`end_dm_call`	Desliga ou cancela uma chamada de DM.
`get_call_status`	O estado atual da chamada de voz e qualquer chamada recebida.

Jogos

Opção de envio

Entre nos minijogos integrados do mssgs e jogue direto do seu assistente.

Ferramenta	O que faz
`list_game_invites`	Convites de jogo abertos endereçados a você.
`list_active_games`	Salas de jogo em que você está jogando agora.
`accept_game_invite`	Aceita um convite pelo room_id ou pelo código de entrada.
`get_game_state`	O tabuleiro e o estado ao vivo de um jogo em que você está.
`game_move`	Joga uma rodada num jogo.
`resign_game`	Desiste ou sai de um jogo.

Watch parties

Opção de watch parties

Inicie e controle sessões para assistir juntos, entre na sala e reajam juntos em tempo real.

Ferramenta	O que faz
`list_watch_parties`	Lista as watch parties ativas que você pode acessar.
`get_watch_party`	Busca o estado completo de uma watch party.
`start_watch_party`	Inicia uma watch party num canal.
`join_watch_party`	Entra numa watch party ativa.
`leave_watch_party`	Sai de uma watch party.
`control_watch_party`	Reproduz, pausa ou avança para a sala inteira.
`end_watch_party`	Encerra uma watch party para todos.
`send_watch_party_emote`	Envia um emote em tempo real para a watch party.

Pedidos de DM

Opção de pedidos de DM

Decida quem pode começar uma conversa com você.

Ferramenta	O que faz
`view_dm_requests`	Seus pedidos de DM recebidos e em aberto.
`accept_dm_request`	Aceita um pedido de DM.
`deny_dm_request`	Recusa um pedido de DM.

Social: perfis, stories, mapa

Opção social

Consulte perfis, veja stories e confira os filtros do mapa que você enviou.

Ferramenta	O que faz
`get_profile`	O perfil público de um usuário pelo user_guid.
`list_story_users`	Pessoas com um story não visto que você pode ver.
`view_story`	Mostra os stories ativos de um usuário.
`list_map_filters`	Filtros do mapa que esta conta enviou, com o estado da moderação.

Canais de voz

Opção de voz

Veja e controle a sessão de canal de voz ao vivo deste computador.

Ferramenta	O que faz
`list_voice_channels`	Lista os canais de voz de um servidor.
`get_voice_state`	Busca a sessão de voz atual e os participantes.
`join_voice_channel`	Entra num canal de voz neste computador.
`leave_voice_channel`	Sai do canal de voz atual.
`set_voice_muted`	Silencia ou reativa o microfone deste computador.

Conta e privacidade

Opção de conta

Gerencie amigos, bloqueios, silenciamentos, o estado de leitura e clipes sem expor segredos da conta.

Ferramenta	O que faz
`list_friends`	Lista seus amigos.
`list_blocked`	Lista as contas que você bloqueou.
`block_user`	Bloqueia uma conta.
`unblock_user`	Desbloqueia uma conta.
`list_mutes`	Lista os canais e servidores silenciados.
`mute_channel`	Silencia um canal.
`unmute_channel`	Reativa o som de um canal.
`mute_server`	Silencia um servidor.
`unmute_server`	Reativa o som de um servidor.
`mark_channel_read`	Marca um canal como lido.
`list_clips`	Lista os clipes que você criou.
`share_clip`	Torna um dos seus clipes compartilhável.
`unshare_clip`	Para de compartilhar um clipe.
`rename_clip`	Renomeia um dos seus clipes.
`list_stickers`	Lista as figurinhas disponíveis para você.
`list_friend_locations`	Lista os amigos que estão compartilhando a localização com você agora.
`list_location_viewers`	Lista quem pode ver a sua localização agora.

Ferramentas de conta de bot

Opção de bot · só contas de bot

Publique cartões embed interativos e leia as interações com eles. Disponível quando você está conectado com uma conta de bot.

Ferramenta	O que faz
`send_bot_message`	Publica um cartão embed rico com botões opcionais (só contas de bot).
`get_bot_events`	Consulta cliques em botões, reações e respostas às mensagens do seu bot.
`set_bot_status`	Define ou remove um status de presença personalizado (só contas de bot).

Controle de agentes

Opção de controle de agentes

Configure os agentes de um canal, vincule projetos, acompanhe tarefas ao vivo e direcione o trabalho pelo chat. As ações de gerenciamento continuam exigindo permissões no canal.

Ferramenta	O que faz
`list_agent_channels`	Lista os canais expostos e a configuração de agentes deles.
`get_channel_agents`	Busca a configuração completa de agentes de um canal.
`set_channel_agents`	Ativa os agentes e atualiza as regras de agentes de um canal.
`add_channel_agent`	Adiciona um agente disponível a um canal.
`remove_channel_agent`	Remove um agente de um canal.
`set_agent_project`	Vincula um projeto e instruções a um agente do canal.
`remove_agent_project`	Desvincula um projeto de um agente do canal.
`list_agent_tasks`	Lista as tarefas de agentes atuais e recentes.
`get_agent_task`	Busca o estado ao vivo e a saída de uma tarefa de agente.
`steer_agent_task`	Envia uma instrução complementar para uma tarefa de agente em andamento.

Gerenciamento de servidor

Opção de gerenciamento de servidor · requer permissões de gerenciamento

Molde um servidor que você gerencia: canais, categorias, grupos de permissão, webhooks e triggers. Cada chamada continua verificando as suas permissões reais de gerenciamento nesse servidor.

Ferramenta	O que faz
`list_manageable_servers`	Servidores que você pode gerenciar e quais permissões você tem neles.
`get_server_structure`	O layout completo de canais e categorias de um servidor.
`create_channel`	Cria um canal.
`update_channel`	Renomeia, muda o tipo ou move um canal.
`delete_channel`	Apaga um canal (irreversível).
`create_category`	Cria uma categoria de canais.
`update_category`	Renomeia uma categoria.
`delete_category`	Apaga uma categoria (os canais dela continuam).
`list_server_groups`	Os grupos de permissão de um servidor.
`create_server_group`	Cria um grupo de permissão.
`update_server_group`	Renomeia, muda a cor ou o escopo de um grupo de permissão.
`delete_server_group`	Apaga um grupo de permissão.
`list_members`	Lista os membros do servidor e os grupos de permissão deles.
`add_member_to_group`	Adiciona um membro do servidor a um grupo de permissão.
`remove_member_from_group`	Remove um membro do servidor de um grupo de permissão.
`list_invites`	Lista os convites ativos do servidor.
`create_invite`	Cria um convite para o servidor.
`delete_invite`	Revoga um convite do servidor.
`list_custom_emojis`	Lista os emojis personalizados de um servidor.
`list_webhooks`	Os webhooks de entrada de um servidor.
`create_webhook`	Cria um webhook de entrada.
`get_webhook_url`	Busca a URL de um webhook para onde se pode publicar.
`update_webhook`	Atualiza as configurações de um webhook.
`delete_webhook`	Apaga um webhook (a URL dele para de funcionar).
`list_triggers`	Os triggers de saída de um servidor.
`create_trigger`	Cria um trigger (mensagens que batem com ele são enviadas por POST para uma URL).
`update_trigger`	Atualiza um trigger.
`delete_trigger`	Apaga um trigger.

Moderação da comunidade

Opção de moderação · só moderadores e equipe

As mesmas filas de revisão que o botão de escudo abre no app. Votos e vetos continuam exigindo uma conta real de moderador (ou da equipe).

Ferramenta	O que faz
`get_moderation_stats`	Seu status de moderação e quanto está esperando.
`list_moderation_queue`	Filtros do mapa esperando o voto de um moderador.
`approve_map_filter`	Vota para aprovar um filtro do mapa enviado.
`deny_map_filter`	Vota para recusar um filtro do mapa enviado.
`list_report_queue`	Conteúdo denunciado esperando o voto de um moderador.
`approve_report`	Vota que uma denúncia viola as regras.
`deny_report`	Vota que o conteúdo denunciado está ok.
`community_map_propose_filter`	Envia um novo filtro do mapa para revisão.
`veto_map_filter`	Só a equipe: tira um filtro do mapa do ar na hora (irreversível).

Utilitários

Opção de manter acordado

Pequenas ajudas para assistentes que trabalham por muito tempo.

Ferramenta	O que faz
`keep_computer_awake`	Mantém este computador acordado enquanto você trabalha, ou libera.

Continue criando

AgentesDeixe uma IA assumir tarefas dentro de um canal. WebhooksPublique num canal a partir de um script. Conecte sua IAA configuração, passo a passo, na Central de ajuda. Cartões de mensagemO que uma mensagem de bot pode mostrar.