DocumentaçãoGuia do desenvolvedor do Marketo

[Disponibilidade limitada]{class="badge informative" title="No momento, esse recurso está em uma versão beta limitada"}

Marketo Engage Servidor MCP

Última atualização: 8 de maio de 2026

Criado para:

  • {"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}
AVAILABILITY
Este recurso está em disponibilidade limitada. Para solicitar acesso, preencha este formulário. Certifique-se de ter a Munchkin ID da sua assinatura pronta.

O protocolo de contexto de modelo (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.

IMPORTANT
O protocolo de contexto de modelo (MCP) é um padrão de código aberto emergente e pode apresentar riscos de segurança ou confiabilidade. As integrações do servidor Adobe MCP e a documentação relacionada são fornecidas "no estado em que se encontram", sem garantias de nenhum tipo.
Conectar clientes ou servidores MCP a produtos da Adobe é uma configuração escolhida pelo cliente, e os clientes são responsáveis por avaliar a segurança e a adequação de qualquer integração de MCP. O Adobe não é responsável por problemas resultantes de configuração incorreta, uso incorreto do MCP, vulnerabilidades em implementações de terceiros ou ações não intencionais executadas por meio de fluxos de trabalho habilitados para MCP.
Para reduzir os riscos, a Adobe incentiva o teste de integrações em um ambiente de sandbox antes do uso produtivo e a análise e validação cuidadosas de todas as ações e respostas iniciadas pelo MCP antes de confirmar ou confiar nelas.

Noções básicas sobre MCP

Pense no MCP como uma porta USB-C para aplicativos de IA. Assim como o USB-C oferece uma maneira padronizada para conectar seus dispositivos a vários periféricos e acessórios, o MCP fornece uma maneira padronizada para conectar modelos de IA a fontes de dados e ferramentas. — Protocolo de Contexto de Modelo

O MCP permite que uma ferramenta de IA se conecte a vários serviços externos ao mesmo tempo. Por exemplo, um assistente de IA pode:

  • Conectar-se a um processador de texto para geração de documentos assistidos por IA
  • Conecte-se a ferramentas de animação, como o Blender, para criar visualizações
  • Conecte-se ao Adobe After Effects para edição de vídeo

O MCP é um protocolo de comunicação: um padrão aberto que qualquer aplicativo pode implementar para expor seus dados e ações às ferramentas de IA.

O que o MCP Marketo Engage faz ou não faz

Compreender o escopo do MCP ajuda a definir expectativas antes de conectar sua ferramenta de IA.

O MCP faz:

  • Fornecer acesso aos dados e recursos do Marketo por meio de APIs REST padrão
  • Executar chamadas de API em seu nome usando credenciais fornecidas com cada solicitação
  • Suporte a vários usuários simultâneos, cada um conectado com suas próprias credenciais
  • Manipule a atualização automática do token OAuth. Não é necessário gerenciar a expiração do token
  • Operar em ambientes isolados de locatários para que seus dados nunca cruzem com a sessão de outro usuário

O MCP não:

  • Use, hospede ou execute modelos de aprendizado de máquina ou IA. Todo o processamento de IA acontece na ferramenta de IA, não no MCP
  • Treine ou aprenda com quaisquer dados, incluindo os dados do cliente
  • Gerar previsões, recomendações ou decisões. A tomada de decisões é da responsabilidade do utilizador ou da ferramenta de IA a jusante
  • Armazenar ou reter credenciais, dados de solicitação ou estado de sessão entre solicitações
  • Exigir a instalação, implantação ou gerenciamento de qualquer software do lado do servidor

O MCP pode transmitir dados, incluindo campos potencialmente confidenciais, dependendo do uso da API, mas os dados B2B envolvem dados de negócios do cliente e não envolvem dados PII.

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, Codex, 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

  1. Vá para Admin > LaunchPoint.
  2. Selecione seu 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.
  3. Selecione Exibir Detalhes e copie os valores de ID do Cliente e Segredo do Cliente.

ID da conta do Munchkin

  1. Vá para Admin > Munchkin.
  2. Copie a ID da Conta da Munchkin. O formato é XXX-XXX-XXX e corresponde ao prefixo da URL da instância.

Configurar a ferramenta de IA

Cada ferramenta de IA tem uma configuração ligeiramente diferente. Exemplos de conexão são fornecidos para ferramentas comuns.

TIP
Para se conectar a várias instâncias do Marketo, adicione entradas separadas na configuração do MCP com nomes exclusivos: marketo-prod e marketo-staging, cada uma com as credenciais correspondentes.

Claude Desktop claude-desktop

Para se conectar ao Claude Desktop, baixe o marketo-mcp-bridge.zip e descompacte-o. Coloque marketo-mcp-bridge.mjs em um local conhecido para que você possa consultar na próxima etapa.

Você também precisará de:

  • Node.js v18+
  • npm
  1. Abrir o Claude Desktop
  2. Acesse Configurações > Desenvolvedor > Editar configuração
  3. Adicionar o seguinte a claude_desktop_config.json:
{
  "preferences": {
    ...
  },
  "mcpServers": {
    "marketo-mcp": {
      "command": "node",
      "args": ["/path/to/marketo-bridge/bridge.mjs"],
      "env": {
        "MARKETO_MCP_PROD_CLIENT_ID": "<your-client-id>",
        "MARKETO_MCP_PROD_CLIENT_SECRET": "<your-client-secret>",
        "MARKETO_MCP_PROD_MUNCHKIN_ID": "<your-munchkin-id>"
      }
    }
  }
}
  1. Reiniciar o Claude Desktop

Cursor 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:

Credenciais do cliente Marketo
code language-json 
{
  "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"
      }
    }
  }
}
Token IMS
code language-json 
{
  "mcpServers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR-IMS-TOKEN",
        "x-gw-ims-org-id": "YOUR-IMS-ORG-ID"
      }
    }
  }
}

