Tus conexiones¶

OS tiene tres tipos de conexión que creas tú mismo:

Tu propia cuenta en un servicio externo. Algunas herramientas de la AI Toolbox funcionan con tu propia cuenta en un servicio, como un sistema de tickets. Conectas esa cuenta una vez y después las herramientas la usan cuando las ejecutas.
Una aplicación de IA que conectas a un grupo de la AI Toolbox. Una aplicación de IA en tu propio ordenador, como Claude Code o Cursor, puede usar las herramientas de un grupo. Cada conexión tiene su propia clave.
Una app de IA que trabaja en OS mismo. Una app de IA como Claude Code, Claude Desktop o Cursor puede trabajar en tus organizaciones con tus permisos: buscar miembros, crear un asistente, cambiar un grupo. Inicias sesión desde la app; no hay clave.

Solo ves y gestionas tus propias conexiones. Las dos primeras están en la página Mis conexiones y puede usarlas cualquiera que pueda usar la AI Toolbox, en una organización cuyo servicio incluye la AI Toolbox. La tercera está en la página Trabajar desde una app de IA y funciona en cada organización que permite apps de IA.

Abrir Mis conexiones¶

Abre AI Toolbox y elige Mis conexiones en la barra de arriba. Después de iniciar sesión en un servicio también vuelves aquí por tu cuenta.

En Mis conexiones aparece cada servicio para el que una de tus herramientas pide un inicio de sesión propio, con Conectado o No conectado. Si dice Ninguna de sus herramientas pide un inicio de sesión propio., no tienes nada que conectar.

Elige Conectar junto al servicio.
Tu navegador va a la página de inicio de sesión del servicio. Inicia sesión y da tu permiso.
Vuelves a Mis conexiones, con el mensaje Conectado a "nombre". Si lo rechazaste, el mensaje dice que la conexión fue rechazada.

A partir de entonces, las herramientas de ese servicio funcionan con tu cuenta, cuando las ejecutas en la caja de herramientas y cuando un asistente las usa por ti. Mientras no estés conectado, una herramienta así dice en la caja de herramientas que primero debes conectar tu propia cuenta. Un asistente puede darte entonces un enlace para iniciar sesión; después ves aquí si ha funcionado.

Desconectar. Elige Desconectar y confirma. OS olvida tu inicio de sesión; no se avisa al servicio. Si también quieres retirar el acceso allí, hazlo en el servicio.

Si un servicio vuelve a mostrar No conectado aunque te habías conectado, tu inicio de sesión en el servicio ha caducado o se ha revocado. Elige Conectar de nuevo.

Conectar una aplicación de IA a un grupo¶

Una aplicación de IA se conecta a un solo grupo de la AI Toolbox. La aplicación recibe las herramientas de ese grupo que puedes usar en ese momento. Una herramienta que se añade más tarde al grupo solo llega a la aplicación con una conexión nueva.

Abre el grupo en la AI Toolbox y elige Conectar una aplicación de IA en la barra de arriba.
Escribe un Nombre con el que reconozcas la conexión, por ejemplo Portátil, Claude Code.
Elige Válida hasta: por defecto dentro de 30 días, como máximo 90 días. Después la conexión deja de funcionar y creas una nueva.
Elige Crear la clave.

La pantalla muestra entonces, solo ahora:

la Dirección de la conexión;
la Clave. Guárdala como una contraseña: quien la tenga usa las herramientas del grupo como si fuera tú. OS no la vuelve a mostrar nunca;
un comando para Claude Code y un bloque para Cursor, con la dirección y la clave ya puestas.

En No incluido en esta conexión, la pantalla nombra cada herramienta del grupo que la aplicación no recibe, y por qué. Una aplicación de IA no puede usar una herramienta que funciona con tu propia cuenta en un servicio, ni una herramienta que necesita más que ella misma, como conocimiento o un modelo. Un almacén de datos compartido contigo, la aplicación solo puede leerlo.

Si dice Este grupo aún no está vinculado a ningún conjunto de herramientas, el grupo todavía no se puede conectar a una aplicación de IA. Pide a un administrador que vincule primero el grupo a un conjunto de herramientas.

Claude Code¶

Copia el comando de Claude Code y ejecútalo en un terminal. Tiene este aspecto, con la dirección y la clave de tu conexión:

claude mcp add --transport http atencion-cliente \
    https://<direccion>/api/v1/mcp/toolsets/atencion-cliente \
    --header "Authorization: Bearer ack_..."

Después, claude mcp list muestra la conexión, y Claude Code puede usar las herramientas del grupo.

Cursor¶

Copia el bloque de Cursor en el archivo MCP de Cursor (.cursor/mcp.json en tu proyecto, o ~/.cursor/mcp.json para todos tus proyectos). Si ya contiene servidores, añade solo la entrada de esta conexión a mcpServers:

{
  "mcpServers": {
    "atencion-cliente": {
      "url": "https://<direccion>/api/v1/mcp/toolsets/atencion-cliente",
      "headers": { "Authorization": "Bearer ack_..." }
    }
  }
}

