Servidor MCP de Diga para asistentes de IA

Usa el servidor Model Context Protocol (MCP) alojado por Diga para crear y gestionar agentes de voz desde asistentes de IA y herramientas de desarrollo compatibles.

Esta página explica cómo conectar un asistente a Diga. Para que un agente de voz de Diga acceda a un servidor MCP externo durante una llamada, consulta Integraciones MCP.

Requisitos previos

Antes de comenzar, necesitas:

Una cuenta de Diga que pertenezca al menos a un proyecto
Un cliente MCP compatible con servidores remotos mediante Streamable HTTP
Solo si usas una API key en lugar de iniciar sesión: una API key de Diga del proyecto que quieres gestionar. Sigue los pasos para crear una API key y crea una clave restringida con solo los permisos que necesite tu asistente.

Qué puedes hacer

El servidor MCP de Diga convierte las operaciones de la API de Diga en herramientas que tu asistente puede descubrir y utilizar. Según tus permisos, puedes usar lenguaje natural para:

Crear, actualizar, publicar, listar y consultar agentes de voz y sus versiones
Crear llamadas y consultar sus detalles, mensajes, grabaciones, logs y trazas
Crear y mantener bases de conocimiento a partir de texto, URLs y archivos
Gestionar números de teléfono, voces, integraciones, webhooks y flujos
Consultar miembros, uso, facturación y otros recursos del proyecto

Tu cliente MCP muestra las herramientas exactas disponibles, incluida la descripción y los parámetros requeridos de cada una.

Elige cómo autenticarte

Tu cliente MCP se conecta a Diga mediante Streamable HTTP. Elige una de estas dos formas de autenticarte:

	Iniciar sesión con Diga (OAuth)	API key
Configuración	Añade solo la URL del servidor. Tu cliente abre una ventana del navegador donde inicias sesión en Diga.	Añade la URL del servidor y un header `x-api-key`.
Permisos	Tu rol en el proyecto	Las restricciones de la clave
Proyecto	Cualquier proyecto al que pertenezcas. Elige uno después de conectar y cámbialo cuando quieras.	Fijo al proyecto donde se creó la clave
Ideal para	Personas que usan un asistente de forma interactiva	Scripts, entornos compartidos y clientes sin soporte de OAuth

Ajuste	Valor
Nombre del servidor	`diga`
URL del servidor	`https://mcp.diga.io/mcp`
Header de API key (solo con API key)	`x-api-key: <DIGA_API_KEY>`

Al iniciar sesión con Diga: tu cuenta puede pertenecer a varios proyectos, así que el servidor necesita saber en cuál trabajar. La primera vez que pides algo, el asistente lista tus proyectos y te pide que elijas uno. También puede llamar directamente a la herramienta diga_select_project. La elección se recuerda durante 24 horas y puedes cambiar de proyecto en cualquier momento pidiéndoselo al asistente.Al usar una API key: la clave pertenece al proyecto donde la creaste, así que no hace falta elegir. Para gestionar otro proyecto, sustituye la clave por una de ese proyecto.

Conecta tu cliente MCP

Elige tu cliente. Si usas API key, sustituye <DIGA_API_KEY> por tu API key completa de Diga.

Claude (web y escritorio)
Claude Code
Cursor
Codex
Otros clientes

Abre Settings → Connectors → Add custom connector, ponle el nombre Diga e introduce https://mcp.diga.io/mcp como URL. Al activar el conector, Claude abre una ventana del navegador para iniciar sesión en Diga.Para usar una API key, abre Request headers en los ajustes del conector y añade x-api-key con tu clave como valor. Si tu versión de Claude no muestra esa opción, usa el puente mcp-remote en Claude Desktop (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "diga": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.diga.io/mcp", "--header", "x-api-key:<DIGA_API_KEY>"]
    }
  }
}

Inicia sesión con Diga:

claude mcp add --transport http diga https://mcp.diga.io/mcp

Después ejecuta /mcp dentro de Claude Code y elige diga para completar el inicio de sesión en el navegador.Para usar una API key:

claude mcp add --transport http diga \
  --header "x-api-key: <DIGA_API_KEY>" \
  https://mcp.diga.io/mcp

Abre Cursor Settings → MCP → Add new global MCP server. Para iniciar sesión con Diga, añade solo la URL y completa el inicio de sesión cuando Cursor abra tu navegador:

{
  "mcpServers": {
    "diga": {
      "url": "https://mcp.diga.io/mcp"
    }
  }
}

Para usar una API key, añade el header:

{
  "mcpServers": {
    "diga": {
      "url": "https://mcp.diga.io/mcp",
      "headers": {
        "x-api-key": "<DIGA_API_KEY>"
      }
    }
  }
}

