---
url: https://next.zammad.org/pt_BR/documentation/use/guides/mcp-server.md
---

# Servidor MCP

O Zammad tem seu próprio servidor para o *Model Context Protocol*
(MCP). Conecte a ele um cliente de IA que você já usa, por exemplo um
aplicativo de chat ou uma ferramenta de programação, e leia, encontre e
atualize seus tickets a partir dali. O servidor faz parte de toda
instalação: você não instala nem executa nada além disso.

Se o servidor aceita conexões é uma decisão do seu administrador. Se uma
conexão com `https://zammad.example.com/mcp` falhar, pergunte ao seu
administrador se o servidor está ativado.

## Conectar um cliente de IA

A conexão exige um token de acesso pessoal e o endereço do servidor no seu
cliente.

### Criar um token de acesso pessoal

O cliente se conecta com um token de acesso pessoal da sua conta. Abra seu
perfil e a seção `Token access` dele (veja [configurações
pessoais](/pt_BR/documentation/use/personal-settings#token-access)) e crie
um token com a permissão `ticket.agent`, para que o cliente possa trabalhar
com tickets. Você pode dar uma data de expiração ao token. Copie o token que
o Zammad mostra quando o token é criado.

### Adicionar o Zammad ao seu cliente

Adicione o Zammad ao cliente como servidor MCP. O cliente precisa do
transporte MCP *Streamable HTTP* e da capacidade de enviar um cabeçalho fixo
`Authorization: Bearer` em toda requisição. Suportar só o transporte não
basta. Uma configuração assim pede as mesmas três informações:

* o endereço do servidor: o domínio pelo qual você abre o Zammad, seguido de
  `/mcp`, como em `https://zammad.example.com/mcp`
* o transporte, *Streamable HTTP*
* o token, enviado como cabeçalho HTTP em toda requisição: `Authorization:
  Bearer {your_token}`

Clientes que leem uma configuração JSON, como muitos fazem, recebem o Zammad
como servidor com o endereço e o cabeçalho. Substitua `zammad.example.com`
pelo domínio com que você abre o Zammad e `{your_token}` pelo token que você
copiou:

```json
{
  "mcpServers": {
    "zammad": {
      "type": "http",
      "url": "https://zammad.example.com/mcp",
      "headers": {
        "Authorization": "Bearer {your_token}"
      }
    }
  }
}
```

::: warning
O token funciona como a sua senha. Não o coloque em um arquivo de configuração que outras pessoas possam ler ou que acabe em um
repositório. Mantenha o arquivo privado, ou use a referência a um segredo armazenado, se o seu cliente oferecer suporte.
:::

Outros clientes pedem as mesmas três informações em seu próprio
formato. Quando a conexão funcionar, um primeiro pedido como "Mostre meus
tickets atribuídos" mostra se o cliente alcança o Zammad.

O Zammad só responde no endereço para o qual está configurado, aquele com
que você abre o Zammad. Se a conexão falhar, confira se o cliente usa
exatamente esse endereço.

## O que o cliente pode fazer

O cliente conectado trabalha com as suas permissões: ele pode fazer
exatamente o que o token e a sua conta podem fazer, nada além disso, e
registra as alterações dele como feitas por você. Um usuário sem permissão
de agente, como um cliente, não recebe nenhuma ferramenta do servidor. A
lista completa das ferramentas, com o acesso e os limites de cada uma, está
na referência [ferramentas do servidor MCP](/pt_BR/reference/mcp-tools).

* Abrir um ticket pelo número, pelo ID ou por um link colado, e ler as
  mensagens, notas internas, anexos, histórico e rascunho compartilhado
  dele.
* Ler o cliente e a organização de um ticket.
* Encontrar tickets por palavras e por nomes, como o cliente, a organização,
  o estado, o responsável, o grupo ou a prioridade de um ticket.
* Listar suas próprias visões gerais e os tickets delas, e ordenar as
  listas, por exemplo por criação ou última atualização, para que o cliente
  possa começar pelo ticket mais antigo.
* Pesquisar usuários, organizações e a base de conhecimento.
* Ler o texto de arquivos anexados a uma mensagem: arquivos de texto de até
  10 MB; os demais arquivos voltam como um link para download.
* Alterar atributos de ticket, definir tags e adicionar notas internas.
* Salvar e enviar rascunhos compartilhados, e vincular tickets e respostas
  da base de conhecimento.
* Criar tickets e escrever mensagens.

Mensagens, notas e rascunhos podem ser escritos em texto simples ou em
HTML. O Zammad remove do HTML a marcação insegura. SMS, Telegram, WhatsApp e
Facebook aceitam apenas texto simples; HTML é recusado nesses canais. Não é
possível enviar arquivos pelo cliente: se quiser enviar um, adicione-o à
mensagem no próprio Zammad.

Quando um ticket pede contabilização de tempo, o cliente pergunta o tempo a
você e o registra. Você também pode dizer que não vai contabilizar tempo, e
o Zammad então registra a mensagem sem tempo contabilizado.

## Aprovação de mensagens enviadas

Quando o cliente consegue exibir, o Zammad pede que você aprove uma mensagem
antes que ela chegue a um cliente. O pedido de aprovação mostra o texto
completo da mensagem, os destinatários e a visibilidade, e o Zammad só envia
depois que você aceita.

Se você recusar, o Zammad não envia nada e não altera nada no ticket. O
cliente pode então oferecer salvar o texto como rascunho compartilhado do
ticket, onde o grupo permitir rascunhos compartilhados, para que você o
envie pelo próprio Zammad.

Um cliente que não consegue exibir o formulário de aprovação depende da sua
própria aprovação da chamada de ferramenta, como faz para toda alteração, e
o Zammad não pergunta uma segunda vez. O Zammad ainda quer o seu "sim" para
duas alterações: substituir um rascunho compartilhado já salvo e fechar um
ticket cujo checklist está incompleto. Mantenha ativada no seu cliente a
aprovação de chamadas de ferramenta, porque um cliente que as executa sem
perguntar envia uma mensagem sem nenhuma confirmação adicional.
