Servidor MCP
O Waiso é um servidor MCP. Um cliente de IA que fala o Model Context Protocol pode listar seus projetos, escrever e rodar scripts, montar flows, ler execuções, configurar agendamentos e mais — como você, e nunca além do que o token que você deu permite. Você pode acompanhar ao vivo no app o que ele faz enquanto trabalha.
- Criar um token MCP e escolher o escopo dele
- Conectar cada cliente suportado com o comando que o diálogo entrega
- Saber o que um agente pode e não pode fazer pelas ferramentas
- Acompanhar ao vivo as ações de um agente e revogar o acesso dele
Um agente com uma chave só dele
O servidor fica em <endereço do seu Waiso>/mcp e fala MCP por HTTP com streaming. Toda requisição leva um token de acesso MCP no cabeçalho Authorization: Bearer …. Um token pertence a uma pessoa e age como ela, então o agente nunca faz mais do que o dono pode fazer num projeto — e o escopo do token estreita isso ainda mais.
| Ajuste do escopo | O que decide |
|---|---|
| Projetos | Quais projetos o token alcança; qualquer outro projeto não existe para ele. |
| Somente leitura / Leitura + escrita | Por projeto: se o agente só pode olhar ou também criar, alterar e executar. |
| Tópicos | Opcionalmente só algumas áreas dentro de um projeto: Scripts, Flows, Agendamentos, Variáveis, Integrações, Robôs, API, E-mail. |
| Ver e criar projetos | Deixa o token listar todos os seus projetos e criar novos. Sem isso, ele só vê os projetos ligados. |
Crie um token e conecte um cliente
- Abra Tokens MCP
Em Configurações, abra Tokens MCP e clique em Criar o primeiro token (ou no botão de novo token).
- Dê um nome e escolha o escopo
Dê um nome que você reconheça depois, como Claude Code — laptop, uma validade (ou Nunca expira) e ligue os projetos que ele pode alcançar com a permissão de cada um.
- Copie o token uma vez
Clique em Gerar token. O token aparece uma vez — Copie este token agora — ele não será mostrado de novo.
- Cole o comando do cliente
O mesmo diálogo mostra o comando ou a configuração exata de cada cliente, já com o token preenchido. Escolha a aba do seu cliente e copie.
Estes são os quatro trechos, com o seu endereço e o seu token no lugar dos marcadores.
claude mcp add --transport http waiso https://waiso.example.com/mcp --header "Authorization: Bearer <token>"O que um agente pode fazer
As ferramentas cobrem o produto: criar e rodar scripts e flows, ler execuções e os logs delas, gerenciar agendamentos, variáveis, endpoints de API, integrações e templates de e-mail, e usar também os recursos mais novos — state_get / state_set para o estado de scripts, alerts_list / alert_rule_create para os alertas e git_status / git_commit_push / git_pull para o Git.
Toda chamada é conferida
Cada chamada de ferramenta passa pela mesma conferência antes de rodar: o projeto precisa estar no escopo do token, a permissão precisa cobrir uma escrita, a área precisa ser um dos tópicos do token e a pessoa dona do token precisa ter o acesso naquele projeto. Uma recusa diz o que falta, por exemplo this token's scope for project … is read-only.
Acompanhe e revogue
- Enquanto um cliente age na sua conta, a barra do topo mostra MCP ativo. Clique para acompanhar: o app abre o que o agente está fazendo — Trabalhando no script, Trabalhando no flow, Executando — e Sair para de acompanhar.
- Cada token mostra quando foi usado pela última vez. Um token nunca usado mostra Nunca usado.
- Excluir um token para ele na hora: qualquer cliente que o use perde o acesso na próxima chamada.