Conectar apps

Notion, Linear y otras apps

Conecte Notion, Linear, Atlassian, Figma, GitHub y otras apps para que la IA pueda usarlas, para usted o para el equipo, y de dónde sacar la dirección o la clave que necesita cada una.

La IA puede usar por usted apps que están fuera de Trina AX: buscar en sus páginas de Notion, abrir una incidencia de Linear, leer un ticket de Jira. Cada app se conecta una vez. Para la mayoría no hay nada que copiar: usted inicia sesión en la propia página de la app. Algunas apps, como GitHub, le dan en cambio una clave.

Nota

Antes de la versión 0.4.0, esta pantalla se llama Servicios externos (External services). Estas conexiones usan MCP, una forma habitual de que las apps ofrezcan herramientas a una IA; no necesita saber más para usarlas.

#Cómo se conecta su app

AppQué necesitaGuía
Notion, Linear, Atlassian (Jira, Confluence), Figma, Canva, Stripe, Supabase, Cloudflare, Higgsfield y las demás apps de DescubrirSu cuenta en esa app. Nada que copiarIniciar sesión en una app de Descubrir
GitHubUn token de acceso personalGitHub
Otra app que publica una dirección de "MCP server"La dirección, y una clave si la app la pideAñadir una app por su dirección
El sistema propio de su empresa (una API)Una dirección, una clave y notasLa API de su empresa
Google Drive, Gmail, Calendar, Docs, SheetsSu cuenta de GoogleApps de Google
SlackNada para los miembros; un administrador lo añade una vezSlack

#Para usted o para el equipo

Para ustedPara el equipo
DóndeConfiguración › ConectoresAdministración › Apps conectadas (propietarios y administradores)
Qué cuenta usa la IALa suyaLa cuenta que inició sesión, o la clave que se guardó
Quién la usaSolo usted, en sus propios chatsTodos, o los grupos o personas que elige el administrador
Quién la veSolo usted, no los administradoresLos administradores

Una conexión del equipo inicia sesión una vez, como una sola cuenta: todas las personas para las que es actúan como esa cuenta en la app. Si cada persona debe actuar como ella misma (sus propias páginas de Notion, sus propios permisos de GitHub), cree en su lugar una plantilla, o deje que cada persona la conecte para sí misma.

#Iniciar sesión en una app de Descubrir

Consejo

Qué necesita

  • Una cuenta en la app (Notion, Linear …), con la sesión iniciada en su navegador.
  • Nada que copiar ni pegar: Trina AX rellena la dirección oficial de la app.
  1. Abra Conectores

    Elija su foto en la parte inferior de la barra de la izquierda y después Configuración › Conectores (en el teléfono, la pestaña Yo). Descubrir enumera las apps que puede conectar. Ver todos las muestra todas; Buscar apps encuentra una por su nombre.

    Configuración › Conectores
  2. Abra la app y elija Conectar

    La página de la app explica qué puede hacer la IA allí y enumera sus herramientas. Elija Conectar (o el + de la lista). Un miembro también ve Pedir que lo añadan, para pedirla para todo el equipo.

    La página de Notion
  3. Guardar e iniciar sesión

    El cuadro muestra la dirección oficial de la app. Deje Avanzado como está y elija Guardar e iniciar sesión.

    Añadir Notion
  4. Permita el acceso en la página de la app

    Se abre una ventana nueva en la propia página de la app (Notion, Linear …). Inicie sesión si se lo pide, elija el espacio de trabajo y elija Allow (el botón también puede llamarse Continue o Accept). La ventana se cierra y Trina AX indica Sesión iniciada. La app sube a Sus conectores con Conectado.

Para el equipo, un administrador hace lo mismo en Administración › Apps conectadas: abre la app y elige Conectar para el equipo. La flecha que hay al lado ofrece Como plantilla: cada miembro conecta. Después elige quién puede usarla.

Notion para el equipo

El inicio de sesión tiene que hacerse en un ordenador, en un navegador o en la app de escritorio. Una vez conectada, también funciona en su teléfono.

#GitHub

GitHub no deja que otras apps inicien sesión por su cuenta, así que se conecta con un token de acceso personal. Solo los propietarios y los administradores pueden añadir una app por su dirección; un miembro se lo pide a un administrador, que puede crear una plantilla para que cada persona use su propio token.

