Ortto MCP Server

Acesse ortto.com

Início Ortto MCP Ortto MCP

Ortto MCP

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 seus dados da 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 performando melhor 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 a usar nosso recurso MCP, você precisará criar o MCP como uma fonte de dados na sua conta Ortto. Siga estas etapas para configurá-lo:

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

4. Uma vez que a fonte de dados for criada, você terá acesso a uma Chave com escopo definido. 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 com qualquer aplicativo que suporte conectores personalizados. Se o aplicativo que você está usando não estiver listado acima, basta usar a URL remota do servidor MCP 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, pode encontrar essa informação 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 estão organizadas por categoria de dados e detalham as ferramentas/ações suportadas juntamente 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 sua ferramenta de 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	Recupera uma lista de suas campanhas com opções de filtragem e paginação. Suporta filtragem 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 no momento"
• "Encontre campanhas com 'verão' no nome"

Contatos e Públicos

Ferramenta/Ação	Descrição
get_contacts	Recupera contatos com opções abrangentes de filtragem, incluindo ID do público, seleção de campos e capacidades de pesquisa.
get_audiences	Lista todos os públicos em 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 inscreveram"

Relatórios de campanha

Ferramenta/Ação	Descrição
get_email_report	Gera relatórios detalhados de desempenho de campanhas de e-mail, incluindo taxas de abertura, taxas de cliques e métricas de engajamento.
get_journey_report	Obtém análises abrangentes de desempenho de jornadas com intervalos de tempo personalizáveis.
get_journey_shape_report	Analisa formas de jornada específicas e suas métricas.
get_sms_report	Recupera dados de desempenho de campanhas de SMS e estatísticas de engajamento.
get_push_report	Acessa análises de campanhas de notificação push e métricas de entrega.

Exemplos:

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

Relatórios personalizados

Ferramenta/Ação	Descrição
list_reports	Acessa relatórios criados pelo usuário em sua conta Ortto com filtragem por tipo de gráfico e capacidades de pesquisa.
get_report	Recupera dados de relatórios específicos com intervalos de tempo 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 3º Trimestre'"

Conta e configuração

Ferramenta/Ação	Descrição
get_schema	Recupera o esquema de dados completo para sua instância Ortto, incluindo campos personalizados e estrutura de dados.
get_brand_book	Acessa as configurações do seu brand book, incluindo cores, fontes e elementos de marca.

Exemplos:

• "Quais são as cores primárias e secundárias da marca definidas em nosso brand book?"
• "Recupere todos os campos personalizados na minha conta que tenham 'exemplo' no nome"

Gerenciamento de ativos

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

Exemplos:

• "Crie um novo ativo de e-mail promocional intitulado 'Economias Imperdíveis' com conteúdo explicando por que os usuários não devem perder a próxima venda"
• "Recupere o conteúdo HTML do ativo chamado 'E-mail de Boas-vindas v2'"

Base de conhecimento

Ferramenta/Ação	Descrição
get_index	Recupera a estrutura da base de conhecimento, incluindo categorias e hierarquia de artigos.
create_category	Cria novas categorias na base de conhecimento com relacionamentos opcionais de pai-filho.
create_article_from_html	Cria artigos na base de conhecimento a partir de conteúdo HTML com categorização.
move_article	Move artigos entre categorias na sua base de conhecimento.
modify_index	Atualiza a estrutura e organização do índice da base de conhecimento.

Exemplos:

• "Gere um artigo da 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

Ao usar um agente de IA por meio do recurso Ortto MCP, você encontrará dois conjuntos diferentes de limites. Embora os agentes de IA (como Claude ou ChatGPT) imponham 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 de taxa padrão 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.