Reiniciar o cursor.

Código Claude (CLI) claude-code

Execute o seguinte comando no terminal, substituindo suas credenciais:

Credenciais do cliente Marketo
code language-bash 
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"
Token IMS
code language-bash 
claude mcp add --transport http marketo \
  https://marketo-mcp.adobe.io/mcp \
  --header "Authorization: Bearer YOUR-IMS-TOKEN" \
  --header "x-gw-ims-org-id: YOUR-IMS-ORG-ID"

OpenAI Codex codex

  1. Vá para Configurações > Servidores MCP > Adicionar servidor
  2. Adicionar a URL do servidor: https://marketo-mcp.adobe.io/mcp
  3. Adicione os cabeçalhos para seu método de autenticação:
Credenciais do cliente Marketo
  • X-Marketo-Client-Id: “YOUR-CLIENT-ID”
  • X-Marketo-Client-Secret: “YOUR-CLIENT-SECRET”
  • X-Marketo-Munchkin-Id: “YOUR-MUNCHKIN-ID”
Token IMS
  • Autorização: “Bearer YOUR-IMS-TOKEN”
  • x-gw-ims-org-id: “YOUR-IMS-ORG-ID”
  1. Clique em Salvar para concluir o processo.

Código VS com Copilot do GitHub vscode

Pressione Ctrl+Shift+P (ou Cmd+Shift+P no macOS), digite MCP: Abrir Configuração de Usuário e pressione Enter. Isso abre mcp.json. Adicionar a entrada marketo dentro do objeto servers:

Credenciais do cliente Marketo
code language-json 
{
  "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"
      }
    }
  }
}
Token IMS
code language-json 
{
  "servers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR-IMS-TOKEN",
        "x-gw-ims-org-id": "YOUR-IMS-ORG-ID"
      }
    }
  }
}
NOTE
Para fins de segurança, use a interpolação da variável de ambiente nos arquivos de configuração em vez de colar as credenciais diretamente. Você pode fazer referência a variáveis usando sintaxe como ${MARKETO_CLIENT_SECRET} e defini-las em seu ambiente. Isso impede que as credenciais sejam armazenadas em texto sem formatação em arquivos com 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. Para obter a lista completa de operações suportadas com referências de API, consulte Operações MCP suportadas.

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

Para entender sua configuração do Marketo, navegue por pastas, canais, tipos de tags e tipos de atividades.

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

Erro
Causa
Corrigir
“Credenciais do Marketo não fornecidas”
Um ou mais de X-Marketo-Client-Id, X-Marketo-Client-Secret ou X-Marketo-Munchkin-Id está(ão) ausente(s).
Verifique se todos os cabeçalhos de credencial de cliente Marketo estão presentes em sua configuração.
“401 Não autorizado”
Suas credenciais estão ausentes, inválidas ou expiradas. Com as credenciais do cliente Marketo, a ID do cliente ou o Segredo do cliente está incorreto. Com um token IMS, o token é inválido ou expirou.
Verifique as credenciais do método de autenticação. Para obter as credenciais do cliente, verifique novamente a ID do Cliente e o Segredo do Cliente em Admin > LaunchPoint. Para um token IMS, gere um novo token e atualize o cabeçalho Authorization.
“403 Proibido”
Suas credenciais são válidas, mas a instância Marketo não está habilitada para acesso MCP.
Contate o administrador do MCP Marketo para habilitar o acesso ao MCP para sua ID de Conta da Munchkin.
“Muitas solicitações” (limite de taxa)
Você enviou muitas solicitações em um curto período ou muitas solicitações ao mesmo tempo e atingiu os limites da API da instância Marketo.
Reduza a frequência e o número de solicitações enviadas de uma só vez e aguarde um pouco antes de tentar novamente. Use um usuário de API dedicado para rastrear e gerenciar sua cota.
Tempo limite de conexão ou recusado
O servidor MCP está inacessível na sua rede.
Confirme se você pode acessar o URL do servidor do seu ambiente. Verifique os requisitos de VPN, se aplicável.
As chamadas de ferramenta retornam resultados vazios
O usuário da API não tem permissões para o tipo de ativo solicitado.
Peça ao administrador do Marketo para revisar a função de usuário e as permissões da API.

Considerações de segurança

IMPORTANT
Use um usuário da API dedicado no Marketo com apenas as permissões necessárias para seu trabalho. Não reutilize credenciais de administrador para acessar a API.
  • 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.
  • Limites de taxa de API. O servidor MCP herda os limites de taxa da API da sua instância Marketo. Use um usuário de API dedicado para rastrear e gerenciar o consumo de cotas.
  • 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 nos arquivos do repositório.
recommendation-more-help
marketo-developer-help