Añade el servidor a ~/.codex/config.toml:

[mcp_servers.diga]
url = "https://mcp.diga.io/mcp"

Para iniciar sesión con Diga, ejecuta codex mcp login diga y completa el inicio de sesión en el navegador.Para usar una API key, añade bearer_token_env_var = "DIGA_API_KEY" al bloque anterior y define la variable antes de iniciar Codex:

export DIGA_API_KEY="<DIGA_API_KEY>"

Codex envía este valor como Authorization: Bearer <DIGA_API_KEY>, un formato que también acepta el servidor MCP de Diga.

Configura un servidor remoto Streamable HTTP con la URL https://mcp.diga.io/mcp. Los clientes compatibles con OAuth descubren automáticamente el inicio de sesión de Diga y abren una ventana del navegador. Para acceder con API key, añade el header:

{
  "name": "diga",
  "url": "https://mcp.diga.io/mcp",
  "headers": {
    "x-api-key": "<DIGA_API_KEY>"
  }
}

Nunca incluyas una API key en la URL del servidor ni la subas al control de versiones. Las URLs pueden aparecer en el historial, los logs del proxy y las analíticas. Usa variables de entorno cuando tu cliente MCP lo permita.

Verifica la conexión

Después de guardar la configuración, reinicia o recarga tu cliente MCP. Comprueba que aparece un servidor llamado diga y que sus herramientas están disponibles. Empieza con una solicitud de solo lectura, por ejemplo:

Lista mis agentes de Diga.

Si iniciaste sesión con Diga y perteneces a más de un proyecto, el asistente te preguntará primero qué proyecto usar. Tu cliente debería pedir confirmación antes de ejecutar una herramienta si sus ajustes de permisos así lo requieren.

Solución de problemas

El asistente me pide que seleccione un proyecto

Iniciaste sesión con Diga y todavía no has elegido un proyecto, o la elección caducó pasadas 24 horas. Dile al asistente qué proyecto usar o pídele que liste tus proyectos primero.

La conexión falla porque se requiere la autenticación en dos pasos

Tu cuenta de Diga tiene activada la autenticación en dos pasos. La pantalla de autorización te pide el código al iniciar sesión. Si la conexión se aprobó sin él, desconecta y vuelve a conectar el servidor de Diga en tu cliente MCP e introduce el código cuando te lo pida. Como alternativa, conéctate con una API key.

El inicio de sesión en el navegador nunca se abre

Tu cliente MCP no admite OAuth para servidores remotos. Conéctate con una API key de proyecto.

El servidor devuelve 401 Unauthorized

Si iniciaste sesión con Diga, puede que tu sesión haya caducado. Desconecta y vuelve a conectar el servidor para iniciar sesión de nuevo. Si usas una API key, confirma que has copiado la clave completa y que el cliente la envía como x-api-key sin el prefijo Bearer. Si usas el header Authorization, su valor debe ser Bearer <DIGA_API_KEY>.

Una herramienta devuelve 403 Forbidden

Estás autenticado, pero no tienes permiso para usar ese recurso. Si iniciaste sesión con Diga, pide a un administrador del proyecto que actualice tu rol. Si usas una API key, actualiza las restricciones de la clave en Ajustes → Proyecto → API Keys o usa otra clave restringida con el permiso necesario.

El asistente muestra una empresa incorrecta o ningún recurso

Si iniciaste sesión con Diga, pide al asistente que cambie al proyecto correcto. Si usas una API key, la clave determina el proyecto. Sustitúyela por una clave creada en el proyecto de Diga correcto y reinicia el cliente MCP para que vuelva a cargar la configuración.

El cliente no puede conectarse al servidor

Verifica que la URL sea exactamente https://mcp.diga.io/mcp y que el cliente admita servidores MCP remotos mediante Streamable HTTP. Algunos clientes necesitan reiniciarse después de cambiar la configuración.

Recomendaciones de seguridad

Prefiere iniciar sesión con Diga para el uso interactivo. El acceso sigue tu rol y termina al desconectar.
Si usas API keys, crea una clave diferente para cada cliente MCP y entorno
Concede solo los permisos de lectura o escritura que necesite el asistente
Revisa las llamadas a herramientas antes de aprobar acciones que modifiquen o eliminen recursos
Rota una clave inmediatamente si queda expuesta

​Requisitos previos

​Qué puedes hacer

​Elige cómo autenticarte

​Conecta tu cliente MCP

​Verifica la conexión

​Solución de problemas

​Recomendaciones de seguridad

Requisitos previos

Qué puedes hacer

Elige cómo autenticarte

Conecta tu cliente MCP

Verifica la conexión

Solución de problemas

Recomendaciones de seguridad