[Beta]{class="badge informative"}

Referência de ferramentas do servidor MCP Adobe Target target-mcp-tools-reference

AVAILABILITY
O servidor MCP Adobe Target está disponível para todos os clientes em Beta Público. Atualmente, ele tem suporte no Claude Web, Claude Desktop, Claude Code, Cursor e ChatGPT.

Esta página é uma referência completa para todas as ferramentas somente leitura expostas pelo servidor MCP Adobe Target. Para cada ferramenta, você encontrará uma descrição, detalhes do parâmetro, valor de retorno e um exemplo de prompt em linguagem natural. Para obter instruções de configuração e casos de uso, consulte Introdução e Casos de uso e apresentações.

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 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 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.

Pré-requisitos tools-prerequisites

Sua função Adobe Target determina quais ferramentas estão disponíveis para você:

  • Função de Observador ou superior: acesso a todas as 23 ferramentas somente leitura
NOTE
As ferramentas de gravação (criar, atualizar, ativar, desativar) não são expostas por meio do catálogo MCP público no Public Beta. Todas as 23 ferramentas listadas nesta página são somente leitura. O acesso de gravação estará disponível em uma versão futura.

Para obter instruções completas sobre a configuração, consulte Introdução.

Ferramentas de atividade tools-activities

Listar atividades

Ferramenta: list_target_activities

Listar Adobe Target atividades com filtragem e classificação do lado do servidor.

Recupera uma lista paginada de atividades. Todos os filtros são aplicados no lado do servidor pela API de Administração Target. O servidor retorna no máximo 200 atividades por página.

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4
Parâmetro Tipo Obrigatório Descrição
limit número inteiro Não Número máximo de atividades a serem retornadas (máx. do servidor: 200)
offset número inteiro Não Número de atividades a serem ignoradas para paginação
sort_by string Não Campo de acordo com o qual classificar. Prefixo com - para ordem decrescente (por exemplo, -modifiedAt). Opções: id, name, state, priority, startsAt, endsAt, lifetimeStart, lifetimeEnd, createdAt, createdBy, modifiedAt, modifiedBy, type, thirdPartyId
state string Não Filtrar por estado de atividade: approved (ativo/ativo), deactivated (inativo), paused, saved (rascunho)
activity_type string Não Filtrar por tipo: ab (Teste A/B), xt (Direcionamento de experiência), abt (Automated Personalization)
name_contains string Não Filtrar atividades cujo nome contém esta cadeia de caracteres (não diferencia maiúsculas de minúsculas)
starts_after string Não Data ISO 8601 — atividades que começam após esta data
starts_before string Não Data ISO 8601 — atividades que começam antes desta data
modified_after string Não Data ISO 8601 — atividades modificadas após esta data
ends_after string Não Data ISO 8601 — atividades que terminam após esta data
ends_before string Não Data ISO 8601 — atividades que terminam antes desta data
workspace string Não Filtrar por ID de espaço de trabalho
segment_id string Não Filtrar por ID de segmento de público
profile_attribute_id string Não Filtrar por ID de atributo de perfil
priority número inteiro Não Filtrar por valor de prioridade exato (0-999)
mbox string Não Filtrar por nome de mbox/local
offer_id string Não Filtrar por ID de oferta
view_id string Não Filtrar por ID de exibição de SPA

Retorna: objeto JSON com activities (lista de objetos incluindo id, name, state, type, priority, modifiedAt, startsAt, endsAt) e total (contagem total, pode exceder o tamanho da página retornada).

Prompt de exemplo: “Lista todos os testes A/B ativos classificados pela última modificação.”

Obter uma atividade A/B

Ferramenta: get_ab_activity

Obtenha informações detalhadas sobre uma atividade A/B.

Recupera a configuração completa de um teste A/B específico, incluindo experiências, locais, métricas e regras de direcionamento.

table 0-row-4 1-row-4
Parâmetro Tipo Obrigatório Descrição
activity_id número inteiro Sim O identificador exclusivo da atividade A/B

Retorna: Detalhes completos da atividade, incluindo metadados (nome, estado, prioridade, datas), experiências, locais e ofertas, metas e métricas, além das regras de direcionamento.

Prompt de exemplo: “Obter detalhes da atividade A/B 12345”.

Obter uma atividade de direcionamento de experiência

Ferramenta: get_xt_activity

Obtenha informações detalhadas sobre uma atividade de Direcionamento de experiência (XT).

