# Toolcape + Discord

O Toolcape conecta a IA existente da empresa aos seus sistemas por um único ponto de entrada MCP, com conexões de contas, permissões de grupos e pessoas e registros de auditoria. Esta documentação descreve um protótipo; não comprova a conexão de um servidor ou conta real.

## A conexão
Discord: Conversas em servidores e canais. Uma integração com o Discord usa uma conta de bot claramente identificada.
Tipo de conexão pendente de configuração
Conta de bot gerenciada por um administrador. As mensagens são enviadas como bot, e suas permissões nos canais determinam o acesso.
Status: proposta, requer implementação e verificação.

## Ações típicas
- Ler: Ler conversas nos canais aos quais o bot tem acesso
- Criar: Publicar respostas e atualizações como o bot
- Ler: Receber mensagens diretas enviadas ao bot
Conexão planejada. O bot age como ele mesmo, não como sua conta pessoal do Discord. O Discord proíbe self-bots que automatizam contas comuns fora da API aprovada de OAuth2/bots. O bot não pode ler outras conversas privadas suas. As permissões dos canais e os requisitos de conteúdo determinam o que ele pode ler.
Política de contas de bot do Discord: https://support.discord.com/hc/en-us/articles/115002192352-Automated-User-Accounts-Self-Bots
Permissões dos canais: https://docs.discord.com/developers/topics/permissions
Conteúdo das mensagens e intents: https://docs.discord.com/developers/events/gateway#message-content-intent

## Configuração
1. Crie um aplicativo Discord com uma conta de bot. Um administrador o instala no servidor desejado.
2. Permita apenas os canais e ações necessários, como ver um canal, ler o histórico e enviar mensagens.
3. Defina quais eventos e conteúdos o bot precisa acessar. Alguns exigem Message Content Intent e, quando aplicável, aprovação do Discord.
4. Configure a API do bot ou um adaptador MCP aprovado no Toolcape. Armazene o token no cofre de credenciais, nunca em um prompt para IA.
5. Conceda as permissões do Toolcape e teste em um canal. Confira se as mensagens identificam o bot e se os canais bloqueados continuam inacessíveis.

## Permissões
No acesso pessoal delegado, a conta do provedor, os escopos aprovados e as regras do Toolcape precisam permitir a ação. Contas compartilhadas e permissões de aplicativo podem ter outros limites. O Toolcape combina permissões de Todos e dos grupos; uma exceção pessoal substitui o acesso herdado naquele serviço. A leitura pode expor informações confidenciais. Compartilhamento, envio e exclusão exigem avaliação separada.

## Executar uma operação
Primeiro, descubra quais ferramentas o servidor Toolcape conectado realmente oferece. Se houver pesquisar → descrever → executar, encontre a operação, confira o esquema de entrada e as permissões e execute com dados validados. Os nomes variam por servidor; não invente nomes, argumentos, URLs ou resultados bem-sucedidos. Sem ferramentas conectadas, oriente a configuração em vez de afirmar que executou ações.

## Referência de operações
Catálogo de 16 de setembro de 2026. Verifique o esquema atual antes de executar.
- read — Ler conversas nos canais aos quais o bot tem acesso
  MCP 
  
- create — Publicar respostas e atualizações como o bot
  MCP 
  
- read — Receber mensagens diretas enviadas ao bot
  MCP 
  

## Uma boa primeira pergunta
Resuma as perguntas do canal de suporte.

## Se falhar
Verifique a conta, autorizações expiradas, aprovação do aplicativo, escopos do provedor e permissões do Toolcape. Envie ao suporte apenas erros sem dados sensíveis. Nunca cole senhas, tokens ou chaves secretas em uma conversa com IA.