---
title: "MCP: conecte o Claude e outros assistentes de IA ao mssgs"
description: "Conecte o Claude, o Cursor e outras ferramentas de IA ao mssgs via MCP. Um servidor local com permissões e 127 ferramentas: canais, mensagens, bots e moderação."
canonical: https://docs.mss.gs/pt/mcp
language: pt
---

# 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 resume** Canais, DMs, menções e mensagens fixadas, só nos canais que você expuser.

- **Escreve quando você permite** Envia, responde, reage, edita e fixa, depois que você ativa o envio.

- **Joga** Aceita um convite, lê o tabuleiro e faz jogadas de verdade.

- **Você no controle** Desativado por padrão, primeiro só leitura, apenas local, um token revogável para cada ferramenta de IA.

No app

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](#overview)

- [Conexão](#connect)

- [Permissões e tokens](#permissions)

- [Eventos em tempo real](#events)

- [Ferramentas](#tools)

## 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

Autenticado com um token Bearer da [página de configurações AI / MCP](https://mss.gs/pt/help/bots-mcp/connect-your-ai) 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.

```bash
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](https://mss.gs/pt/help/bots-mcp/connect-your-ai) 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](https://docs.mss.gs/pt/bots).

## 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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