Recupera a configuração completa de uma atividade de XT específica, incluindo mapeamentos de experiência de público-alvo, locais e métricas.

table 0-row-4 1-row-4
Parâmetro Tipo Obrigatório Descrição
activity_id número inteiro Sim O identificador exclusivo da atividade de XT

Retorna: detalhes completos da atividade, incluindo metadados, experiências com mapeamentos de público-alvo, locais e ofertas, metas e métricas.

Prompt de exemplo: “Obter detalhes da atividade de Direcionamento de Experiência 12345”.

Obter uma atividade do Automated Personalization

Ferramenta: get_abt_activity

Obtenha informações detalhadas sobre uma atividade de Automated Personalization (AP).

table 0-row-4 1-row-4
Parâmetro Tipo Obrigatório Descrição
activity_id número inteiro Sim O identificador exclusivo da atividade de AP

Retorna: detalhes completos da atividade, incluindo metadados, experiências, locais e configurações algorítmicas.

Prompt de exemplo: “Obter detalhes da atividade 12345 do Personalization Automático”.

Ferramentas de oferta tools-offers

Listar ofertas

Ferramenta: list_target_offers

Liste todas as ofertas em seu locatário do Target.

Recupera uma lista paginada de ofertas de conteúdo com filtragem opcional.

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4
Parâmetro Tipo Obrigatório Descrição
limit número inteiro Não Número máximo de ofertas a serem retornadas
offset número inteiro Não Número de ofertas a serem ignoradas para paginação
type string Não Filtrar por tipo de oferta: content (HTML), json ou redirect
name string Não Filtrar por nome da oferta (correspondência parcial)

Retorna: objeto JSON com offers (lista de objetos incluindo id, name, type, content, modifiedAt) e total.

Prompt de exemplo: “Listar todas as ofertas JSON”.

Obter uma oferta

Ferramenta: get_target_offer

Obtenha informações detalhadas sobre uma oferta específica.

table 0-row-4 1-row-4
Parâmetro Tipo Obrigatório Descrição
offer_id número inteiro Sim O identificador exclusivo da oferta

Retorna: Detalhes completos da oferta, incluindo id, name, type, content, workspace e modifiedAt.

Exemplo de prompt: “Obter detalhes da oferta 67890”.

Ferramentas de público tools-audiences

Listar públicos

Ferramenta: list_target_audiences

Liste todos os públicos do seu locatário do Target.

table 0-row-4 1-row-4 2-row-4
Parâmetro Tipo Obrigatório Descrição
limit número inteiro Não Número máximo de públicos-alvo a serem retornados
offset número inteiro Não Número de públicos-alvo a serem ignorados para paginação

Retorna: objeto JSON com audiences (lista de objetos incluindo id, name, description, origin, modifiedAt) e total.

Exemplo de prompt: “Listar todos os públicos-alvo”.

Obter um público

Ferramenta: get_target_audience

Obtenha detalhes do público-alvo, incluindo regras de direcionamento.

Recupera a configuração completa de um público-alvo específico, incluindo suas regras de direcionamento e condições.

table 0-row-4 1-row-4
Parâmetro Tipo Obrigatório Descrição
audience_id número inteiro Sim O identificador exclusivo do público-alvo

Retorna: detalhes completos sobre o público-alvo, incluindo id, name, description, origin, regras de direcionamento e contagem de atividades associada.

Prompt de exemplo: “Obter detalhes do público-alvo 12345 e mostrar suas regras de direcionamento para mim.”

Ferramentas da mbox tools-mboxes

Listar mboxes

Ferramenta: list_target_mboxes

Liste todas as mboxes em seu locatário do Target.

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4
Parâmetro Tipo Obrigatório Descrição
limit número inteiro Não Número máximo de mboxes a serem retornadas
offset número inteiro Não Número de mboxes a serem ignoradas para paginação
name string Não Filtrar por nome de mbox (correspondência parcial)
status string Não Filtrar por status

Retorna: objeto JSON com mboxes (lista de objetos incluindo name, status, lastRequestTime) e total.

Exemplo de prompt: “Listar todas as mboxes contendo ‘homepage’.”

Obter uma mbox

Ferramenta: get_target_mbox

Obtenha informações detalhadas sobre uma mbox específica.

table 0-row-4 1-row-4
Parâmetro Tipo Obrigatório Descrição
mbox_name string Sim O nome da mbox

Retorna: detalhes da mbox, incluindo name, status e lista de atividades usando a mbox.

