Integraciones

Conectar apps de IA

Puedes conectar tú mismo a VentionDesk Claude, ChatGPT, Cursor, Codex o cualquier otro cliente de IA que hable MCP — sin clave de API. La app inicia sesión a través de tu cuenta de VentionDesk y, al conectarla, decides qué puede hacer. Esto funciona para propietarios y miembros del equipo; las cuentas de clientes del portal de clientes no pueden conectar una app de IA.

La página para usuarios internacionales y directorios de apps, con la lista de todas las herramientas y ejemplos de prompts: Connect AI apps to VentionDesk.

Cómo funciona una conexión

Introducir la URL. En la app de IA, añade un servidor MCP (a menudo llamado «conector» o «integración») con esta URL: https://api.ventiondesk.com/mcp. La app no necesita nada más — encuentra sola el camino al inicio de sesión.
Iniciar sesión. La app abre una ventana del navegador con el inicio de sesión de VentionDesk. Si ya has iniciado sesión, continúa directamente.
Dar el consentimiento. VentionDesk muestra una página de consentimiento con el nombre de la app (en /oauth/zustimmen). Allí eliges:
- el espacio de trabajo, si perteneces a más de uno,
- los permisos — como miembro del equipo, solo los que el propietario ha liberado para apps de IA,
- los proyectos — todos (también los futuros) o una selección.
Conectada. Tras tu consentimiento vuelves a la app. A partir de ahora trabaja exactamente con esos permisos — no con los tuyos. Si lo rechazas, la conexión se interrumpe sin guardar nada.

La app recibe las mismas herramientas que una clave de agente (consulta Claude y MCP); lo que puede hacer una herramienta lo determinan los permisos elegidos. Lo que lee la app va a su proveedor — por ejemplo Anthropic, OpenAI o Anysphere. Si tu espacio de trabajo puede hacerlo es una decisión suya; para tickets, datos de clientes y tiempos con nombres, normalmente necesitas un contrato de encargo del tratamiento con el proveedor.

Claude

claude.ai y Claude Desktop: En Settings › Connectors, añade un conector personalizado con «VentionDesk» como nombre y https://api.ventiondesk.com/mcp como URL. Después, «Connect» — el inicio de sesión y el consentimiento siguen como arriba. Si los conectores personalizados están habilitados en tu plan y tu organización lo deciden Anthropic o el administrador de tu Claude.

Claude Code: en el terminal

claude mcp add --transport http ventiondesk https://api.ventiondesk.com/mcp

y después ejecuta /mcp en Claude Code e inicia sesión en «ventiondesk». Si prefieres trabajar con una clave fija, sigue Claude y MCP.

Trabajar tareas como con /aufgaben — también en la app sin sistema de archivos: «Work on the next open VentionDesk task». Claude toma la siguiente tarea con la misma regla que el runner de tareas, lee la descripción, el historial y el proyecto, obtiene capturas solo cuando hacen falta, comunica el resultado con justificante y cierra la ejecución. Para ello, la conexión necesita los permisos de la plantilla «Runner de Claude» (leer y comunicar tareas, gestionar ejecuciones, leer proyectos).

ChatGPT

En los ajustes, en Connectors (según la versión, «Apps & Connectors»; los servidores MCP propios requieren el modo de desarrollador), crea un conector nuevo: URL https://api.ventiondesk.com/mcp, autenticación OAuth. El inicio de sesión y el consentimiento llegan con el primer uso. Qué planes permiten conectores propios lo decide OpenAI.

Cursor

En ~/.cursor/mcp.json (para todos los proyectos) o .cursor/mcp.json (solo este proyecto):

{
  "mcpServers": {
    "ventiondesk": {
      "url": "https://api.ventiondesk.com/mcp"
    }
  }
}

Cursor muestra entonces el servidor en Settings › MCP con un aviso de inicio de sesión; un clic en él inicia el inicio de sesión y el consentimiento.

Codex

En ~/.codex/config.toml:

[mcp_servers.ventiondesk]
url = "https://api.ventiondesk.com/mcp"

Después, codex mcp login ventiondesk — el navegador abre el inicio de sesión y el consentimiento. Las versiones antiguas de Codex solo hablan MCP por HTTP con un interruptor adicional; en caso de duda, consulta la ayuda de tu versión de Codex.

Otros clientes

Todo cliente que admita MCP por HTTP («Streamable HTTP») con OAuth encuentra el camino por sí mismo: a una solicitud sin inicio de sesión, https://api.ventiondesk.com/mcp responde con 401 y remite a https://api.ventiondesk.com/.well-known/oauth-protected-resource; allí figura el servicio de inicio de sesión de VentionDesk. El cliente se registra allí — no tienes que crear nada antes.

Los scopes de OAuth que pide un cliente (openid, email, profile) solo afectan al inicio de sesión. Lo que la app puede hacer en VentionDesk se elige en la página de consentimiento.

Desconectar y caducidad

En Ajustes › Mis apps de IA ves tus conexiones en todos los espacios de trabajo: app, permisos, proyectos, fecha de conexión y último uso. «Desconectar» termina una conexión al momento — un inicio de sesión ya emitido a la app tampoco vale después. Para tu propia conexión, VentionDesk retira además la autorización en el inicio de sesión; si vuelves a conectar la app, VentionDesk te lo vuelve a preguntar.

Una conexión que no se ha usado durante 90 días termina sola. Vuelve a conectar la app cuando la necesites.

Como propietario ves allí también las conexiones de todas las personas de tu espacio de trabajo y puedes desconectar cualquiera. Además decides qué permisos pueden dar los miembros del equipo a una app de IA. De forma predeterminada son los permisos de las plantillas «Solo lectura» y «Runner de Claude» — leer proyectos, tareas y despliegues, informar sobre tareas y registrar ejecuciones —, nada sensible. Tú mismo puedes conceder todos los permisos excepto el registro de accesos, que solo puede conceder el operador. Si restringes la liberación, se aplica a las conexiones existentes a partir del siguiente token de la app — normalmente en menos de una hora.

Cada conexión y cada desconexión aparecen en el registro de tu espacio de trabajo; los cambios que hace una app aparecen allí en la medida en que VentionDesk los registra — cada uno con la app y la persona, por ejemplo «App de IA: Claude · Anna Schmidt».

¿App de IA o clave de API?

	Conectar una app de IA	Clave de agente
Quién la configura	cada persona para sí misma	el propietario
Inicio de sesión	a través de tu cuenta, sin secreto que copiar	clave `vd_live_…`, mostrada una vez
Permisos	elegidos al dar el consentimiento	elegidos al crearla, se pueden cambiar después
Fin	desconectar o 90 días sin uso	revocar o fecha de caducidad
Adecuada para	apps de chat y editores de personas concretas	el runner de tareas y tus propios scripts