Consejo

Qué necesita

  • Dirección: https://api.githubcopilot.com/mcp/ (el servidor MCP de GitHub).
  • Clave: un token de acceso personal de GitHub, que empieza por github_pat_.
  1. Cree un token en GitHub

    Abra GitHub › Settings › Developer settings › Personal access tokens › Fine-grained tokens y elija Generate new token. Póngale un nombre ("Trina AX"), una fecha de caducidad, los repositorios que puede abrir (Only select repositories es lo más seguro) y los permisos que necesita la IA, como Contents, Issues y Pull requests en Read-only, o Read and write si la IA puede cambiarlos. Elija Generate token y cópielo: GitHub lo muestra una sola vez. Detalles: la guía de GitHub.

  2. Añádalo en Trina AX

    En Administración › Apps conectadas, elija Añadir por su dirección (debajo de Descubrir) o Añadir. Rellene:

    • Nombre: GitHub
    • Dirección: https://api.githubcopilot.com/mcp/
    • Abra Avanzado y ponga Método de inicio de sesión en Clave de API.
    • Encabezado para la clave: deje Authorization: Bearer (predeterminado).
    • Clave: pegue el token.
    GitHub con un token
  3. Guarde

    Elija Guardar. Trina AX comprueba el token con GitHub y enumera las herramientas que ofrece. La línea muestra Conectado.

#Añadir una app por su dirección

Se puede añadir cualquier app que publique una dirección de "MCP server", aunque no esté en Descubrir. Los propietarios y los administradores la añaden en Administración › Apps conectadas › Añadir por su dirección. Un miembro ve "¿No aparece? Pida a un administrador que lo añada."

Consejo

Qué necesita

  • Dirección: en las páginas de ayuda de la app, normalmente una página llamada "MCP", "MCP server" o "Connect to AI tools". Empieza por https:// y a menudo termina en /mcp.
  • Cómo inicia sesión la app: en su propia página (Iniciar sesión (OAuth)), con una clave (Clave de API) o sin inicio de sesión (Ninguno).
  • Para una clave: la Clave, de la configuración de la app ("API keys", "Tokens", "Developer"), y el Nombre del encabezado si la ayuda de la app indica uno, como X-API-Key.

Los campos del cuadro:

CampoQué poner
NombreEl nombre que las personas ven en los chats, como "GitHub".
DirecciónLa dirección MCP de la app. Empieza por https://.
Quién conecta (Avanzado)Una para el equipo, o Cada miembro la suya.
Tipo (Avanzado)Servidor MCP. Elija API solo para una API web simple: vea La API de su empresa.
Método de inicio de sesión (Avanzado)Iniciar sesión (OAuth), Clave de API o Ninguno, según diga la ayuda de la app.
Encabezado para la claveDeje Authorization: Bearer (predeterminado), salvo que la ayuda de la app indique otro encabezado. En ese caso elija Otro encabezado y escriba exactamente su Nombre del encabezado.
ClaveLa clave, pegada entera. No podrá verla de nuevo después de guardar.
Iniciar sesión con mi propia aplicación (Avanzado)Solo para apps que le piden crear su propia app de inicio de sesión, como los servidores MCP de Google. Vea Iniciar sesión con su propia app.
Escritura, eliminación y envío (Avanzado)Si la IA pregunta primero (vea abajo).
Advertencia

Ponga la clave en el campo Clave, nunca en la dirección (…?key=…). Las personas que usan una conexión del equipo pueden ver su dirección, y la IA la lee.

#Los cambios necesitan un sí

Las lecturas se ejecutan enseguida. Todo lo demás es una escritura, y sigue el ajuste Escritura, eliminación y envío de la conexión:

AjusteQué pasa
Preguntar cada vez (predeterminado)Trina AX muestra una tarjeta con todo lo que se va a enviar. No sale nada hasta que una persona dice que sí.
Bloquear escrituraSolo consultas; las escrituras se rechazan.
Ejecutar sin preguntarLas escrituras se ejecutan sin preguntar. Solo los administradores pueden elegirlo, y solo para conexiones del equipo.

Quien gestiona una conexión también puede desactivar herramientas sueltas en su página. Lo que devuelve una app se trata como datos externos, nunca como instrucciones. En una tarea programada nadie puede decir que sí, así que las escrituras se rechazan, salvo en una conexión del equipo con Ejecutar sin preguntar permitida en la tarjeta de la tarea.

