MCP — Model Context Protocol

O MCP da Verboo expõe 18 ferramentas que permitem criar e gerenciar assistentes, configurar gatilhos, adicionar ações e analisar conversas — tudo sem abrir o painel. Funciona com qualquer cliente MCP compatível com transporte HTTP.

Endpoint

https://api.verbeux.com.br/mcp

Autenticação: header Api-Key com sua API Key (veja Autenticação).

Configuração por cliente

Claude Desktop

Edite o arquivo de configuração:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

json

{
  "mcpServers": {
    "verboo": {
      "type": "http",
      "url": "https://api.verbeux.com.br/mcp",
      "headers": {
        "Api-Key": "sua-api-key"
      }
    }
  }
}

Reinicie o Claude Desktop após salvar.

Claude Code

bash

claude mcp add --transport http verboo https://api.verbeux.com.br/mcp --header "Api-Key: sua-api-key"

Verifique a conexão:

bash

claude mcp list

Gemini CLI

Edite ~/.gemini/settings.json:

json

{
  "mcpServers": {
    "verboo": {
      "httpUrl": "https://api.verbeux.com.br/mcp",
      "headers": {
        "Api-Key": "sua-api-key"
      }
    }
  }
}

Antigravity

Em Settings → MCP Servers → Add Server, configure:

Campo	Valor
Transport	HTTP
URL	`https://api.verbeux.com.br/mcp`
Header name	`Api-Key`
Header value	sua API Key

Ferramentas disponíveis

Assistentes

Ferramenta	Descrição	Parâmetros principais
`list_assistants`	Lista todos os assistentes da conta	`page`, `perPage`, `name`
`get_assistant`	Retorna configuração completa de um assistente	`id` ✅
`create_assistant`	Cria um novo assistente	`name` ✅, `prompt`, `language`, `temperature`, `restrictedByContext`
`update_assistant`	Atualiza campos de um assistente existente	`id` ✅ + campos desejados

Valores válidos para language: brazil-portuguese · english · any

Gatilhos

Ferramenta	Descrição	Parâmetros principais
`list_triggers`	Lista gatilhos de um assistente	`assistantId` ✅, `page`, `perPage`
`get_trigger`	Retorna definição completa de um gatilho	`assistantId` ✅, `triggerId` ✅
`create_trigger`	Cria um gatilho de function calling	`assistantId` ✅, `name` ✅, `description` ✅, `parametersJson`, `interpretResponse`, `copilotOnly`
`update_trigger`	Atualiza um gatilho existente	`assistantId` ✅, `triggerId` ✅ + campos
`delete_trigger`	Remove o gatilho e todas as suas ações	`assistantId` ✅, `triggerId` ✅

parametersJson é uma string JSON Schema descrevendo os argumentos que o LLM deve extrair. Máx 350 chars para description.

Ações

Ferramenta	Descrição	Parâmetros principais
`list_actions`	Lista ações de um gatilho	`assistantId` ✅, `triggerId` ✅
`get_action`	Retorna configuração de uma ação	`assistantId` ✅, `triggerId` ✅, `actionId` ✅
`create_action`	Cria uma ação dentro de um gatilho	`assistantId` ✅, `triggerId` ✅, `type` ✅, `actionJson`
`update_action`	Substitui a configuração de uma ação	`assistantId` ✅, `triggerId` ✅, `actionId` ✅, `type` ✅
`delete_action`	Remove uma ação do gatilho	`assistantId` ✅, `triggerId` ✅, `actionId` ✅

Tipos de ação disponíveis (type):

Tipo	Descrição
`WEBHOOK`	Requisição HTTP customizada
`NATIVE`	Mensagens avançadas WhatsApp
`CRM`	Criação/atualização de contato
`GOOGLE_CALENDAR`	Verificar, listar e criar eventos
`META_ADS`	Evento de pixel de conversão
`FEEGOW`	Gestão clínica
`CHAT_INTEGRATION`	Status e resumo de atendimento
`KNOWLEDGE`	Busca na base de conhecimento
`Z_API` / `MY_ZAP` / `EVOLUTION`	Operações WhatsApp
`CATALOG_INTEGRATION`	Catálogo de produtos

Histórico e Analytics

Ferramenta	Descrição	Parâmetros principais
`list_generative_messages`	Lista mensagens de conversas	`assistantId`, `sessionId`, `page`, `perPage`
`list_generative_sessions`	Lista sessões únicas de um assistente	`assistantId`, `page`, `perPage`
`get_generative_message_graph`	Volume diário de mensagens	`assistantId`, `range` (1–365 dias)
`list_assistants_usage`	Mensagens por assistente no mês	—

Exemplo de uso

Com o MCP conectado, você pode pedir ao Claude diretamente em linguagem natural:

"Crie um assistente chamado Sofia com prompt de vendas e idioma português"

"Liste os gatilhos do assistente 42"

"Adicione um webhook ao gatilho 7 do assistente 42 que faz POST em
https://minha-api.com/leads com o body {nome: $nome, email: $email}"

"Mostre o volume de mensagens dos últimos 30 dias"

O modelo extrai os parâmetros necessários, chama as ferramentas na ordem certa e confirma o resultado — sem precisar abrir o painel.