Marketo Engage Servidor MCP

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 e use seu caminho absoluto na configuração abaixo.

Você também precisa de uma versão LTS suportada do Node.js instalada em seu computador. A ponte não requer pacotes npm adicionais.

1. Abra o Claude Desktop.
2. Abrir claude_desktop_config.json. No macOS, o arquivo está em ~/Library/Application Support/Claude/. No Windows, ele está em %APPDATA%\Claude\. Em versões com o menu de configurações do desenvolvedor, selecione Configurações > Desenvolvedor > Editar Configuração para abri-lo.
3. Adicione a seguinte entrada em mcpServers, preservando quaisquer configurações existentes. Substitua o caminho e os espaços reservados da credencial por seus valores:

{
  "mcpServers": {
    "marketo-mcp": {
      "command": "node",
      "args": ["/path/to/marketo-bridge/marketo-mcp-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. Reinicie o Claude Desktop.

Se o Claude Desktop não puder encontrar o Node.js, substitua node em command pelo caminho absoluto para o executável do Node.js. Para obter mais informações, consulte Conectar a servidores MCP locais.

Cursor cursor

Adicione a entrada marketo em mcpServers em ~/.cursor/mcp.json para sua conta de usuário ou .cursor/mcp.json no diretório do projeto. Preserve todos os servidores existentes e substitua os espaços reservados para credenciais por seus valores:

{
  "mcpServers": {
    "marketo": {
      "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"
      }
    }
  }
}

Abra Personalizar no Cursor e confirme se o servidor está ligado. Para obter mais informações, consulte Configuração do MCP do cursor.

Código Claude (CLI) claude-code

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"

O comando adiciona o servidor para o projeto atual e sua conta de usuário. Para disponibilizá-lo em projetos, adicione --scope user. No Código Claude, execute /mcp para verificar a conexão. Para obter mais informações, consulte configuração do MCP do Claude Code.

OpenAI Codex codex

Adicione o seguinte a ~/.codex/config.toml, preservando qualquer configuração existente:

[mcp_servers.marketo]
url = "https://marketo-mcp.adobe.io/mcp"

[mcp_servers.marketo.env_http_headers]
X-Marketo-Client-Id = "MARKETO_CLIENT_ID"
X-Marketo-Client-Secret = "MARKETO_CLIENT_SECRET"
X-Marketo-Munchkin-Id = "MARKETO_MUNCHKIN_ID"

Defina MARKETO_CLIENT_ID, MARKETO_CLIENT_SECRET e MARKETO_MUNCHKIN_ID no ambiente do processo que executa o Codex. Os valores em env_http_headers são nomes de variáveis de ambiente, não credenciais.

Inicie uma nova sessão do Codex e execute /mcp para verificar a conexão. Para obter mais informações, consulte Configuração do Codex MCP.

CLI do Gemini

Para adicionar o servidor MCP Marketo Engage à CLI do Gemini, adicione a seguinte entrada mcpServers a .gemini/settings.json no diretório do projeto ou ~/.gemini/settings.json para a conta de usuário. Preserve todas as configurações existentes e substitua os espaços reservados das credenciais por seus valores.

{
  "mcpServers": {
    "marketo": {
      "httpUrl": "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"
      }
    }
  }
}

Como alternativa, defina MARKETO_CLIENT_ID, MARKETO_CLIENT_SECRET e MARKETO_MUNCHKIN_ID em seu ambiente de shell e execute o seguinte comando. O shell expande as variáveis antes que a CLI armazene os valores do cabeçalho na configuração do usuário:

gemini mcp add --transport http -s user marketo https://marketo-mcp.adobe.io/mcp \
  -H "X-Marketo-Client-Id: $MARKETO_CLIENT_ID" \
  -H "X-Marketo-Client-Secret: $MARKETO_CLIENT_SECRET" \
  -H "X-Marketo-Munchkin-Id: $MARKETO_MUNCHKIN_ID"

Reinicie a sessão e execute /mcp para verificar a conexão. Para obter mais informações, consulte Configuração de MCP Gemini CLI.

Código VS com Copilot do GitHub vscode

Use a configuração portátil do Copilot para as versões mais recentes do código VS. Adicione a seguinte entrada em mcpServers em ~/.copilot/mcp-config.json, ou $COPILOT_HOME/mcp-config.json se você definir COPILOT_HOME. Preservar os servidores existentes:

{
  "mcpServers": {
    "marketo": {
      "type": "http",
      "url": "https://marketo-mcp.adobe.io/mcp",
      "headers": {
        "X-Marketo-Client-Id": "${MARKETO_CLIENT_ID}",
        "X-Marketo-Client-Secret": "${MARKETO_CLIENT_SECRET}",
        "X-Marketo-Munchkin-Id": "${MARKETO_MUNCHKIN_ID}"
      }
    }
  }
}

Defina as três variáveis de ambiente no ambiente que executa o código VS ou no host remoto que se conecta ao servidor. Inicie uma nova sessão do Copilot e revise todos os prompts de confiança do servidor.

Para usar a configuração guiada, execute MCP: Adicionar Servidor, selecione HTTP (HTTP ou Eventos Enviados pelo Servidor), insira a URL do servidor e escolha Global > Copilot Global. Em seguida, adicione os cabeçalhos à configuração salva.

As versões anteriores também oferecem suporte a MCP: Abrir Configuração de Usuário ou .vscode/mcp.json. Esses arquivos usam a sintaxe servers em vez de mcpServers e ${env:MARKETO_CLIENT_ID} para variáveis de ambiente. Não misture os dois formatos. Para obter mais informações, consulte Configuração de MCP do VS Code.

Copilot Studio

Ative a orquestração gerativa para seu agente antes de adicionar ferramentas MCP. Use um conector personalizado para definir todos os três cabeçalhos Marketo necessários.

Na página Ferramentas do seu agente, selecione Adicionar uma ferramenta > Nova ferramenta > Conector personalizado. No Power Apps, crie um conector personalizado e use o editor do Swagger para inserir a seguinte definição:

swagger: '2.0'
info:
  title: Marketo MCP Server
  description: Connect to the Marketo MCP server.
  version: 1.0.0
host: marketo-mcp.adobe.io
basePath: /
schemes:
  - https
paths:
  /mcp:
    post:
      summary: Marketo MCP Server
      description: Invoke the Marketo MCP server.
      operationId: InvokeServer
      x-ms-agentic-protocol: mcp-streamable-1.0
      parameters:
        - name: X-Marketo-Client-Id
          in: header
          description: Client ID.
          type: string
          required: true
        - name: X-Marketo-Client-Secret
          in: header
          description: Client secret.
          type: string
          required: true
        - name: X-Marketo-Munchkin-Id
          in: header
          description: Munchkin ID.
          type: string
          required: true
      responses:
        '200':
          description: Immediate Response
securityDefinitions: {}
security: []

Salve ou atualize o conector, retorne ao Copilot Studio e adicione-o ao seu agente. Crie uma conexão e forneça os três valores de cabeçalho quando solicitado. Mantenha as credenciais fora da definição de OpenAPI e das instruções do agente. Para obter mais informações, consulte Conectar um agente a um servidor MCP existente.

Glean glean

Para conectar o Glean ao servidor MCP Marketo Engage, siga as instruções de configuração do MCP remoto do Glean para adicionar https://marketo-mcp.adobe.io/mcp. Verifique primeiro o catálogo Conectores. Para um servidor personalizado ou não listado, use o Admin Console > Platform > Tools > Import tools from MCP server.

A equipe de suporte do Glean deve configurar os cabeçalhos personalizados abaixo. Inclua o nome do servidor, o URL e os nomes de cabeçalho necessários em sua solicitação de suporte e coordene o tratamento seguro dos valores da credencial. Uma conexão de chave de API padrão sozinha não fornece os três cabeçalhos.

Depois que o Glean confirmar que os cabeçalhos estão ativos, teste a conexão com uma solicitação somente leitura antes de disponibilizar as ferramentas para outros usuários.

Outras ferramentas other-tools

O Adobe hospeda o servidor MCP Marketo e o expõe em uma URL pública. Qualquer cliente MCP que suporte servidores remotos por meio de transporte HTTP eficiente pode se conectar a ele.
Os clientes que oferecem suporte a conexões HTTP remotas diretas não precisam de uma ponte ou de um software de servidor instalado localmente. Se sua ferramenta não estiver listada acima, use os detalhes de conexão abaixo para configurá-la manualmente.

Detalhes da conexão:

Cabeçalhos de autenticação:

Envie todos os três cabeçalhos com cada solicitação. O local em que você insere o URL e os cabeçalhos do servidor depende da ferramenta. Consulte a documentação do MCP.

Se a ferramenta aceitar uma configuração JSON, comece com os exemplos de Cursor ou Código VS e ajuste as chaves e a sintaxe da variável de ambiente para corresponder ao esquema da ferramenta.