Claude Desktop¶

Claude Desktop no puede usar una conexión a un grupo: sus conectores personalizados inician sesión con OAuth y no tienen campo para la clave. Con Claude Desktop sí trabajas en OS mismo.

Un nuevo secreto, o terminar la conexión¶

En Aplicaciones de IA, en Mis conexiones, aparece cada aplicación de IA que conectaste a un grupo, con el grupo, el comienzo de la clave y cuándo caduca la conexión.

Nuevo secreto. Si perdiste la clave, o puede que alguien más la haya visto, elige Nuevo secreto. La clave antigua deja de funcionar enseguida; la nueva se muestra una vez, y la conexión caduca el mismo día que antes. Pon la nueva clave en tu aplicación de IA.
Terminar. Elige Terminar y confirma. La aplicación de IA ya no podrá usar las herramientas del grupo.

Quien configura la AI Toolbox de tu organización también puede terminar tus conexiones.

Cuando ya no puedes usar la caja de herramientas¶

OS termina por sí solo tus conexiones a grupos cuando ya no puedes usar la AI Toolbox: cuando tu membresía se desactiva o se elimina, cuando pierdes el derecho a la AI Toolbox, o cuando el servicio de la organización ya no incluye la AI Toolbox. Si te quitan de la organización, OS olvida también los inicios de sesión de tus propias cuentas en servicios externos.

Usar OS desde una app de IA¶

Una app de IA también puede trabajar en OS mismo, con tus permisos: buscar miembros, crear un asistente, cambiar un grupo. Conectas la app una vez y después trabaja en cada organización de la que eres miembro y que permite apps de IA. Lo que tú no puedes hacer, tampoco lo puede hacer la app.

Abre la página Trabajar desde una app de IA en el menú bajo tu nombre, o con el botón Trabajar desde una app de IA en Mis conexiones. Los dos aparecen en cuanto una de tus organizaciones permite apps de IA.

En Dónde se puede ves, por organización, lo que eligió un administrador:

Ajuste	Lo que la app puede hacer allí
Desactivado	Nada. Así empieza cada organización.
Solo lectura	Ver lo que tú puedes ver, pero no cambiar nada.
Leer y cambiar	Todo lo que tú puedes hacer, también invitar, cambiar y eliminar.

Si todas las organizaciones están en Desactivado, la página dice que ninguna de tus organizaciones permite apps de IA. Un administrador de tu organización puede activarlo (Configuración de la organización).

Conectar la app¶

En Conectar una app de IA, copia la Dirección. Si la app solo tiene que hacer una cosa, elige antes un Área, como Miembros, Grupos, Asistentes de IA o Ajustes: con menos herramientas, la app elige mejor.
Elige la pestaña de tu app y sigue lo que indica:
- Claude Code: ejecuta el comando en un terminal, abre Claude Code y escribe /mcp.
- Claude Desktop: en Claude, abre Configuración › Conectores, elige Añadir conector personalizado, escribe Artific OS como nombre y la dirección como URL, y elige Conectar.
- Cursor: pon el bloque en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json para todos tus proyectos.
- Otra app: cualquier app que admita MCP sobre HTTP con inicio de sesión (OAuth) puede conectarse con la dirección. Una app que solo puede enviar una clave fija en una cabecera no puede conectarse.
La app abre tu navegador. Inicia sesión en OS como siempre y elige Dar acceso. El nombre de la app en esa página lo da la propia app: da acceso solo si acabas de abrir la app tú mismo.

Para Claude Code, el comando tiene este aspecto:

claude mcp add --transport http artific-os https://<direccion>/api/v1/mcp

Lo que la app cambia aparece en el registro de auditoría de la organización con tu nombre y el de la app. El proveedor de la app, como Anthropic o Cursor, ve lo que la app lee, igual que lo que tú pegas en ella.

Desconectar una app¶

En Apps conectadas aparece cada app que ha trabajado en tus organizaciones con tu cuenta, después de su primera llamada: cuándo la usaste por primera y última vez y en qué organizaciones. Elige Desconectar y confirma. La app ya no podrá hacer nada en tus organizaciones, desde ahora. Para volver a usarla, inicia sesión de nuevo desde la app.

Un administrador también puede desconectar una app tuya, pero solo en la organización que gestiona; en tus otras organizaciones la app sigue funcionando.

Por la API¶

Tus propios inicios de sesión: GET /api/v1/organisations/{id}/toolbox/connections los muestra, y POST, GET y DELETE …/toolbox/mcp-servers/{nombre}/authorization empiezan, leen y olvidan uno. Tus aplicaciones de IA conectadas a un grupo: POST …/toolbox/mcp-connections con group, label y expires_at crea una conexión y devuelve la clave una vez; GET …/toolbox/mcp-connections las muestra, POST …/mcp-connections/{id}/rotate crea un nuevo secreto y DELETE …/mcp-connections/{id} termina una. Las apps de IA que trabajan en OS: GET /api/v1/me/mcp-clients las muestra y DELETE /api/v1/me/mcp-clients/{client_id} desconecta una.