Agendo · MCP

Agendo MCP

Conecte o Agendo ao seu agente de IA para consultar times, funis, leads e pixels — e criar/editar rascunhos de funil com escrita segura (dry-run + confirmação).

DisponívelLeitura + Escrita (F1a)Streamable HTTP10 tools

https://mcp.useagendo.com/mcp

Endpoint do servidor MCP remoto (JSON-RPC via POST). Funciona em qualquer cliente compatível com MCP remoto / Streamable HTTP.

Como conectar

1
Copie a URL do MCP
É o endereço do servidor MCP remoto do Agendo. Você vai colá-lo no seu cliente de IA.
2
Adicione como conector MCP
No seu cliente, adicione um conector/MCP remoto (Streamable HTTP) apontando pra essa URL.
3
Autentique com um PAT
Use um Personal Access Token cal_agent_… no header Authorization — escopo de leitura para consultar, ou funnels:write para também criar/editar funis (com dry-run + confirmação).

Clientes suportados

Use em qualquer cliente compatível com MCP remoto (Streamable HTTP). Exemplos:

Claude Code

CLI oficial. Exporte o token no shell (export AGENDO_AGENT_TOKEN=cal_agent_…) e adicione o servidor remoto — o shell expande $AGENDO_AGENT_TOKEN no header. Depois peça “get_me” pra testar.

export AGENDO_AGENT_TOKEN="cal_agent_..."
claude mcp add --transport http agendo \
  https://mcp.useagendo.com/mcp \
  --header "Authorization: Bearer $AGENDO_AGENT_TOKEN"

bash

Cursor / clientes via config (.mcp.json)

Clientes que leem um arquivo de config MCP (Cursor, Windsurf, .mcp.json do Claude Code). Use ${AGENDO_AGENT_TOKEN} — a expansão de env var é suportada e mantém o token fora do arquivo:

{
  "mcpServers": {
    "agendo": {
      "type": "http",
      "url": "https://mcp.useagendo.com/mcp",
      "headers": { "Authorization": "Bearer ${AGENDO_AGENT_TOKEN}" }
    }
  }
}

json

Codex

Adicione um servidor MCP remoto com header de autenticação (config do Codex):

[mcp_servers.agendo]
url = "https://mcp.useagendo.com/mcp"
headers = { Authorization = "Bearer ${AGENDO_AGENT_TOKEN}" }

toml

Claude Desktop

Suporta MCP remoto com Bearer, mas só editando o config (claude_desktop_config.json / ~/.claude.json) — a UI de conectores não tem campo de header. Mesmo formato do .mcp.json acima.

Claude Web (claude.ai)

Os conectores customizados da web aceitam SÓ OAuth — não há campo pra Bearer fixo, então o PAT cal_agent_ não conecta direto na web hoje. Use Claude Code / Cursor / Desktop; suporte OAuth pra web fica como evolução futura.

Tools disponíveis

8 tools de leitura, agrupadas por área. PII de lead sempre mascarada; token de pixel nunca exposto.

Conta

Identidade e times

get_me

Identidade do dono do PAT: usuário, scopes e times permitidos.

list_teams

Times visíveis pelo PAT (restritos ao allowedTeamIds).

Funis

Funis e etapas

list_funnels

Lista funis do escopo. Sem teamId (ou null) = funis pessoais.

get_funnel

Detalhe de 1 funil + resumo das etapas. Informe funnelId OU funnelUid.

Leads

Leads com PII mascarada

list_leads

Lista leads do escopo. PII vem mascarada. Filtros opcionais e paginação.

get_lead

Detalhe de 1 lead (PII mascarada). Informe leadId OU leadUid.

Pixel

Pixels Meta / CAPI

list_pixels

Pixels Meta (CAPI) do escopo. Só hasToken — o token de acesso nunca sai.

get_pixel_health

Saúde de 1 pixel (último teste local). A entrega real é o Events Manager da Meta.

Exemplos de prompts

Depois de conectar, é só pedir em linguagem natural:

• Liste meus times no Agendo.
• Mostre meus funis ativos.
• Analise os leads recentes do meu time de vendas.
• Veja a configuração de pixel dos meus funis.

Escrita (F1a)

Além de ler, o agente pode criar e editar rascunhos de funil — com escrita controlada: dry-run obrigatório + confirmação. Exige o scope funnels:write.

Atenção: Escrita por MCP existe HOJE só para FUNIS (create_funnel_draft, update_funnel_draft — scope funnels:write). Leads, Webhook e Pixel continuam SOMENTE LEITURA — não há leads:write / webhooks:write / pixels:write por MCP ainda.

create_funnel_draftescrita

Cria um rascunho de funil/formulário. Exige funnels:write. SEMPRE chame com dryRun=true primeiro.

update_funnel_draftescrita

Edita um funil/formulário existente (informe id). Exige funnels:write. SEMPRE dryRun=true primeiro.

Fluxo obrigatório

1. dryRun=true
Valida o payload + permissões + cobrança e monta um PREVIEW do que mudaria. NÃO grava nada. Retorna um confirmationToken.
2. Revisar o preview
Confira o que SERIA criado/alterado antes de executar.
3. dryRun=false + confirmationToken
Reenvie o MESMO payload com o confirmationToken do passo 1. Só aí grava. Payload diferente → recusado.

// 1) dry-run — NÃO grava; retorna preview + confirmationToken
create_funnel_draft { "name": "Funil Black Friday", "dryRun": true }

// 2) executar — MESMO payload + dryRun:false + o confirmationToken do passo 1
create_funnel_draft {
  "name": "Funil Black Friday",
  "dryRun": false,
  "confirmationToken": "<token-do-passo-1>"
}