Prompt de exemplo: “Obter detalhes da mbox ‘homepage-hero’.”

Listar atributos de perfil da mbox

Ferramenta: list_target_mbox_profile_attributes

Liste todos os atributos de perfil de mbox disponíveis para direcionamento.

Nenhum parâmetro é necessário.

Retorna: matriz JSON de objetos de atributo de perfil.

Exemplo de prompt: “Quais atributos de perfil estão disponíveis para direcionamento?”

Ferramentas de propriedade tools-properties

Propriedades da lista

Ferramenta: list_target_properties

Liste todas as propriedades em seu locatário do Target.

As propriedades organizam atividades e controlam o acesso.

Nenhum parâmetro é necessário.

Retorna: Lista de objetos de propriedade incluindo id, name, description e channel.

Prompt de exemplo: “Listar todas as propriedades do Target”.

Ferramentas de relatórios tools-reporting

Obter um relatório de desempenho A/B

Ferramenta: get_ab_performance_report

Obtenha um relatório de desempenho para uma atividade A/B.

Recupera taxas de conversão, aumentos e níveis de confiança.

table 0-row-4 1-row-4 2-row-4
Parâmetro Tipo Obrigatório Descrição
activity_id número inteiro Sim O identificador exclusivo da atividade A/B
report_interval string Não Período do relatório (por exemplo, last7days, last30days ou um intervalo de datas personalizado)

Retorna: métricas de nível de experiência (visitantes, conversões, taxa de conversão), cálculos de aumento, níveis de confiança estatística e métricas de receita (se configuradas).

Prompt de exemplo: “Mostrar o relatório de desempenho do teste A/B 12345 dos últimos 30 dias.”

Obter um relatório de pedidos A/B

Ferramenta: get_ab_orders_report

Obtenha um relatório de pedidos/receita para uma atividade A/B.

table 0-row-4 1-row-4 2-row-4
Parâmetro Tipo Obrigatório Descrição
activity_id número inteiro Sim O identificador exclusivo da atividade A/B
report_interval string Não Período do relatório

Devoluções: Contagens de pedidos, receita e valor médio de pedidos por experiência.

Exemplo de prompt: “Obter o relatório de pedidos para a atividade 12345”.

Obter um relatório de desempenho de Direcionamento de experiência

Ferramenta: get_xt_performance_report

Obtenha um relatório de desempenho para uma atividade de Direcionamento de experiência.

table 0-row-4 1-row-4 2-row-4
Parâmetro Tipo Obrigatório Descrição
activity_id número inteiro Sim O identificador exclusivo da atividade de XT
report_interval string Não Período do relatório

Retorna: métricas de desempenho de nível de experiência.

Prompt de exemplo: “Mostrar desempenho para minha atividade de Direcionamento de Experiência 54321”.

Obter um relatório de pedidos de direcionamento de experiência

Ferramenta: get_xt_orders_report

Obtenha um relatório de pedidos/receita para uma atividade de Direcionamento de experiência.

table 0-row-4 1-row-4 2-row-4
Parâmetro Tipo Obrigatório Descrição
activity_id número inteiro Sim O identificador exclusivo da atividade de XT
report_interval string Não Período do relatório

Retorna: Ordenar métricas por experiência.

Exemplo de prompt: “Obter dados de pedidos para a atividade XT 54321”.

Obtenha um relatório de desempenho por nome de atividade

Ferramenta: get_activity_report_by_name

Procure uma atividade por nome e obtenha o relatório de desempenho.

Útil quando você sabe o nome da atividade, mas não a ID.

table 0-row-4 1-row-4 2-row-4
Parâmetro Tipo Obrigatório Descrição
activity_name string Sim Nome da atividade a ser pesquisada
report_interval string Não Período do relatório

Retorna: detalhes da atividade e métricas de desempenho.

Prompt de exemplo: “Obter o relatório de desempenho da minha atividade ‘Teste de Herói da Página Inicial’.”

Obter um relatório do Analytics for Target (A4T)

Ferramenta: get_a4t_report

Buscar um relatório do Analytics for Target (A4T) para uma atividade Target.

Valida a configuração A4T da atividade e executa consultas GraphQL em Adobe Analytics para recuperar métricas do lado do Analytics. Disponível somente para atividades com relatórios do A4T configurados.

