Referência
Toolsets e modo somente leitura
Carregue só as ferramentas MCP do Emailit de que você precisa com toolsets, ou oculte todas as ferramentas de escrita com o modo somente leitura, por opções na URL ou cabeçalhos.
Alguns clientes carregam um número limitado de ferramentas, e listas de ferramentas menores deixam os assistentes mais rápidos e precisos. Passe opções na URL do servidor ou como cabeçalhos para escolher o que o servidor expõe.
| Opção | Parâmetro de consulta | Cabeçalho | Valores |
|---|---|---|---|
| Toolsets | toolsets |
X-MCP-Toolsets |
Nomes de toolsets separados por vírgula, ou all |
| Modo somente leitura | read_only |
X-MCP-Readonly |
true, 1, yes ou on |
Quando os dois são definidos, os cabeçalhos têm prioridade sobre os parâmetros de consulta.
Exemplos
https://api.emailit.com/mcp?toolsets=emails,domains,events
https://api.emailit.com/mcp?read_only=true
https://api.emailit.com/mcp?toolsets=emails,domains&read_only=trueA última URL dá ao assistente acesso de leitura apenas a e-mails e domínios: ele pode consultar entregas e registros DNS, mas não pode enviar nem alterar nada.
Toolsets
| Toolset | Abrange |
|---|---|
emails |
Enviar, listar, ler, reagendar, cancelar, tentar de novo e encaminhar e-mails |
domains |
Domínios de envio e verificação de DNS |
dmarc |
Relatórios DMARC agregados e forenses e estatísticas |
templates |
Templates, versões e publicação |
api_keys |
Chaves de API |
audiences |
Listas de contatos e os inscritos delas |
contacts |
Contatos, tags, pontuações de lead, ações em massa e exportação |
segments |
Segmentos, os contatos e o crescimento deles. Alfa: listado apenas para a equipe do Emailit. |
suppressions |
A lista de supressão |
webhooks |
Webhooks, testes, segredos e novas tentativas |
campaigns |
Campanhas, as configurações delas, testes A/B e estatísticas |
commerce |
Produtos, pedidos, carrinhos, cupons, configurações de e-commerce e as compras de um contato. Alfa: listado apenas para a equipe do Emailit. |
automations |
Automações, execuções, cancelamento de execuções e estatísticas |
global_values |
Valores globais do workspace usados como {{global.<key>}} |
forms |
Formulários de inscrição |
verification |
Verificação de e-mails e listas de verificação |
events |
O fluxo de eventos do workspace, o envio de eventos e os tipos de eventos do workspace |
O toolset workspace (get-current-workspace, list-workspaces, switch-workspace, create-workspace) é sempre incluído. Nomes de toolsets desconhecidos são ignorados; se nenhum dos nomes for válido, todos os toolsets são carregados.
Modo somente leitura
O modo somente leitura mantém as ferramentas do tipo Leitura e oculta tudo o que cria, atualiza, exclui, envia ou chama uma URL externa. switch-workspace continua disponível porque só altera o workspace padrão da conexão. Veja o tipo de cada ferramenta na referência de ferramentas.
O modo somente leitura é um bom padrão para assistentes de análise e para experimentar um cliente novo.