#Plantillas: cada miembro usa su propia clave

Muchas apps dan a una clave los permisos de su titular y registran cada llamada a nombre de esa persona. Para esas apps, un administrador añade una plantilla: la app se registra una vez, y cada miembro la conecta con su propia clave o su propio inicio de sesión.

  1. Añada una plantilla

    En Administración › Apps conectadas, elija Añadir por su dirección (o, en la página de una app, la flecha junto a Conectar para el equipo › Como plantilla: cada miembro conecta). En Avanzado, ponga Quién conecta en Cada miembro la suya. Rellene la dirección, el método de inicio de sesión y para quién es. No hay campo de clave, y la dirección no puede tener una parte ?…: una clave ahí llegaría a todos los miembros. Use Nota para los miembros (opcional) para indicar a las personas dónde conseguir su clave.

    Una plantilla
  2. Los miembros conectan

    Los miembros para los que es reciben un aviso en Actividad y la ven en Configuración › Conectores, en Sus conectores, con una etiqueta Equipo y Conectar. Escriben su propia clave o inician sesión. Se convierte en su propia conexión, que solo se usa en sus chats.

Conexión del equipo (una clave)Plantilla
ClaveUna, añadida por el administradorLa de cada miembro
Con qué permisos actúa la IALos del titular de la clave, para todosLos de cada miembro
Qué ve el administradorLa conexiónQuién la conectó y cuándo, y qué clave dejó de funcionar; nunca una clave

En la línea de la plantilla en Administración › Apps conectadas, Plantilla · N conectados abre para quién es: Conectado, Sin conectar o La clave dejó de funcionar. Una tarea programada que necesita una plantilla no se ejecuta sin su propia clave: su resultado dice "Necesita tu propia clave para …" y enlaza con Conectar.

Un miembro solo puede cambiar su clave o su inicio de sesión y el ajuste de escritura, y puede desconectarse en cualquier momento. Si el administrador cambia la dirección o el método de inicio de sesión de una plantilla, se borra la clave de todos los miembros y vuelven a conectar; un nombre o una nota nuevos mantienen conectados a todos. Al eliminar la plantilla, o quitar a alguien de ella, se borran sus conexiones.

#Pedir a un miembro que conecte

Un administrador también puede enviar a un miembro una solicitud con la app ya rellenada: Administración › Apps conectadas › la flecha junto a Añadir › Pedir a un miembro que conecte. El miembro recibe un aviso y conecta con su propia clave, o rechaza. El administrador nunca ve la clave.

#Conectar desde un chat

También puede pedirlo en un chat: "Conecta Linear." La IA rellena la dirección oficial de la app y muestra una tarjeta. Usted solo inicia sesión o pega la clave en la tarjeta. La clave nunca llega a la IA.

#Problemas

Qué veQué hacer
Se requiere iniciar sesiónEl inicio de sesión terminó o la clave se revocó en la app. Abra la conexión y elija Volver a iniciar sesión, o Reemplazar clave.
El inicio de sesión aún no ha terminado.La ventana de inicio de sesión se cerró o está detrás de otra ventana. Elija Abrir ventana de inicio de sesión, o cancele y vuelva a intentarlo.
No se permitió el acceso en el servicio.Eligió Cancel o Deny en la página de la app. Vuelva a iniciar sesión y permítalo.
No se pudo comprobar la conexión. con "401" o "unauthorized" en el motivoLa clave es incorrecta, caducó o se copió con un espacio. Cópiela de nuevo con el botón de copiar de la app. Para un encabezado distinto de Bearer, revise el Nombre del encabezado letra por letra.
El servicio no indicó ninguna herramienta.La dirección no es una dirección MCP (a menudo se pegó la página de inicio de la app). Use la dirección de la página de ayuda MCP de la app.
Un miembro no encuentra la appLos miembros solo conectan apps desde Descubrir. Pida a un administrador que la añada por su dirección, o como plantilla.

#En la otra dirección

Su propio Claude (Claude Code, Claude Desktop o claude.ai) puede conectarse a Trina AX y usar sus archivos con sus permisos. Más información sobre el conector MCP de Team AX (en inglés).

Todos los detalles para desarrolladores: Integrations (en inglés).