[Beta]{class="badge informative" title="Este recurso está atualmente em uma versão beta antecipada"}
Marketo Servidor MCP
O protocolo MCP é um padrão aberto que permite que as ferramentas de IA se comuniquem com serviços externos. O servidor MCP Marketo atua como uma ponte entre o assistente de IA e o Marketo. Ele expõe mais de 100 operações em formulários, programas, campanhas inteligentes, leads, emails, trechos, listas e pastas.
Quando a ferramenta de IA chama o servidor MCP, o servidor executa a chamada à API REST correspondente em seu nome, usando as credenciais fornecidas em cada solicitação. Você não precisa instalar, implantar nem executar nenhum software do lado do servidor.
Pré-requisitos
- Uma instância Marketo com acesso à API REST habilitado
- Acesso de administrador para criar credenciais de API no Marketo LaunchPoint
- Uma das seguintes ferramentas de IA: Claude Desktop, Cursor, Claude Code (CLI) ou VS Code com o GitHub Copilot
- Acesso de rede à URL do servidor MCP:
https://marketo-mcp.adobe.io/mcp
Obter credenciais do Marketo
Você precisa dos seguintes valores da sua instância Marketo:
- ID do cliente
- Segredo do cliente
- ID da Conta da Munchkin
Se já os tiver, pule para Configurar a ferramenta de IA.
ID do cliente e segredo do cliente
- Vá para Admin > LaunchPoint.
- Clique no serviço de API. Se você não tiver um, selecione Novo > Novo serviço, escolha Personalizado como o tipo de serviço e atribua um usuário de API dedicado.
- Clique em Exibir Detalhes e copie os valores de ID do Cliente e Segredo do Cliente.
ID da conta do Munchkin
- Vá para Admin > Munchkin.
- Copie a ID da Conta da Munchkin. O formato é
XXX-XXX-XXXe corresponde ao prefixo da URL da instância.
Configurar a ferramenta de IA
Cada ferramenta de IA lê a configuração do servidor MCP de um local diferente. Encontre sua ferramenta abaixo e siga as etapas para adicionar o servidor MCP Marketo.
Claude Desktop
Arquivo de configuração claude_desktop_config.json. Abra-o em um destes locais:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Janelas:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
Se o arquivo já contiver outros servidores MCP, adicione a entrada marketo em mcpServers. O exemplo a seguir mostra o bloco mcpServers completo:
{
"mcpServers": {
"marketo": {
"type": "http",
"url": "https://marketo-mcp.adobe.io/mcp",
"headers": {
"X-Marketo-Client-Id": "YOUR-CLIENT-ID",
"X-Marketo-Client-Secret": "YOUR-CLIENT-SECRET",
"X-Marketo-Munchkin-Id": "YOUR-MUNCHKIN-ID"
}
}
}
}
Salve o arquivo, saia do Claude Desktop e abra-o novamente.
Cursor
Se a configuração do MCP do cursor já contiver outros servidores, adicione a entrada marketo em mcpServers. O exemplo a seguir mostra o bloco mcpServers completo em Configurações > MCP ou .cursor/mcp.json no diretório do projeto:
{
"mcpServers": {
"marketo": {
"type": "http",
"url": "https://marketo-mcp.adobe.io/mcp",
"headers": {
"X-Marketo-Client-Id": "YOUR-CLIENT-ID",
"X-Marketo-Client-Secret": "YOUR-CLIENT-SECRET",
"X-Marketo-Munchkin-Id": "YOUR-MUNCHKIN-ID"
}
}
}
}
Reiniciar o cursor.
Código Claude (CLI)
Execute o seguinte comando no terminal, substituindo suas credenciais:
claude mcp add --transport http marketo \
https://marketo-mcp.adobe.io/mcp \
--header "X-Marketo-Client-Id: YOUR-CLIENT-ID" \
--header "X-Marketo-Client-Secret: YOUR-CLIENT-SECRET" \
--header "X-Marketo-Munchkin-Id: YOUR-MUNCHKIN-ID"
Código VS com Copilot do GitHub
Abra o Código VS settings.json pressionando Ctrl+Shift+P ou Cmd+Shift+P no macOS e selecionando Preferências: Abrir Configurações de Usuário (JSON). Adicione o exemplo a seguir:
{
"mcp": {
"servers": {
"marketo": {
"type": "http",
"url": "https://marketo-mcp.adobe.io/mcp",
"headers": {
"X-Marketo-Client-Id": "YOUR-CLIENT-ID",
"X-Marketo-Client-Secret": "YOUR-CLIENT-SECRET",
"X-Marketo-Munchkin-Id": "YOUR-MUNCHKIN-ID"
}
}
}
}
}
Pressione Ctrl+Shift+P (ou Cmd+Shift+P no macOS), digite Recarregar Janela e pressione Enter.
${MARKETO_CLIENT_SECRET} e defini-las em seu ambiente. Isso impede que as credenciais sejam armazenadas em texto sem formatação em arquivos que possam ser confirmados no controle de versão.Operações disponíveis
Depois de conectado, você pode solicitar que o assistente de IA execute operações nas seguintes categorias.
Formulários
Procurar, criar, clonar e aprovar formulários. Adicione ou remova campos, configure regras de visibilidade de campo e identifique onde os formulários são incorporados.
Exemplo de prompts:
- "Mostrar todos os formulários aprovados"
- "Clonar o formulário Fale conosco na pasta Q2 Campaign"
- "Adicionar um campo Empresa ao formulário de Solicitação de demonstração"
Campanhas inteligentes
Crie campanhas inteligentes, configure filtros de lista inteligente, adicione etapas de fluxo e ative ou desative campanhas.
Exemplo de prompts:
- "Quais campanhas inteligentes estão ativas no momento?"
- "Criar uma nova campanha inteligente chamada Atualização de Pontuação de Cliente Potencial na pasta Operações"
- "Mostrar as etapas de fluxo na campanha de email de boas-vindas"
Clientes potenciais e listas
Localizar clientes potenciais por endereço de email, criar ou atualizar registros de clientes potenciais e gerenciar associação estática de listas.
Exemplo de prompts:
- "Encontre o cliente em potencial com e-mail jane@example.com"
- "Adicionar ID de lead 12345 à lista Q2 MQL"
- "Criar uma nova lista estática chamada Participantes do Evento de Verão"
Programas
Crie, clone e marque programas. Procure programas por tipo, canal ou intervalo de datas.
Exemplo de prompts:
- "Clonar o programa Q4 Webinar na pasta Eventos 2026"
- "Crie um novo programa de email chamado Vendas de Verão na pasta Campanhas"
- "Mostrar todos os programas marcados como Webinar"
Emails e trechos
Navegue por emails, crie emails de modelos, atualize seções de conteúdo e gerencie trechos reutilizáveis.
Exemplo de prompts:
- "Mostrar todos os rascunhos de email"
- "Atualizar a seção de cabeçalho do email de boas-vindas"
- "Quais ativos usam o trecho promocional de feriado?"
Estrutura da instância
Navegue por pastas, canais, tipos de marcas e tipos de atividades para entender sua configuração do Marketo.
Exemplo de prompts:
- "Listar todas as pastas no Marketo"
- "Mostrar todos os canais disponíveis"
- "Quais tipos de tag são configurados?"
Operações em massa
Exportar dados de clientes potenciais em massa e verificar o status do trabalho de importação ou exportação.
Exemplo de prompts:
- "Criar uma exportação em massa de clientes potenciais criados nos últimos 30 dias"
- "Verificar o status do trabalho de exportação xx"
Solução de problemas
X-Marketo-Endpoint está ausente da sua configuração.X-Marketo-Client-Id, X-Marketo-Client-Secret ou X-Marketo-Munchkin-Id está(ão) ausente(s).Perguntas frequentes
marketo-prod e o marketo-staging como servidores separados.Considerações de segurança
- Credenciais por solicitação. A ID do cliente, o Segredo do cliente, a ID do Munchkin e o endpoint da API REST são transmitidos em cabeçalhos HTTP com cada solicitação. O servidor não os armazena ou armazena em cache.
- Isolamento de vários locatários. Cada solicitação usa seu próprio conjunto de credenciais. Seus dados não fazem interseção com a sessão de nenhum outro usuário.
- incluo na lista de permissões de Munchkin ID. O servidor só aceita solicitações para Marketo instâncias aprovadas. As solicitações que usam uma Munchkin ID não autorizada são rejeitadas com um erro 403.
- Manter credenciais fora do controle de versão. Use a interpolação de variável de ambiente (
${MARKETO_CLIENT_SECRET}) se a ferramenta de IA permitir, de modo que as credenciais não sejam armazenadas em texto sem formatação em arquivos confirmados em um repositório.