Servidor MCP: conecte um assistente de IA

O servidor MCP do WbizTool permite que um assistente de IA trabalhe com o seu espaço de trabalho. Você pode pedir coisas como "quais mensagens falharam hoje, e por quê?", "pause o lembrete do aluguel" ou "envie nosso novo horário de funcionamento para estes cinco clientes", e ele usa a sua conta do WbizTool para fazer isso.

Ele fala o Model Context Protocol (MCP), que Claude Code, Cursor, VS Code e outras ferramentas de IA entendem. Por trás, cada ação é uma chamada à API v2 feita com a sua própria chave de API v2, então é a chave que decide o que o assistente pode ver e fazer.

O que um assistente pode fazer#

O assistente só vê as ferramentas que a chave permite (veja as permissões):

Ele também oferece três prompts prontos: Daily summary (resumo diário), Failed messages (mensagens que falharam) e Draft an announcement (rascunhar um comunicado).

Ele não consegue conectar um número novo (isso continua no seu painel), enviar arquivos, gerenciar webhooks nem ler a sua caixa de entrada do Unibox.

1. Crie uma chave para o assistente#

1. Abra o cartão Chaves de API v2

   No WbizTool, acesse Configurações → Chaves de API e encontre o cartão Chaves de API v2.

2. Use a predefinição para assistente de IA

   Clique em Criar chave v2 e depois em Para um assistente de IA. Isso cria uma chave Somente leitura que pode ler mensagens e números e expira em 90 dias – um jeito seguro de começar: o assistente pode olhar, mas não pode enviar nem alterar nada.

3. Permita o envio só se quiser

   Se o assistente deve enviar mensagens ou gerenciar lembretes, desmarque Somente leitura e marque Enviar mensagens (e Lembretes, se precisar). Você também pode limitar a chave a alguns dos seus números.

4. Copie a chave

   A chave (wbz_live_…) é exibida uma única vez. Guarde-a em uma variável de ambiente no seu computador, como WBIZTOOL_API_KEY – nunca a cole em um arquivo que você compartilha ou faz commit.

export WBIZTOOL_API_KEY=wbz_live_…

2. Adicione o servidor à sua ferramenta de IA#

claude mcp add --transport http wbiztool https://mcp.wbiztool.com/mcp \
  --header "Authorization: Bearer ${WBIZTOOL_API_KEY}"

{
  "mcpServers": {
    "wbiztool": {
      "type": "http",
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${WBIZTOOL_API_KEY}" }
    }
  }
}

{
  "mcpServers": {
    "wbiztool": {
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${env:WBIZTOOL_API_KEY}" }
    }
  }
}

{
  "inputs": [
    { "type": "promptString", "id": "wbiztool-key", "description": "WbizTool API v2 key (wbz_live_…)", "password": true }
  ],
  "servers": {
    "wbiztool": {
      "type": "http",
      "url": "https://mcp.wbiztool.com/mcp",
      "headers": { "Authorization": "Bearer ${input:wbiztool-key}" }
    }
  }
}

• Claude Code: execute o comando uma vez (adicione --scope project para compartilhá-lo com um projeto por meio do .mcp.json; o arquivo guarda ${WBIZTOOL_API_KEY}, não a chave).
• Cursor: coloque-o em ~/.cursor/mcp.json, ou em .cursor/mcp.json dentro de um projeto.
• VS Code: coloque-o em .vscode/mcp.json. O VS Code pede a chave uma vez e a guarda no armazenamento de segredos dele.

Depois, pergunte ao assistente algo como "Qual é a minha conta do WbizTool?" – ele deve responder com o nome e o plano do seu espaço de trabalho.

3. Como os envios continuam seguros#

• Todo envio passa por uma prévia antes. Quando você pede uma mensagem, o assistente primeiro recebe uma prévia do WbizTool – de qual número ela sai, para quem vai, o texto exato, o arquivo, se houver, e quando – e nada foi enviado ainda. Ele é instruído a mostrar essa prévia a você e esperar o seu sim. Só então ele envia, exatamente com o que você viu.
• Uma nova tentativa nunca envia duas vezes. Se o assistente repetir um envio confirmado (por exemplo, depois de um tempo esgotado), o WbizTool responde com a mensagem que já enviou.
• A chave é o limite rígido. Uma chave somente leitura não consegue enviar nada. Uma chave sem Enviar mensagens nem chega a ver as ferramentas de envio, e uma chave limitada a alguns números não pode usar os outros. Os limites do próprio WbizTool também valem: 60 requisições por minuto por chave e no máximo 1.000 mensagens por dia por número.
• Texto de outras pessoas é marcado como dado. Mensagens, nomes e arquivos que vieram de fora chegam ao assistente marcados como não confiáveis, e ele é instruído a nunca seguir instruções que estejam dentro deles.
• Nenhum segredo nas respostas. Códigos QR e códigos de login nunca são exibidos, e as listas não incluem links de arquivos.
• Revogue quando quiser. Revogar a chave em Configurações → Chaves de API para o assistente na hora.

Privacidade#

Quando você conecta um assistente, o que ele lê do WbizTool (mensagens, nomes e números que você deixa a chave ver) é enviado ao provedor desse assistente – por exemplo, a Anthropic para o Claude ou a OpenAI para o ChatGPT – e tratado conforme os termos deles. O servidor MCP do WbizTool em si não guarda nada: ele repassa cada requisição para a API v2 e registra qual ferramenta foi usada, nunca o texto das mensagens nem a sua chave. Dê à chave só o acesso de que o assistente precisa.

Solução de problemas#

Relacionados#

• Visão geral da API v2
• Chaves de API
• Mensagens (API v2)
• Apps e integrações