Cómo usar el servidor MCP de systeme.io (Model Context Protocol)

La nueva función de servidor MCP le ofrece a los usuarios, partners y desarrolladores una forma potente de interactuar con systeme.io usando herramientas de IA.

¿Qué es MCP?

MCP (Model Context Protocol) es un estándar que les permite a los asistentes de IA (como ChatGPT o Claude) conectarse de forma segura a plataformas externas.

Con MCP, puedes usar comandos en lenguaje natural para interactuar con los datos de tu cuenta de systeme.io. Por ejemplo, puedes pedirle a ChatGPT que busque un contacto o asigne una etiqueta con solo escribir una frase.

Nuestra función MCP actualmente brinda acceso directo a funciones específicas para la gestión de contactos, permitiéndote usar la IA para gestionar a tus contactos, etiquetas y campos de contacto.

¿Cómo funciona nuestra función MCP?

El servidor MCP de systeme.io le permite a las aplicaciones de IA acceder a herramientas específicas para la gestión de contactos dentro de tu cuenta.

Crea un puente entre:

• El host: tu herramienta de IA (ej., ChatGPT, Claude).
• El servidor: tu cuenta de systeme.io.

Una vez conectada, la IA puede ejecutar comandos para gestionar automáticamente tus contactos y etiquetas.

Para detalles técnicos, consulta nuestra documentación oficial de MCP: https://developer.systeme.io/docs/mcp-server

Cómo generar tus claves MCP

Para conectar una herramienta de IA, primero necesitas generar una clave MCP segura.

Haz clic en tu foto de perfil y selecciona Configuración (1).

En el menú izquierdo, haz clic en Claves MCP y API (2).

Desplázate hasta la sección Claves MCP y haz clic en Crear (3).

Asígnale un nombre a tu clave, establece una fecha de expiración y haz clic en Guardar (4)

Tu clave ya está lista.

¿Qué puedes hacer con nuestro MCP?

Puedes usar herramientas de IA para ejecutar las siguientes acciones:

• Crear y actualizar contactos: Agregar nuevos contactos o actualizar los existentes.
• Eliminar contactos: Quitar contactos de tu lista.
• Listar y recuperar contactos: Usar filtros para listar contactos u obtener detalles específicos de un contacto.
• Gestionar etiquetas: Crear, asignar, listar y eliminar etiquetas de los contactos.
• Recuperar campos de contacto (campos personalizados): Listar los campos de contacto disponibles y sus identificadores (slugs) para que la IA pueda completar y actualizar correctamente la información del contacto.

Cómo integrar tu cuenta con ChatGPT usando claves MCP

Conectar ChatGPT a tu cuenta de systeme.io es sencillo. Necesitarás un plan o espacio de trabajo de ChatGPT que permita conectarse a servidores MCP o herramientas externas.

Para una tutorial detallada paso a paso, consulta nuestra guía completa sobre cómo integrar ChatGPT con systeme.io usando claves MCP: https://developer.systeme.io/docs/mcp-integration-with-chatgpt

Cómo integrar su cuenta con Claude usando claves MCP (en Windows)

Para conectar tu cuenta de systeme.io a Claude Desktop, necesitarás agregar tu clave MCP a tu archivo claude_desktop_config.json.

Si experimentas errores de "Servidor desconectado" o carga infinita, necesitarás ajustar tu configuración para evitar las limitaciones estándar de Windows. Asegúrate de aplicar las siguientes reglas:

1. Usa la ruta corta de Windows: Si Node.js está instalado en una carpeta con espacios (como C:\Program Files\nodejs ), romperá la conexión de fondo. Usa la ruta corta "C:\\PROGRA~1\\nodejs\\npx.cmd"  en lugar de simplemente "npx"     .
2. Agrega la -y    bandera: Incluye "-y"   en tus argumentos para evitar los mensajes de instalación ocultos que pueden causar que la conexión se cuelgue.
3. Incluye el /mcp   sufijo de URL: Asegúrate de que tu URL de punto final sea exactamente https://mcp.systeme.io/mcp   (solo la URL base no funcionará).

Ejemplo de la implementación de una configuración en Windows:

"systeme-io": {
  "command": "C:/PROGRA~1/nodejs/npx.cmd",
  "args":[
    "-y",
    "mcp-remote",
    "https://mcp.systeme.io/mcp",
    "--header",
    "X-MCP-Key: <YOUR_MCP_KEY_HERE>"
  ]
}