Conéctate al MCP de Sinch Engage (AU) – Sinch Engage

Esta guía explica cómo conectarte al servidor MCP de Sinch Engage para la región AU: cómo generar credenciales de la API y añadir 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 AU:

https://au.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 la UE, sigue la guía de la UE. Si no estás seguro de tu región, confírmalo con el administrador de tu cuenta. Las credenciales y los puntos de conexión son específicos de la región.

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

Accede a tu cuenta de Sinch Engage
Navega a Ajustes > Ajustes de API, desplázate hasta Autenticación básica y haz clic en Crear nueva clave.
Introduce un nombre descriptivo y haz clic en Crear clave.
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

Abre la terminal.
- Mac: Pulsa Cmd + Espacio, escribe Terminal y pulsa Intro.
- Windows: Haz clic en el menú Inicio, escribe PowerShell y ábrelo.
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.
Iniciar sesión. Escribe la palabra a continuación y pulsa Intro:
- bash
```
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.
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-au https://au.app.api.sinch.com/mcp \
  --header "Authorization: Basic <tu-credencial>"

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-au '{"type":"http","url":"https://au.app.api.sinch.com/mcp","headers":{"Authorization":"Basic <tu-credencial>"}}'

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 pegó por completo (sin espacios en blanco al principio ni al final) y que es una credencial de la región AU.
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 AU. Las credenciales de la UE no se autenticarán en él. Los clientes de la UE deben usar la guía de la UE.
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).