MCP — Visão Geral — Dexter Docs

O que é MCP

O Model Context Protocol (MCP) é um protocolo aberto que permite que agentes de IA — como os do Cursor, Claude ou qualquer client MCP — se conectem diretamente ao Dexter.

Com MCP, você pode ler dados, gerenciar contatos, criar campanhas e enviar mensagens programaticamente, tudo de dentro do seu editor ou agente de IA preferido.

Quando usar

Automação avançada de operações comerciais e de atendimento
Integração com agentes de IA externos (Cursor, Claude, ou qualquer client MCP)
Workflows automatizados — criar campanhas, qualificar leads, agendar reuniões
Operações em lote: taguear contatos, consultar métricas, revisar fila de trabalho

Como funciona

O Dexter expõe um servidor MCP no endpoint /api/v1/mcp.
O client MCP se conecta via Streamable HTTP — cada requisição é um POST com uma mensagem JSON-RPC 2.0, e a resposta vem como JSON simples.
Autenticação: Bearer token (API Key do Dexter, prefixo dx_live_).
Cada tool é uma operação atômica — ler contatos, enviar mensagem, criar campanha, etc.

Transporte: o servidor MCP do Dexter usa Streamable HTTP (POST + JSON-RPC 2.0), sem necessidade de conexão persistente. Clients como o Cursor já suportam esse transporte nativamente.

Conectar no Cursor

1

Gere uma API Key
No dashboard do Dexter, acesse Configurações → Integrações. Na seção MCP, ative a integração e copie a API Key gerada.

2

Abra as configurações do Cursor
No Cursor, vá em Settings → MCP.

3

Adicione o servidor MCP do Dexter
Clique em “Add new MCP server” e configure:

{
  "name": "Dexter",
  "url": "https://app.dexteragents.com/api/v1/mcp",
  "transport": "streamable-http",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  }
}

4

Salve e verifique
Após salvar, as tools do Dexter devem aparecer na lista de tools MCP disponíveis.

5

Teste com uma chamada simples
Peça ao agente: “Liste meus agentes de IA usando o Dexter”. Ele deve usar a tool dexter_agents_list e retornar os agentes configurados na sua instância.

Dica: se o Cursor mostrar erro de autenticação, verifique se a API Key está correta e se a integração MCP está ativa na tela Integrações do dashboard.

Conectar em outros clients MCP

Qualquer client compatível com MCP via Streamable HTTP funciona com o Dexter.

Parâmetro	Valor
URL	`https://app.dexteragents.com/api/v1/mcp`
Transporte	Streamable HTTP (POST com JSON-RPC 2.0)
Header de autenticação	`Authorization: Bearer YOUR_API_KEY`
Versões do protocolo	2025-06-18, 2025-03-26, 2024-11-05

Permissões

As permissões são configuradas por instância na tela Integrações do dashboard. São três níveis:

Nível	O que permite	Configuração
Read (leitura)	Listar contatos, campanhas, conversas, histórico, analytics, agentes, agenda	Ativo quando MCP está habilitado
Write (escrita)	Criar/editar contatos, gerenciar tags, gerar e criar campanhas em rascunho, pausar campanhas	“Permitir escrita (contatos e tags)”
Send (envio)	Enviar mensagens, ativar campanhas, aprovar itens da fila, agendar na Google Agenda	“Permitir envio de mensagens”

Boa prática: ative apenas as permissões necessárias para o seu caso de uso. Se o agente só precisa consultar dados, deixe apenas Read habilitado.

Categorias de tools

Categoria	Tools	Nível
Contatos	`dexter_contacts_search`, `dexter_contacts_get`, `dexter_contacts_upsert`, `dexter_contacts_tag`, `dexter_contact_tags_list`	Read / Write
Conversas	`dexter_conversations_list`, `dexter_conversations_history`	Read
Campanhas	`dexter_campaigns_list`, `dexter_campaigns_status`, `dexter_campaigns_prepare`, `dexter_campaigns_kb_topics`, `dexter_campaigns_audience_preview`, `dexter_campaigns_generate`, `dexter_campaigns_create`, `dexter_campaigns_activate`, `dexter_campaigns_pause`	Read / Write / Send
Agenda	`dexter_calendar_status`, `dexter_calendar_freebusy`, `dexter_calendar_slots`, `dexter_calendar_book`	Read / Send
Analytics	`dexter_analytics_overview`	Read
Mensagens	`dexter_messages_send`	Send
Work Queue	`dexter_work_queue_list`, `dexter_work_queue_approve`, `dexter_work_queue_dismiss`	Read / Write / Send
Leads	`dexter_stale_leads`	Read

Ver referência completa de tools →

Exemplo prático: Criar campanha via Cursor

Imagine que você quer reengajar leads inativos. Veja como um agente no Cursor executa isso usando as tools do Dexter:

1

Identificar leads inativos
O agente chama dexter_stale_leads para listar contatos SDR sem interação recente.

2

Taguear os leads
Usa dexter_contacts_tag para adicionar a tag “reengajamento” a cada lead.

3

Preparar a campanha
Chama dexter_campaigns_prepare para iniciar a criação da campanha, respondendo cada pergunta interativa.

4

Selecionar tópico do KB
Usa dexter_campaigns_kb_topics para listar assuntos disponíveis e escolher o mais relevante.

5

Gerar mensagens
Chama dexter_campaigns_generate para gerar os blocos de mensagem usando o KB. O agente mostra o texto gerado para você revisar.

6

Criar a campanha em rascunho
Usa dexter_campaigns_create para salvar a campanha. Ela é criada como rascunho.

7

Ativar (com confirmação)
O agente chama dexter_campaigns_activate, que retorna um resumo e uma frase de confirmação. Você digita a frase exata para autorizar o envio.

Segurança: a ativação de campanhas sempre requer uma frase de confirmação digitada por você. O agente nunca ativa uma campanha automaticamente.

Segurança e limites

API Key obrigatória — toda requisição precisa do header Authorization: Bearer YOUR_API_KEY.
Permissões granulares — cada key opera com os níveis Read, Write e/ou Send configurados na tela Integrações.
Rate limits — envios são limitados para evitar spam. Mensagens idênticas ao mesmo número são bloqueadas por 3 minutos.
Proteção anti-duplicidade — o mesmo número não recebe duas mensagens no mesmo segundo.
Auditoria — todas as operações são logadas com telefone, timestamp e hash da mensagem.
dexter_messages_send — requer permissão Send explícita. Se uma chamada ficar sem resposta, não reenvie às cegas: o envio provavelmente ocorreu.

Dica de segurança: gere API Keys específicas para cada integração. Se uma key for comprometida, você pode revogá-la sem afetar as demais.

MCP — Visão Geral