# 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

| App | Qué necesita | Guía |
|---|---|---|
| Notion, Linear, Atlassian (Jira, Confluence), Figma, Canva, Stripe, Supabase, Cloudflare, Higgsfield y las demás apps de **Descubrir** | Su cuenta en esa app. Nada que copiar | [Iniciar sesión en una app de Descubrir](#iniciar-sesión-en-una-app-de-descubrir) |
| GitHub | Un token de acceso personal | [GitHub](#github) |
| Otra app que publica una dirección de "MCP server" | La dirección, y una clave si la app la pide | [Añadir una app por su dirección](#añadir-una-app-por-su-dirección) |
| El sistema propio de su empresa (una API) | Una dirección, una clave y notas | [La API de su empresa](/docs/es/use/api-connections.md) |
| Google Drive, Gmail, Calendar, Docs, Sheets | Su cuenta de Google | [Apps de Google](/docs/es/use/google-apps.md) |
| Slack | Nada para los miembros; un administrador lo añade una vez | [Slack](/docs/es/use/slack.md) |

## Para usted o para el equipo

| | Para usted | Para el equipo |
|---|---|---|
| Dónde | **Configuración › Conectores** | **Administración › Apps conectadas** (propietarios y administradores) |
| Qué cuenta usa la IA | La suya | La cuenta que inició sesión, o la clave que se guardó |
| Quién la usa | Solo usted, en sus propios chats | Todos, o los grupos o personas que elige el administrador |
| Quién la ve | Solo usted, no los administradores | Los 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](#plantillas-cada-miembro-usa-su-propia-clave), 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.

   ![Conectores (Connectors): todavía nada conectado, con Descubrir debajo en la misma página](../../images/mcp/connected.webp "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 en Configuración › Conectores: Conectar, ¿Lo quiere para todo el equipo? Pedir que lo añadan, lo que hace la IA y sus herramientas](../../images/connect/notion-page.webp "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**.

   ![El cuadro Añadir Notion: la dirección rellenada, Avanzado plegado y Guardar e iniciar sesión](../../images/mcp/add.webp "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.

![La página de Notion en Administración › Apps conectadas: Conectar para el equipo con una flecha para más opciones, y conectar Notion para el equipo con una clave compartida, o como plantilla que cada miembro conecta con la suya.](../../images/connect/admin-notion.webp "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](#plantillas-cada-miembro-usa-su-propia-clave) 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](https://github.com/settings/personal-access-tokens/new)
   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](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens).

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.

   ![Añadir una app para el equipo, rellenado para GitHub: la dirección https://api.githubcopilot.com/mcp/, Encabezado para la clave Authorization: Bearer (predeterminado), la Clave y, en Avanzado: para el equipo (una clave), Servidor MCP, Clave de API, Preguntar cada vez](../../images/connect/add-by-address-key.webp "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:

| Campo | Qué poner |
|---|---|
| **Nombre** | El nombre que las personas ven en los chats, como "GitHub". |
| **Dirección** | La 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](/docs/es/use/api-connections.md). |
| **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 clave** | Deje **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**. |
| **Clave** | La 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](/docs/es/use/api-connections.md#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:

| Ajuste | Qué 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 escritura** | Solo consultas; las escrituras se rechazan. |
| **Ejecutar sin preguntar** | Las 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.

   ![Añadir una app para el equipo como plantilla para GitHub: Aquí no hay clave: cada miembro añade la suya, Quién conecta en plantilla y una nota para los miembros que indica dónde crear el token](../../images/connect/template.webp "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 |
|---|---|---|
| Clave | Una, añadida por el administrador | La de cada miembro |
| Con qué permisos actúa la IA | Los del titular de la clave, para todos | Los de cada miembro |
| Qué ve el administrador | La conexión | Quié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é ve | Qué hacer |
|---|---|
| **Se requiere iniciar sesión** | El 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 motivo | La 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 app | Los 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](/docs/agents/mcp-connector.md) (en inglés).

Todos los detalles para desarrolladores: [Integrations](https://github.com/trina-app/trina-ax/blob/main/docs/INTEGRATIONS.md) (en inglés).