table 0-row-4 1-row-4 2-row-4
Parâmetro Tipo Obrigatório Descrição
activity_id número inteiro Sim O identificador exclusivo da atividade Target
report_interval string Não Período do relatório (por exemplo, last7days, last30days ou um intervalo de datas personalizado)

Retorna: métricas do lado analítico da atividade, incluindo contagens de visitantes, conversões, receita e aumento por experiência, originadas diretamente de Adobe Analytics.

Prompt de exemplo: “Puxe o relatório do A4T para meu teste de otimização de check-out e resuma os dados de conversão do lado do Analytics.”

Ferramentas de visualização tools-preview

Visualizar uma atividade

Ferramenta: preview_activity

Gerar URLs de visualização de QA do navegador para uma atividade Target.

Cria links de visualização clicáveis que forçam a exibição de experiências específicas, ignorando as regras de direcionamento de público-alvo. Funciona para atividades A/B, XT e Automated Personalization.

table 0-row-4 1-row-4 2-row-4 3-row-4
Parâmetro Tipo Obrigatório Descrição
activity_id número inteiro Sim A ID da atividade Target para visualizar
experience_index número inteiro Não Índice de experiência com base em 0. Se omitido, retorna URLs para todas as experiências
url string Não URL da página para visualização. Obrigatório para atividades baseadas em formulário. Para atividades do VEC, substitui o local criado, se fornecido

Retorna: informações de atividade (nome, tipo, estado), URLs de visualização para cada experiência, além de nomes e índices de experiência.

Prompt de exemplo: “Gerar URLs de visualização para a atividade 12345 para que eu possa testar cada experiência no meu navegador.”

Ferramentas de token de resposta tools-response-tokens

Listar tokens de resposta

Ferramenta: list_target_response_tokens

Liste todos os tokens de resposta em seu locatário do Target.

Recupera todos os tokens de resposta configurados, incorporados e personalizados.

Nenhum parâmetro é necessário.

Retorna: matriz JSON de objetos de token de resposta com status name, type e enabled.

Exemplo de prompt: “Listar todos os tokens de resposta”.

Ferramentas de revisão tools-revisions

Obter o log de auditoria

Ferramenta: get_target_revisions

Obter o log de auditoria para um tipo de recurso.

Recupera alterações feitas em Target recursos com filtragem opcional por autor.

table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4
Parâmetro Tipo Obrigatório Descrição
revision_resource_type string Sim Tipo de recurso: activity, offer ou audience
modified_by string Não Filtrar por usuário que fez alterações
limit número inteiro Não Número máximo de revisões retornadas
offset número inteiro Não Número de revisões a serem ignoradas para paginação

Retorna: histórico de revisões com carimbos de data/hora, usuários e descrições de alterações.

Prompt de exemplo: “Mostrar o log de auditoria para alterações de atividades”.

Obter revisões para uma entidade específica

Ferramenta: get_target_entity_revisions

Obtenha todas as revisões de uma entidade específica por ID.

table 0-row-4 1-row-4 2-row-4
Parâmetro Tipo Obrigatório Descrição
revision_resource_type string Sim Tipo de recurso: activity, offer ou audience
entity_id número inteiro Sim O identificador exclusivo da entidade

Retorna: a matriz JSON de todas as revisões da entidade especificada.

Prompt de exemplo: “Mostrar todas as alterações feitas na atividade 12345.”

Ferramentas de modelo tools-templates

Listar modelos disponíveis

Ferramenta: list_target_templates

Liste os recursos e modelos do MCP disponíveis para criar atividades e ofertas.

Nenhum parâmetro é necessário.

Retorna: o objeto JSON está listando os modelos e recursos disponíveis.

Exemplo de prompt: “Quais modelos estão disponíveis para criar atividades?”

Resumo das ferramentas tools-summary

Categoria
Contagem
Ferramentas
Atividade
4
list_target_activities, get_ab_activity, get_xt_activity, get_abt_activity
Oferta
2
list_target_offers, get_target_offer
Público-alvo
2
list_target_audiences, get_target_audience
Mbox
3
list_target_mboxes, get_target_mbox, list_target_mbox_profile_attributes
Propriedade
1
list_target_properties
Relatório
6
get_ab_performance_report, get_ab_orders_report, get_xt_performance_report, get_xt_orders_report, get_activity_report_by_name, get_a4t_report
Visualização
1
preview_activity
Token de resposta
1
list_target_response_tokens
Revisão
2
get_target_revisions, get_target_entity_revisions
Modelo
1
list_target_templates
Total
23
recommendation-more-help
target-help-main