Configuración del MCP

El Model Context Protocol (MCP) de Caramelo AI es un estándar abierto que permite conectar asistentes de Inteligencia Artificial (como Claude Desktop, ChatGPT y Gemini) directamente a los datos de su proyecto de forma segura y en tiempo real.

Con esta integración, la IA de su elección adquiere la capacidad de consultar y analizar métricas, leads, conversaciones y el rendimiento de sus campañas de forma autónoma y segura.

🚀 Cómo acceder al panel MCP

1. Acceda al Panel de Administración de Caramelo AI.
2. Navegue hasta su proyecto.
3. En el menú lateral, acceda a Integraciones.
4. En la tarjeta Model Context Protocol (MCP), haga clic en Gestionar.

En esta página, encontrará su URL de Conexão exclusiva del proyecto y la lista de conexiones activas.

⚙️ Instrucciones de Configuración por Cliente

La URL de conexión de su proyecto tiene el siguiente formato estándar: https://api.carameloai.com/mcp/projects/<PROJECT_ID>

🟣 Claude Desktop (Conexión Local/stdio)

Para disponibilizar los datos de su proyecto Caramelo AI en su Claude Desktop local, puede usar el puente npx provisto por el SDK oficial del MCP.

1. Abra o cree el archivo de configuración de Claude Desktop en su sistema operativo:
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
2. Inserte la siguiente estrutura bajo la clave mcpServers (reemplazando la URL por la URL copiada de su Panel):

{
  "mcpServers": {
    "caramelo-vendedor": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/sdk",
        "connect",
        "https://api.carameloai.com/mcp/projects/SU_PROJECT_ID"
      ]
    }
  }
}

3. Reinicie Claude Desktop. Aparecerá un icono de enchufe (plug) en el chat indicando que las herramientas se han cargado y están listas para usarse.

🟢 ChatGPT (Custom GPTs / Connectors)

ChatGPT admite la integración remota con el flujo de autorización automática (OAuth 2.1) y el registro dinámico.

1. En ChatGPT, acceda a Explore GPTs -> Create GPT.
2. En la pestaña Configure, desplácese hasta Actions y haga clic en Create new action.
3. En la sección de Autenticación, seleccione OAuth y complete la configuración utilizando la URL base de conexión obtenida en el panel. ChatGPT realizará el autorregistro (DCR) en nuestro servidor.
4. Cuando el usuario interactúe con el Custom GPT por primera vez, será redirigido a la pantalla de inicio de sesión y consentimiento de Caramelo AI.
5. Tras aprobar, la conexión se establecerá y aparecerá listada en las Conexiones Activas de su panel.

🔵 Gemini CLI / Clientes compatibles con SSE

Para herramientas CLI o clientes personalizados que utilizan transporte a través de Server-Sent Events (SSE):

• Configure el cliente apuntando a la URL de conexión HTTP de su proyecto.
• El cliente MCP recibirá un desafío 401 Unauthorized con el encabezado WWW-Authenticate que contiene la información de la pantalla de consentimiento.
• Siga las instrucciones del cliente para completar la autenticación en el navegador.

📊 Herramientas Disponibles para la IA

Una vez conectado, el asistente de IA podrá activar las siguientes herramientas (tools) cuando lo solicite en el chat:

🔒 Seguridad y Control

[!IMPORTANT] Aislamiento de Datos: Cada conexión está estrictamente vinculada al proyecto seleccionado. El asistente no puede visualizar datos de otros proyectos sin una nueva autorización explícita.

[!TIP] Revocación Instantánea: Si pierde el acceso al dispositivo o desea finalizar la conexión de un asistente de IA, vaya a la sección Conexiones Activas en la página de MCP en el panel y haga clic en Revocar al lado de la conexión correspondiente. El token se invalidará de inmediato.

[!WARNING] Límites de Petición (Rate Limiting): Para garantizar la estabilidad de la plataforma, cada proyecto tiene un límite de 30 peticiones por minuto al servidor MCP.

🙋 Preguntas Frecuentes (FAQ)