Conecta Ringhum con Claude y otras herramientas de IA (MCP)

Ringhum tiene un servidor MCP. MCP (Model Context Protocol) es una forma estándar para que las aplicaciones de IA usen herramientas externas. Una vez que conectas Ringhum con una aplicación de IA como Claude o ChatGPT, puedes hacerle preguntas sobre tu espacio de trabajo en lenguaje natural. Por ejemplo: "Resume las llamadas perdidas de ayer", "¿Qué personas pidieron una devolución de llamada esta semana?" o "Añade nuestro nuevo horario de apertura a las preguntas frecuentes". La aplicación de IA funciona con las mismas reglas y permisos que la API de Ringhum.

Qué necesitas

• URL del servidor: https://ringhum.com/mcp. También se muestra en la tarjeta Servidor MCP de la página Desarrolladores, con un botón Copiar.
• Una aplicación de IA compatible con servidores MCP remotos, como Claude, ChatGPT, Claude Code, Cursor, Windsurf o VS Code.
• Rol de Propietario o Administrador en el espacio de trabajo. Solo los propietarios y administradores pueden conectar una aplicación o crear una clave de API.

Hay dos formas de conectar. Iniciar sesión es la más sencilla y va bien para aplicaciones de chat como Claude y ChatGPT. Una clave de API va bien para herramientas de desarrollo que aceptan una URL y una cabecera.

Acceso de solo lectura o de lectura y modificación

Tú eliges cuánto puede hacer la aplicación de IA.

Con acceso de solo lectura, las herramientas que cambian cosas ni siquiera se ofrecen a la aplicación.

Importante: Con acceso de modificación, la aplicación de IA puede enviar mensajes reales y hacer llamadas reales a tus clientes. Ringhum marca estas herramientas como que salen de tu espacio de trabajo, y las eliminaciones como destructivas, así que la mayoría de las aplicaciones de IA te preguntan antes de ejecutarlas. Lee lo que la aplicación va a hacer antes de aprobarlo.

Conecta Claude iniciando sesión

1. En Claude (en la web, escritorio o móvil), abre Ajustes → Conectores y elige Añadir conector personalizado.
2. Pega https://ringhum.com/mcp como URL y guarda.
3. Haz clic en Conectar. Se abre una página de Ringhum. Inicia sesión si se te pide.
4. En la página Conectar, elige el Espacio de trabajo que puede usar la aplicación.
5. En Qué puede hacer, elige Consultar o Consultar y hacer cambios.
6. Haz clic en Permitir. Vuelves a Claude.

La aplicación nunca ve tu contraseña. Los nombres exactos de los menús en Claude pueden cambiar con el tiempo; busca conectores o integraciones en sus ajustes.

ChatGPT: añade la URL como conector personalizado (servidor MCP) en Ajustes → Aplicaciones y conectores, luego haz clic en Conectar y sigue los pasos 3 a 6.

Claude Code: ejecuta el siguiente comando, luego ejecuta /mcp y elige Autenticar.

claude mcp add --transport http ringhum https://ringhum.com/mcp

Después de permitir el acceso, la conexión se renueva sola mientras la sigas usando. Si la aplicación no se usa durante 90 días, tendrás que volver a conectarla.

Conecta con una clave de API

Usa esto para herramientas que te permiten configurar una cabecera de solicitud, o cuando no quieras iniciar sesión.

1. En Desarrolladores, crea una clave de API. Marca solo lectura para una conexión de solo lectura, o lectura y escritura para permitir cambios. Consulta Claves de API y permisos.
2. Añade el servidor a tu aplicación con la clave en la cabecera Authorization.

Claude Code:

claude mcp add --transport http ringhum https://ringhum.com/mcp \
  --header "Authorization: Bearer ck_live_…"

Cursor (~/.cursor/mcp.json), Windsurf y Claude Desktop:

{
  "mcpServers": {
    "ringhum": {
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

VS Code (.vscode/mcp.json):

{
  "servers": {
    "ringhum": {
      "type": "http",
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

Una aplicación que solo puede ejecutar servidores locales puede conectarse mediante npx mcp-remote https://ringhum.com/mcp --header "Authorization: Bearer ck_live_…".

Qué cubren las herramientas

Toda operación de la API de Ringhum está disponible como herramienta: tu cuenta y uso, asistentes, números de teléfono, llamadas y transcripciones, contactos, citas y disponibilidad, pedidos y productos, reservas de habitaciones, la bandeja de entrada, mensajes de texto y WhatsApp, campañas, webhooks, el perfil de empresa, servicios, preguntas frecuentes y base de conocimiento, preguntas sin responder, enlaces de pago, solicitudes de reseña, ingresos y protección contra spam. Las grabaciones de llamadas son la única excepción: no están disponibles como herramienta.

Cada herramienta ejecuta la solicitud de API correspondiente, así que se aplican los mismos límites del plan, la misma validación y los mismos límites de peticiones. Las llamadas a herramientas cuentan para el límite de 120 solicitudes por minuto de la API. La lista completa de herramientas está en la sección MCP de la referencia de la API en /docs.

Ver y desconectar aplicaciones conectadas

Las aplicaciones que conectaste iniciando sesión se listan en Desarrolladores, en Apps de IA conectadas, con quién las conectó, su Acceso (Solo lectura o Leer y modificar) y cuándo se usaron por última vez.

Para quitar una aplicación, haz clic en Desconectar y confirma. Pierde el acceso al instante y hay que volver a aprobarla. Para cambiar el acceso de una aplicación, desconéctala y vuelve a conectarla con la otra opción.

Para una conexión hecha con una clave de API, revoca la clave en Claves de API.

Solución de problemas

"Solo los propietarios y administradores de un espacio de trabajo pueden conectar aplicaciones." Pide al propietario del espacio de trabajo que conecte la aplicación, o que te haga Administrador. Consulta Invita a tu equipo.

"La solicitud de inicio de sesión ha caducado. Vuelve a empezar a conectar desde tu aplicación de IA." La página de aprobación estuvo abierta demasiado tiempo. Vuelve a empezar desde la aplicación de IA.

La aplicación dice que no está autorizada, o te pide iniciar sesión de nuevo. La aplicación se desconectó, la clave se revocó, o ya no eres miembro del espacio de trabajo. Vuelve a conectarla.

La aplicación no puede hacer cambios. Se conectó con acceso de solo lectura, o su clave de API no tiene el permiso de escritura.

La aplicación está consultando el espacio de trabajo equivocado. Pídele que llame a who_am_i para comprobarlo. Cada conexión usa un espacio de trabajo. Desconéctala y vuelve a conectarla para elegir otro.