Conectar Claude, ChatGPT, Codex o Cursor a Clevera

Puedes permitir que aplicaciones de IA como Claude, ChatGPT, Claude Code, Codex y Cursor trabajen en tu espacio de trabajo de Clevera a través del servidor MCP de Clevera. Las aplicaciones de chat se conectan mediante un inicio de sesión (un conector, no se necesita token); los agentes de codificación y los scripts se conectan con un token de API.

Antes de empezar#

• Agentes de IA y API, incluidos los conectores para Claude y ChatGPT, están disponibles en los planes Pro, Business y Custom. En otros planes, el conector muestra "Los conectores de Claude.ai y ChatGPT están disponibles en el plan Pro y superiores."
• Un agente actúa como tú, dentro de lo que permite tu rol. Consulta Permisos del agente.

Elige cómo conectarte#

La dirección del servidor MCP es la misma para todas las aplicaciones:

https://app.clevera.ai/mcp

Conectar Claude o ChatGPT#

1. Copia la URL del conector#

   Abre el menú del espacio de trabajo y elige AI agents & API, luego abre la pestaña Aplicaciones conectadas. Copia la URL del conector bajo Conectar Claude o ChatGPT: "No se necesita token: añade Clevera como un conector personalizado e inicia sesión."

   

2. Añade un conector personalizado en la aplicación#

   En Claude o ChatGPT, abre la configuración de conectores y añade un conector personalizado. Pega la URL.

3. Inicia sesión y elige el acceso#

   La aplicación te envía a la pantalla Conectar app a Clevera. Inicia sesión si no lo has hecho, luego elige:

   • Espacio de trabajo: el espacio de trabajo en el que trabaja la aplicación.
   • Sitios: Todos los sitios ("Todos los sitios actuales y futuros de este espacio de trabajo.") o Sitios elegidos, cuando el acceso incluye sitios de documentos.
   • Acceso: permisos preestablecidos o Personalizado. Los permisos que tu rol no permite muestran No disponible para tu rol. Consulta Permisos del agente.
   • La conexión dura: 30 o 90 días. El valor predeterminado es 90 días.

4. Permitir acceso#

   Haz clic en Permitir acceso. Volverás a la aplicación, que ahora puede usar las herramientas de Clevera. "Puedes desconectarla en cualquier momento en Integraciones → AI agents & API." Haz clic en Denegar para no enviar nada.

La pantalla de conexión muestra a quién estás conectando:

• Aplicación verificada · te devuelve a dirección: una aplicación conocida (Claude, ChatGPT o Cursor), reconocida por la dirección a la que devuelve.
• Te devuelve a dirección: cualquier otra aplicación. Comprueba la dirección antes de permitir el acceso.

El propietario del espacio de trabajo y los administradores reciben una notificación, "app se conectó a workspace", con el acceso que elegiste.

Qué puede y qué no puede hacer una aplicación conectada#

• Actúa como tú, dentro de tu rol, con el acceso que elegiste. Solo ve las grabaciones, videos y colecciones que tú puedes ver.
• Funciona solo a través de MCP. Su inicio de sesión no se puede usar en la API REST: "Los tokens de conector OAuth funcionan solo en el servidor MCP. Usa un token estático para la API REST."
• No tiene límites de gasto propios, por lo que cada inicio de pago desde una aplicación conectada espera a que una persona lo apruebe en Solicitudes del agente. Consulta Controlar el gasto y las aprobaciones de los agentes.
• Cada persona puede tener hasta 20 aplicaciones conectadas.
• La conexión finaliza cuando su vida útil (30 o 90 días) se agota; entonces debes conectar la aplicación de nuevo. Una aplicación que no usa Clevera durante 30 días también debe iniciar sesión de nuevo.

Conectar Claude Code, Codex u otro agente con un token#

Crea un token de API primero. Cuando se crea, Conectar un agente muestra la configuración lista para usar con la dirección del servidor de tu espacio de trabajo. Cada fragmento lee el token de la variable de entorno CLEVERA_TOKEN, por lo que el token en sí nunca entra en un archivo: "Establece CLEVERA_TOKEN como el token en tu shell o en el almacén de secretos del agente."

claude mcp add --transport http clevera https://app.clevera.ai/mcp --header "Authorization: Bearer $CLEVERA_TOKEN"

codex mcp add clevera --url https://app.clevera.ai/mcp --bearer-token-env-var CLEVERA_TOKEN

[mcp_servers.clevera]
url = "https://app.clevera.ai/mcp"
bearer_token_env_var = "CLEVERA_TOKEN"

{
  "mcpServers": {
    "clevera": {
      "type": "http",
      "url": "https://app.clevera.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${CLEVERA_TOKEN}"
      }
    }
  }
}

curl -H "Authorization: Bearer $CLEVERA_TOKEN" https://app.clevera.ai/api/v1/docs/me

Cursor y otros clientes MCP que leen un archivo mcpServers toman la misma entrada de servidor que .mcp.json.

Comprueba que funciona#

Pregúntale al agente qué puede hacer en Clevera, o que enumere tus grabaciones. El agente solo ve las herramientas que sus permisos permiten, por lo que una lista corta generalmente significa un token limitado. Todo lo que hace se muestra en la pestaña Actividad.

Desconectar una aplicación#

En la pestaña Aplicaciones conectadas, haz clic en el botón de desconectar al final de la fila de la aplicación y confirma con Desconectar ("¿Desconectar app?"). "La aplicación pierde el acceso inmediatamente. Conectarla de nuevo requiere un nuevo inicio de sesión." La fila permanece listada (atenuada) durante 30 días.

El propietario del espacio de trabajo y los administradores ven cada aplicación conectada en el espacio de trabajo ("Aplicaciones que las personas de este espacio de trabajo conectaron.") y pueden desconectar cualquiera de ellas. Todos los demás ven y desconectan las suyas ("Aplicaciones que conectaste.").

Solución de problemas#

Más mensajes: Solucionar errores de agente y API.

Relacionado#