Ortto MCP Server

O que é MCP?

O Model Context Protocol (MCP) é um padrão aberto que permite que agentes de IA (como Claude ou ChatGPT) interajam de forma segura com ferramentas externas e fontes de dados.

Você conecta seu agente de IA (o cliente MCP) diretamente ao servidor MCP da Ortto. Isso permite que seu agente entenda e atue sobre os dados da sua conta Ortto.

Seu agente pode então ajudar com uma variedade de tarefas usando prompts em linguagem natural. Por exemplo:

• "Mostre-me o desempenho das minhas campanhas de e-mail dos últimos 30 dias."
• "Quais jornadas estão tendo o melhor desempenho em termos de conversões?"
• "Obtenha uma lista dos meus contatos mais engajados deste mês."

---

Configurando a fonte de dados MCP

Para começar com nosso recurso MCP, você precisará criar MCP como uma fonte de dados na sua conta Ortto. Siga estes passos para configurá-lo:

1. Na sua conta Ortto, navegue até CDP > Fontes de dados.
2. Clique em Nova fonte de dados e pesquise por MCP.
3. Digite um nome para sua fonte de dados MCP e clique em Conectar.

4. Depois que a fonte de dados for criada, você terá acesso a uma Chave com escopo. Você precisará usar essa chave para conectar a Ortto ao agente de IA de sua escolha (Claude, ChatGPT, etc.).

Agora você está pronto para conectar a Ortto ao seu agente de IA. Dependendo do agente de IA que você está usando, consulte o artigo apropriado abaixo:

• Usando Ortto MCP com Claude
• Usando Ortto MCP com ChatGPT

DICA: Você pode conectar o Ortto MCP a qualquer aplicativo que suporte conectores personalizados. Se o aplicativo que você está usando não estiver listado acima, basta usar a URL do servidor MCP remoto apropriada com base em onde sua conta Ortto está hospedada.

• Estados Unidos: https://mcp-api-us.ortto.app/mcp?jwt=your-scoped-key
• Europa: https://mcp-api-eu.ortto.app/mcp?jwt=your-scoped-key
• Austrália: https://mcp-api-au.ortto.app/mcp?jwt=your-scoped-key

Se você não tiver certeza de onde sua conta está hospedada, você pode descobrir isso no aplicativo navegando até Configurações > Privacidade, Segurança e GDPR > Hospedagem de Dados.

---

Ferramentas/ações suportadas

O servidor MCP da Ortto permite que agentes de IA interajam com seus dados da Ortto por meio de ferramentas/ações específicas. As tabelas a seguir são organizadas por categoria de dados e detalham as ferramentas/ações suportadas junto com suas definições.

DICA: As ferramentas/ações descritas nas tabelas abaixo são apenas a convenção de nomenclatura usada pelo nosso recurso MCP. Você não precisa usar explicitamente esses nomes na ferramenta do seu agente de IA. Seu agente selecionará e usará automaticamente a ferramenta/ação apropriada com base na sua solicitação em linguagem natural.

Gerenciamento de campanhas

Ferramenta/Ação	Descrição
get_campaigns	Recupere uma lista das suas campanhas com opções de filtragem e paginação. Suporta filtros por tipo de campanha, estado e consultas de pesquisa.

Exemplos:

• "Mostre-me todas as minhas campanhas de e-mail do último mês"
• "Obtenha campanhas que estão em execução atualmente"
• "Encontre campanhas com 'verão' no nome"

Contatos e Públicos

Ferramenta/Ação	Descrição
get_contacts	Recupere contatos com opções abrangentes de filtragem, incluindo ID do público, seleção de campos e recursos de pesquisa.
get_audiences	Liste todos os públicos na sua conta com suporte a pesquisa e paginação.

Exemplos:

• "Recupere quaisquer contatos com 'silva' no nome"
• "Encontre públicos que tenham menos de 1.000 membros"
• "Mostre-me os endereços de e-mail e nomes dos últimos 10 contatos que se cadastraram"

