Ortto MCP Server

¿Qué es MCP?

El Model Context Protocol (MCP) es un estándar abierto que permite a los agentes de IA (como Claude o ChatGPT) interactuar de forma segura con herramientas y fuentes de datos externas.

Conectas tu agente de IA (el cliente MCP) directamente al servidor MCP de Ortto. Esto permite que tu agente comprenda y actúe sobre tus datos de Ortto.

Tu agente puede entonces ayudarte con una variedad de tareas usando indicaciones en lenguaje natural. Por ejemplo:

• "Muéstrame el rendimiento de mis campañas de correo electrónico de los últimos 30 días."
• "¿Qué recorridos están teniendo el mejor rendimiento en términos de conversiones?"
• "Dame una lista de mis contactos más comprometidos de este mes."

---

Configuración de la fuente de datos MCP

Para comenzar con nuestra función MCP, deberás crear MCP como una fuente de datos en tu cuenta de Ortto. Sigue estos pasos para configurarlo:

1. En tu cuenta de Ortto, navega a CDP > Fuentes de datos.
2. Haz clic en Nueva fuente de datos y busca MCP.
3. Ingresa un nombre para tu fuente de datos MCP y haz clic en Conectar.

4. Una vez que se cree la fuente de datos, tendrás acceso a una clave de alcance. Deberás usar esta clave para conectar Ortto al agente de IA de tu elección (Claude, ChatGPT, etc.).

Ahora estás listo para conectar Ortto a tu agente de IA. Según el agente de IA que estés usando, consulta el artículo correspondiente a continuación:

• Uso de Ortto MCP con Claude
• Uso de Ortto MCP con ChatGPT

CONSEJO: Puedes conectar Ortto MCP con cualquier aplicación que admita conectores personalizados. Si la aplicación que estás usando no aparece en la lista anterior, simplemente usa la URL del servidor MCP remoto adecuada según dónde esté alojada tu cuenta de Ortto.

• 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
• Australia: https://mcp-api-au.ortto.app/mcp?jwt=your-scoped-key

Si no estás seguro de dónde está alojada tu cuenta, puedes encontrarlo en la aplicación navegando a Configuración > Privacidad, Seguridad y GDPR > Alojamiento de datos.

---

Herramientas/acciones compatibles

El servidor MCP de Ortto permite que los agentes de IA interactúen con tus datos de Ortto mediante herramientas/acciones específicas. Las siguientes tablas están organizadas por categoría de datos y detallan las herramientas/acciones compatibles junto con sus definiciones.

CONSEJO: Las herramientas/acciones descritas en las tablas a continuación son solo la convención de nomenclatura utilizada por nuestra función MCP. No tienes que usar explícitamente estos nombres en la herramienta de tu agente de IA. Tu agente seleccionará y usará automáticamente la herramienta/acción adecuada según tu solicitud en lenguaje natural.

Gestión de campañas

Herramienta/Acción	Descripción
get_campaigns	Recupera una lista de tus campañas con opciones de filtrado y paginación. Admite filtrado por tipo de campaña, estado y consultas de búsqueda.

Ejemplos:

• "Muéstrame todas mis campañas de correo electrónico del último mes"
• "Obtén las campañas que están en ejecución actualmente"
• "Encuentra campañas con 'verano' en el nombre"

Contactos y Audiencias

Herramienta/Acción	Descripción
get_contacts	Recupera contactos con opciones de filtrado exhaustivas que incluyen ID de audiencia, selección de campos y capacidades de búsqueda.
get_audiences	Lista todas las audiencias en tu cuenta con soporte de búsqueda y paginación.

Ejemplos:

• "Recupera cualquier contacto con 'smith' en su nombre"
• "Encuentra audiencias que tengan menos de 1,000 miembros"
• "Muéstrame las direcciones de correo electrónico y los nombres de los últimos 10 contactos que se registraron"

Informes de campaña

Herramienta/Acción	Descripción
get_email_report	Genera informes detallados de rendimiento de campañas de correo electrónico, incluyendo tasas de apertura, tasas de clics y métricas de participación.
get_journey_report	Obtén análisis completos del rendimiento de los recorridos con marcos de tiempo personalizables.
get_journey_shape_report	Analiza formas específicas de recorridos y sus métricas.
get_sms_report	Recupera datos de rendimiento de campañas SMS y estadísticas de participación.
get_push_report	Accede a análisis de campañas de notificaciones push y métricas de entrega.

Ejemplos:

• "Genera un informe de correo electrónico para la campaña 'Venta de vacaciones'"
• "¿Cuál es el rendimiento general del recorrido 'Carrito abandonado'?"

Informes personalizados

Herramienta/Acción	Descripción
list_reports	Accede a informes creados por el usuario desde tu cuenta de Ortto con filtrado por tipo de gráfico y capacidades de búsqueda.
get_report	Recupera datos de informes específicos con marcos de tiempo personalizables y opciones de actualización.

Ejemplos:

• "Lista todos los informes de gráfico circular en mi cuenta"
• "Recupera los datos del informe 'Ingresos del tercer trimestre'"

Cuenta y configuración

Herramienta/Acción	Descripción
get_schema	Recupera el esquema de datos completo de tu instancia de Ortto, incluidos los campos personalizados y la estructura de datos.
get_brand_book	Accede a la configuración de tu libro de marca, incluidos colores, fuentes y elementos de marca.

Ejemplos:

• "¿Cuáles son los colores de marca primarios y secundarios definidos en nuestro libro de marca?"
• "Recupera todos los campos personalizados en mi cuenta que tengan 'ejemplo' en su nombre"

Gestión de activos

Herramienta/Acción	Descripción
create_asset	Crea nuevos activos, principalmente correos electrónicos HTML, con contenido y metadatos personalizables.
get_asset_html	Recupera el contenido HTML de los activos existentes para revisión o modificación.
update_asset_meta	Actualiza los metadatos de los activos, incluidos nombres, líneas de asunto e información del remitente.

Ejemplos:

• "Crea un nuevo activo de correo electrónico promocional titulado 'Ofertas que no puedes perderte' con contenido que explique por qué los usuarios no deberían perderse la próxima venta"
• "Recupera el contenido HTML del activo llamado 'Correo de bienvenida v2'"

Base de conocimientos

Herramienta/Acción	Descripción
get_index	Recupera la estructura de la base de conocimientos, incluidas las categorías y la jerarquía de artículos.
create_category	Crea nuevas categorías de base de conocimientos con relaciones opcionales de padre-hijo.
create_article_from_html	Crea artículos de base de conocimientos a partir de contenido HTML con categorización.
move_article	Mueve artículos entre categorías en tu base de conocimientos.
modify_index	Actualiza la estructura y organización del índice de la base de conocimientos.

Ejemplos:

• "Genera un artículo de base de conocimientos a partir de este HTML y titúlalo 'Resumen de MCP'"
• "Crea una nueva categoría llamada 'Solución de problemas'"
• "Muéstrame la estructura actual de la base de conocimientos"

---

Límites de solicitudes

Cuando usas un agente de IA a través de la función MCP de Ortto, encontrarás dos conjuntos diferentes de límites. Mientras que los agentes de IA (como Claude o ChatGPT) imponen sus propios límites en cuanto a la longitud de las solicitudes y el tamaño de las respuestas, todas las llamadas a la API enrutadas a través del servidor MCP de Ortto están sujetas a nuestros límites de tasa estándar de la API de Ortto. Estos límites de tasa se aplican según tu plan de suscripción y se implementan para garantizar la estabilidad del sistema y un uso justo.

Obtén más información sobre nuestros límites de tasa de API.