Saltar al contenido principal

Conéctate al MCP de Sinch Engage (UE)

Actualización

Esta guía explica cómo conectarte al servidor del MCP de Sinch Engage para la región de la UE: cómo generar las credenciales de la API y cómo agregar el servidor en Claude Code a través de la terminal.

Punto de conexión

Esta guía utiliza el punto de conexión de la región de la UE:

https://eu.app.api.sinch.com/mcp

Utiliza el punto de conexión que coincida con la región en la que está aprovisionada tu cuenta de Engage. Si tu cuenta está en la región de AU, sigue la guía de AU. Si no estás seguro de tu región, puedes encontrarla iniciando sesión en tu cuenta de Sinch Engage > navegando a ajustes > Ajustes de API - desde aquí verás la sección "Ajustes de API & Webhook", que mostrará tu punto de conexión específico de la región. 

Ajustes de API & Webhook - EU.png

Paso 1: Generar las credenciales de la API (Autenticación básica)

Requisitos previos

  • Debes ser un Administrador de la cuenta. Los usuarios con permisos básicos o avanzados no pueden crear ni administrar claves de API.
  • Las credenciales solo pueden crearse en una cuenta verificada. Si tu cuenta no está verificada, solicita la verificación primero.

Pasos

  1. Accede a tu cuenta de Sinch Engage 
  2. Navega a Ajustes > Ajustes de API, desplázate hasta Autenticación básica y haz clic en Crear nueva clave.
  3. Introduce un nombre descriptivo y haz clic en Crear clave.
  4. En el cuadro de diálogo de confirmación, copia la credencial codificada en Base64 y luego haz clic en Aceptar. Este es el valor que debes pegar directamente después de Basic en el encabezado Authorization.

La credencial se muestra solo una vez. Guárdala en un lugar seguro inmediatamente. Si la pierdes, debes crear una clave nueva.

Consulta la guía completa sobre cómo crear nuevas credenciales de la API para obtener más información.

Paso 2: Instalar e iniciar Claude Code

Claude Code es el asistente de Anthropic que se ejecuta en la terminal de tu computadora. La terminal es una aplicación integrada que te permite escribir instrucciones para tu computadora. Solo necesitas hacer esta configuración una vez.

Requisitos previos

  • Necesitas un plan de pago de Claude (Pro, Max, Team o Enterprise). El plan gratuito no incluye Claude Code.
  • Necesitas una conexión a internet.

Pasos

  1. Abre la terminal.
    • Mac: Pulsa Cmd + Espacio, escribe Terminal y pulsa Intro.
    • Windows: Haz clic en el menú Inicio, escribe PowerShell y ábrelo.

  2. Instala Claude Code. Copia la línea que coincida con tu equipo, pégala en la terminal y pulsa Intro. La instalación tarda un par de minutos y no necesita que se instale nada más antes.

    • Mac:

      bash

    • curl -fsSL https://claude.ai/install.sh | bash

    • Windows (PowerShell):

      powershell

    • irm https://claude.ai/install.ps1 | iex

    • Si un comando no funciona, obtén el comando de instalación actual de la página oficial de configuración (enlazada arriba), ya que estos pueden cambiar.

  3. Iniciar sesión. Escribe la palabra a continuación y pulsa Intro:

    • bash

  4. claude

    • La primera vez, se abre una ventana del navegador que te pide que inicies sesión en tu cuenta de Claude. Inicia sesión, luego vuelve a la terminal.

  5. Vuelve a la terminal normal.

    • Una vez iniciada la sesión, escribe /exit y pulsa Intro para salir de Claude Code y volver al símbolo del sistema normal de la terminal. Ahora ya estás listo para conectar el servidor de Engage en el paso 3.

      • Consejo: si alguna vez ves claude: command not found, cierra la ventana de la terminal, abre una nueva e inténtalo de nuevo.

    • Las instrucciones detalladas de Claude Code en la terminal se pueden ver aquí: https://docs.claude.com/en/docs/claude-code/setup

Paso 3: Conectar usando Claude Code en la terminal

Usa el comando claude mcp add en tu interfaz de línea de comandos.

Sustituye <your-credential> por la credencial Base64 del paso 1. Todos los indicadores deben ir antes del nombre del servidor.

claude mcp add --transport http sinch-engage-eu https://eu.app.api.sinch.com/mcp \
  --header "Authorization: Basic <your-credential>"

Añade --scope user para que el servidor esté disponible en todos los proyectos, o --scope project para compartirlo con un equipo a través de un .mcp.json confirmado. El alcance predeterminado (local) es privado para ti en el proyecto actual.

La CLI oculta el encabezado en su salida de confirmación, para que la credencial no termine en el historial de tu shell.

Alternativa: add-json

claude mcp add-json sinch-engage-eu '{"type":"http","url":"https://eu.app.api.sinch.com/mcp","headers":{"Authorization":"Basic <your-credential>"}}'

Para mantener la credencial fuera de un archivo confirmado, haz referencia a una variable de entorno en lugar de codificarla de forma rígida:

"headers": {
  "Authorization": "Basic ${SINCH_ENGAGE_CREDENTIAL}"
}

Verifica con claude mcp list en la terminal, o con /mcp dentro de una sesión de Claude Code.

Para obtener más información sobre cómo conectar MCP a Claude Code, puedes ver el artículo aquí: https://code.claude.com/docs/en/mcp 

Solución de problemas

  • La conexión falla de inmediato en Claude Code: si configuraste un encabezado estático de Authorization y el servidor lo rechaza, Claude Code informa que la conexión ha fallado en lugar de recurrir a OAuth. Vuelve a comprobar que la credencial se haya pegado completa (sin espacios en blanco al principio ni al final) y que sea una credencial de la región de la UE.
  • error: missing required argument 'name': se colocó un indicador (por ejemplo, --header) después del nombre del servidor. Todas las opciones deben ir antes del nombre.
  • Región incorrecta: esta guía utiliza el punto de conexión de la UE. Las credenciales de AU no se autenticarán con él. Los clientes de AU deben usar la guía de AU.
  • Credencial perdida: la credencial solo se muestra una vez. Crea una nueva clave si no se guardó.

Notas de seguridad

  • Trata la credencial como una contraseña. No la confirmes en el control de código fuente. Usa la expansión de variables de entorno en los archivos de configuración compartidos.
  • Rota las credenciales si es posible que se hayan expuesto (por ejemplo, pegadas en un repositorio o registro compartido).

Relacionada con

Artículos relacionados