Conecte um agente de IA com o servidor MCP (Enterprise)

O servidor MCP permite que um agente de IA externo opere a sua central de atendimento por meio de um token de bot com escopo limitado. É um endpoint do Model Context Protocol, então qualquer agente compatível com MCP (por exemplo, um bot OpenClaw) pode ler conversas, responder a elas, deixar notas privadas, rascunhar respostas para um humano aprovar, gerenciar contatos, iniciar novas conversas de saída e consultar um feed de eventos. Você o ativa em Configurações, cria um token e aponta o seu agente para a URL de conexão. O servidor MCP está disponível no plano Enterprise e durante o teste Enterprise de 7 dias com que toda conta nova começa.

Para que serve o servidor MCP?

É a ponte entre um agente de IA externo e o Deskwoot. Em vez de escrever a sua própria integração com a REST API, você conecta um cliente MCP e o agente recebe um conjunto definido de ferramentas que pode chamar. Pense nisso como dar a um bot uma chave de escopo limitado e revogável para uma parte específica da sua caixa de entrada, em vez de entregar um login. O agente atua por meio de uma identidade de bot, então as mensagens e notas dele são atribuídas a esse bot, não a um colega humano.

Como ativo o servidor MCP?

1. Vá em Configurações > Servidor MCP.
2. Ative o servidor MCP para o seu espaço de trabalho.
3. Crie um token de bot. Dê a ele um nome claro (por exemplo, bot de triagem OpenClaw) para que você possa reconhecê-lo depois.
4. Escolha os escopos que o token deve ter e limite-o a caixas de entrada específicas se o agente só precisar trabalhar em algumas delas.
5. Copie o token na hora. Por segurança, ele pode não ser exibido por completo de novo depois que você sair da página.

Qual é a URL de conexão?

Aponte o seu cliente MCP para:

https://<your-host>/api/mcp

Substitua <your-host> pelo seu próprio host do Deskwoot. Passe o token de bot do jeito que o seu cliente MCP espera (normalmente um token bearer no cabeçalho de autorização). Assim que o cliente se conectar, o agente verá as ferramentas que tem permissão de usar com base nos escopos do token.

O que um agente externo pode fazer pelo MCP?

Um agente conectado, dentro dos escopos que você concede, pode:

• Ler conversas e suas mensagens.
• Responder a conversas.
• Adicionar notas privadas que só a sua equipe vê.
• Criar rascunhos de resposta que um colega humano revisa e envia.
• Ler, criar e atualizar contatos.
• Iniciar conversas de saída.
• Consultar um feed de eventos para reagir a novas atividades.

O que ele não pode fazer?

O servidor MCP é deliberadamente restrito. Ele não expõe as configurações do seu espaço de trabalho, a cobrança ou qualquer ação destrutiva. Especificamente, um token de bot não pode alterar configurações, mexer na cobrança, excluir registros, enviar transmissões ou gerenciar webhooks. Se o seu agente precisar fazer algo fora desse limite, o servidor MCP não vai fazer, e isso é proposital.

Como funcionam os escopos e os limites de caixa de entrada?

Cada token carrega um conjunto de escopos que decide quais ferramentas o agente pode chamar. Conceda apenas o que o agente realmente precisa. Um bot que rascunha respostas para aprovação humana não precisa de permissão para enviar mensagens por conta própria, por exemplo. Além dos escopos, você pode restringir um token a caixas de entrada específicas, então um agente que cuida da sua caixa de cobrança nunca vê conversas de outra. Se um token vazar ou você parar de usar um agente, revogue-o em Configurações > Servidor MCP e o acesso some na hora.

Quais planos incluem o servidor MCP?

O servidor MCP é um recurso do Enterprise. Ele também está disponível durante o teste Enterprise de 7 dias, para que você possa configurar e testar um agente antes de assinar um plano pago. Se você precisa de acesso programático sem o MCP, a REST API cobre os mesmos dados e também é um recurso do Enterprise (os tokens de API exigem um plano Enterprise pago; o teste não os inclui), com tokens gerenciados em Configurações > Tokens de API.

Perguntas frequentes