Relatórios de campanhas

Ferramenta/Ação	Descrição
get_email_report	Gere relatórios detalhados de desempenho de campanhas de e-mail, incluindo taxas de abertura, taxas de clique e métricas de engajamento.
get_journey_report	Obtenha análises abrangentes de desempenho de jornadas com períodos personalizáveis.
get_journey_shape_report	Analise formatos específicos de jornadas e suas métricas.
get_sms_report	Recupere dados de desempenho de campanhas de SMS e estatísticas de engajamento.
get_push_report	Acesse análises de campanhas de notificações push e métricas de entrega.

Exemplos:

• "Gere um relatório de e-mail para a campanha 'Promoção de Natal'"
• "Qual é o desempenho geral da jornada 'Carrinho Abandonado'?"

Relatórios personalizados

Ferramenta/Ação	Descrição
list_reports	Acesse relatórios criados pelo usuário na sua conta Ortto com filtros por tipo de gráfico e recursos de pesquisa.
get_report	Recupere dados específicos de relatórios com períodos personalizáveis e opções de atualização.

Exemplos:

• "Liste todos os relatórios de gráfico de pizza na minha conta"
• "Recupere os dados do relatório 'Receita do Q3'"

Conta e configuração

Ferramenta/Ação	Descrição
get_schema	Recupere o esquema completo de dados da sua instância Ortto, incluindo campos personalizados e estrutura de dados.
get_brand_book	Acesse as configurações do seu guia de marca, incluindo cores, fontes e elementos de branding.

Exemplos:

• "Quais são as cores primária e secundária definidas no nosso guia de marca?"
• "Recupere todos os campos personalizados na minha conta que tenham 'exemplo' no nome"

Gerenciamento de ativos

Ferramenta/Ação	Descrição
create_asset	Crie novos ativos, principalmente e-mails em HTML, com conteúdo e metadados personalizáveis.
get_asset_html	Recupere o conteúdo HTML de ativos existentes para revisão ou modificação.
update_asset_meta	Atualize metadados de ativos, incluindo nomes, linhas de assunto e informações do remetente.

Exemplos:

• "Crie um novo ativo de e-mail promocional intitulado 'Não Perca as Ofertas' com conteúdo explicando por que os usuários não devem perder a próxima promoção"
• "Recupere o conteúdo HTML do ativo chamado 'E-mail de Boas-Vindas v2'"

Base de conhecimento

Ferramenta/Ação	Descrição
get_index	Recupere a estrutura da base de conhecimento, incluindo categorias e hierarquia de artigos.
create_category	Crie novas categorias na base de conhecimento com relações opcionais de pai-filho.
create_article_from_html	Crie artigos na base de conhecimento a partir de conteúdo HTML com categorização.
move_article	Mova artigos entre categorias na sua base de conhecimento.
modify_index	Atualize a estrutura do índice da base de conhecimento e sua organização.

Exemplos:

• "Gere um artigo para a base de conhecimento a partir deste HTML e intitule-o 'Visão Geral do MCP'"
• "Crie uma nova categoria chamada 'Solução de Problemas'"
• "Mostre-me a estrutura atual da base de conhecimento"

---

Limites de solicitações

Quando você usa um agente de IA por meio do recurso MCP da Ortto, encontrará dois conjuntos diferentes de limites. Embora os agentes de IA (como Claude ou ChatGPT) apliquem seus próprios limites em relação ao comprimento da solicitação e ao tamanho da resposta, todas as chamadas de API roteadas pelo servidor MCP da Ortto estão sujeitas aos nossos limites padrão de taxa da API Ortto. Esses limites de taxa se aplicam com base no seu plano de assinatura e são implementados para garantir a estabilidade do sistema e o uso justo.

Saiba mais sobre nossos limites de taxa da API.