snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/es/user-guide/ai/capabilities/ai-agents.mdx

@@ -0,0 +1,30 @@
+---
+title: Agentes de IA
+description: Integra capacidades de IA directamente en tus flujos de trabajo de automatización.
+---
+
+## Resumen
+
+Integra capacidades de IA directamente en tus flujos de trabajo de automatización para el procesamiento inteligente de datos y la toma de decisiones.
+
+## Capacidades
+
+| Función                      | Descripción                                                |
+| ---------------------------- | ---------------------------------------------------------- |
+| **Acciones de IA**           | Añade pasos impulsados por IA a cualquier flujo de trabajo |
+| **Enriquecimiento de Datos** | Mejora automáticamente los registros con datos externos    |
+| **Clasificación**            | Clasifica registros según el análisis de contenido         |
+| **Generación de resúmenes**  | Genera resúmenes a partir de campos de texto               |
+| **Prompts personalizados**   | Define exactamente cómo la IA procesa tus datos            |
+
+## Casos de uso
+
+* **Puntuación de clientes potenciales**: Puntúa y prioriza automáticamente los clientes potenciales entrantes
+* **Limpieza de datos**: Estandariza los nombres de empresas y la información de contacto
+* **Borradores de correo electrónico**: Genera correos de seguimiento basados en notas de reuniones
+* **Enrutamiento de registros**: Asigna los registros al miembro adecuado del equipo según el contenido
+
+## Relacionado
+
+* [Descripción general de Workflows](/l/es/user-guide/workflows/overview) — conceptos básicos de automatización
+* [Permisos de IA](/l/es/user-guide/ai/capabilities/permissions-access-control) — control de acceso para agentes de IA

packages/twenty-docs/l/es/user-guide/ai/capabilities/ai-chatbot.mdx

@@ -0,0 +1,37 @@
+---
+title: Chatbot de IA
+description: Un asistente inteligente que te ayuda a interactuar con tus datos de CRM mediante lenguaje natural.
+---
+
+## Resumen
+
+Haga preguntas en lenguaje natural y recupere el asistente y explique sus datos CRM para usted.
+
+## Capacidades
+
+| Función                           | Descripción                                                                    |
+| --------------------------------- | ------------------------------------------------------------------------------ |
+| **Consultas en lenguaje natural** | Haz preguntas en inglés sencillo en lugar de crear filtros                     |
+| **Acceso total a los datos**      | Consulta registros, relaciones y métricas en todo tu espacio de trabajo        |
+| **Contexto de la página**         | Haz referencia a "esta empresa" o "esta oportunidad" según tu vista actual     |
+| **Conversacional**                | Las preguntas de seguimiento mantienen el contexto de las consultas anteriores |
+
+## Interacciones de ejemplo
+
+### Búsqueda de registros
+
+* "Muéstrame todas las oportunidades de más de $50,000"
+* "Encuentra contactos a los que no he enviado correos en 2 semanas"
+* "Enumera las empresas del sector sanitario"
+
+### Obtención de información
+
+* "¿Cuál es el valor total de mi embudo?"
+* "¿Cuántos negocios se cerraron el mes pasado?"
+* "¿En qué etapa hay más oportunidades atascadas?"
+
+### Uso del contexto de la página
+
+* "Resume mis interacciones con esta persona" (en una página de contacto)
+* "¿Qué oportunidades están vinculadas a esta empresa?" (en una página de empresa)
+* "¿Cuándo se actualizó por última vez este negocio?" (en una página de oportunidad)

packages/twenty-docs/l/es/user-guide/ai/capabilities/mcp.mdx

@@ -0,0 +1,137 @@
+---
+title: Servidor MCP
+description: Conecta asistentes de IA a tu espacio de trabajo de Twenty mediante el Model Context Protocol.
+---
+
+Twenty expone un servidor [MCP](https://modelcontextprotocol.io/) para que los asistentes de IA — Claude Desktop, Claude Code, Cursor, ChatGPT y otros — puedan leer y escribir tus datos de CRM mediante lenguaje natural.
+
+Usa tu **URL del espacio de trabajo** (la URL que utilizas para acceder a Twenty) como el punto de acceso MCP. En Twenty Cloud, la URL de tu espacio de trabajo puede ser `https://{mycompany}.twenty.com` o un dominio personalizado. El servidor está disponible en:
+
+| Entorno             | Punto de acceso MCP                                                             |
+| ------------------- | ------------------------------------------------------------------------------- |
+| **Nube**            | `https://{your-workspace-url}/mcp` (p. ej., `https://mycompany.twenty.com/mcp`) |
+| **Autoalojamiento** | `https://{your-domain}/mcp`                                                     |
+
+## Métodos de autenticación
+
+Tienes dos formas de autenticar tu cliente MCP: **OAuth** (recomendado) o **API Key**.
+
+### Opción A — OAuth (recomendado)
+
+Con OAuth, tu cliente MCP abre una ventana del navegador para que inicies sesión. No se guardan secretos en archivos de configuración y los tokens se actualizan automáticamente.
+
+<Note>
+OAuth requiere un cliente MCP que sea compatible con la [especificación de autorización de MCP](https://modelcontextprotocol.io/specification/2025-03-26/basic/authorization). Claude Desktop, Claude Code, Cursor y ChatGPT lo admiten.
+</Note>
+
+Agrega esto a la configuración de tu cliente MCP, reemplazando `{your-workspace-url}` por el host de tu espacio de trabajo (p. ej., `mycompany.twenty.com`):
+
+```json
+{
+  "mcpServers": {
+    "twenty": {
+      "type": "streamable-http",
+      "url": "https://{your-workspace-url}/mcp"
+    }
+  }
+}
+```
+
+Eso es todo: no se necesita clave de API. Cuando el cliente se conecte por primera vez, hará lo siguiente:
+
+1. Descubrir los metadatos de OAuth de Twenty a través de `/.well-known/oauth-protected-resource` y `/.well-known/oauth-authorization-server`
+2. Registrarse como cliente OAuth mediante registro dinámico de clientes (RFC 7591)
+3. Abrir tu navegador para autorizar el acceso
+4. Recibir tokens y conectarse al servidor MCP
+
+Las conexiones posteriores reutilizan los tokens almacenados y los actualizan automáticamente.
+
+### Opción B — API Key
+
+Si tu cliente MCP no es compatible con OAuth o prefieres credenciales estáticas, pasa una clave de API en el encabezado `Authorization`:
+
+```json
+{
+  "mcpServers": {
+    "twenty": {
+      "type": "streamable-http",
+      "url": "https://{your-workspace-url}/mcp",
+      "headers": {
+        "Authorization": "Bearer YOUR_API_KEY"
+      }
+    }
+  }
+}
+```
+
+<Warning>
+Tu clave de API concede acceso a los datos del espacio de trabajo. Manténla fuera del control de versiones y de dotfiles compartidos.
+</Warning>
+
+Para crear una clave de API, ve a **Settings → MCP & APIs → API → + Create key**. Consulta [APIs](/l/es/developers/extend/api#create-an-api-key) para más detalles.
+
+## Inicio rápido
+
+### 1. Copia la configuración
+
+Ve a **Settings → MCP & APIs → MCP** en Twenty. Elige tu método de autenticación (OAuth o API Key), copia el fragmento JSON (ya usará la URL de tu espacio de trabajo) y pégalo en el archivo de configuración de tu cliente MCP.
+
+| Cliente            | Ubicación del archivo de configuración                                                                                                                              |
+| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Claude Desktop** | `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) o `%APPDATA%\Claude\claude_desktop_config.json` (Windows)                                 |
+| **Claude Code**    | `~/.claude.json` (usuario) o `.mcp.json` (proyecto)                                                                                                                 |
+| **Cursor**         | `.cursor/mcp.json` en tu proyecto, o `~/.cursor/mcp.json` de forma global                                                                                           |
+| **ChatGPT**        | Activa Developer Mode en **Settings → Apps & Connectors → Advanced settings**, luego usa **Create** en **Settings → Apps & Connectors** para añadir el servidor MCP |
+
+### 2. Conectar
+
+Reinicia tu cliente MCP (o recarga la configuración). Si usas OAuth, se te redirigirá a Twenty para autorizar el acceso. Si usas una clave de API, la conexión es inmediata.
+
+### 3. Empieza a usarlo
+
+Pídele a tu asistente de IA que interactúe con tu CRM:
+
+* *"Muéstrame las 5 empresas creadas más recientemente"*
+* *"Crea una nueva persona llamada Jane Doe en Acme Corp"*
+* *"Encuentra todas las oportunidades abiertas con un valor superior a $10k"*
+
+## Herramientas disponibles
+
+Una vez conectado, el servidor MCP expone herramientas que reflejan la API de Twenty. El flujo de trabajo recomendado es:
+
+1. **`learn_tools`** — obtener el esquema de entrada para herramientas específicas
+2. **`execute_tool`** — ejecutar una herramienta
+
+No necesitas recordar los nombres de las herramientas. Pregúntale a tu asistente de IA qué puede hacer y llamará a `learn_tools` automáticamente.
+
+## Permisos
+
+Las conexiones MCP heredan los permisos del usuario autenticado (OAuth) o del rol asignado a la clave de API. Para restringir lo que puede hacer el servidor MCP:
+
+* **OAuth**: Se aplica el rol del espacio de trabajo del usuario.
+* **API Key**: Asigna un rol a la clave de API en **Settings → Members → Roles**. Consulta [Permisos](/l/es/user-guide/permissions-access/capabilities/permissions).
+
+## Configuración autohospedada
+
+Para instancias autohospedadas, reemplaza `{your-workspace-url}` por la URL de tu servidor. Asegúrate de que `SERVER_URL` en tu entorno coincida con la URL pública de tu instancia de Twenty — se utiliza para generar los metadatos de descubrimiento de OAuth.
+
+```bash
+SERVER_URL=https://twenty.yourcompany.com
+```
+
+El punto de acceso MCP, los puntos de acceso de OAuth y los metadatos de descubrimiento se derivan de este valor.
+
+## Solución de Problemas
+
+**Errores "Unauthorized" o 401**
+
+* OAuth: vuelve a autorizar limpiando los tokens almacenados en tu cliente MCP y reconectando.
+* API Key: verifica que la clave sea válida y no haya caducado. Vuelve a generarla si es necesario.
+
+**El flujo de OAuth no abre un navegador**
+
+* Asegúrate de que tu cliente MCP sea compatible con MCP Authorization. Si no lo es, recurre al método de clave de API.
+
+**Tiempo de espera de la conexión**
+
+* Confirma que la URL del punto de acceso MCP sea accesible desde tu equipo. Para instancias autohospedadas, comprueba que el servidor esté en ejecución y que `SERVER_URL` esté configurado correctamente.

packages/twenty-docs/l/es/user-guide/ai/capabilities/permissions-access-control.mdx

@@ -0,0 +1,35 @@
+---
+title: Permisos y control de acceso
+description: Controla a qué pueden acceder y qué pueden modificar los agentes de IA en tu espacio de trabajo.
+---
+
+## Resumen
+
+Los agentes de IA respetan tu estructura de permisos existente. Esto es especialmente importante para los equipos que desean controlar exactamente a qué pueden acceder o qué pueden modificar los procesos de IA automatizados en su espacio de trabajo.
+
+## Asignar un rol a un agente de IA
+
+1. Ve a **Ajustes → Miembros → Roles**
+2. Haz clic en el rol que deseas asignar
+3. Abre la pestaña **Asignación**
+4. En **Agentes de IA**, haz clic en **+ Asignar a agente de IA**
+5. Selecciona el agente de IA de la lista
+6. Confirma la asignación
+
+## ¿Por qué asignar roles a los agentes de IA?
+
+| Beneficio         | Descripción                                                     |
+| ----------------- | --------------------------------------------------------------- |
+| **Seguridad**     | Limita a qué datos pueden acceder o modificar los agentes de IA |
+| **Cumplimiento**  | Garantiza que la IA solo procese los datos que necesita         |
+| **Control**       | Evita acciones no deseadas de las automatizaciones de IA        |
+| **Auditabilidad** | Haz un seguimiento de qué acciones realizó cada agente          |
+
+<Note>
+Para los agentes de IA que se ejecutan dentro de flujos de trabajo, la asignación de roles garantiza que el agente no pueda acceder ni modificar datos fuera de su ámbito previsto—incluso si el flujo de trabajo tiene permisos más amplios.
+</Note>
+
+## Relacionado
+
+* [Permisos](/l/es/user-guide/permissions-access/capabilities/permissions) — información detallada sobre la creación y gestión de roles
+* [Agentes de IA](/l/es/user-guide/ai/capabilities/ai-agents) — capacidades de IA en flujos de trabajo

packages/twenty-docs/l/es/user-guide/ai/how-tos/ai-faq.mdx

@@ -0,0 +1,31 @@
+---
+title: Preguntas frecuentes sobre IA
+description: Preguntas frecuentes sobre las funciones de IA en Twenty.
+---
+
+<AccordionGroup>
+
+  <Accordion title="¿Qué capacidades de IA están disponibles?">
+    Las dos capacidades principales de la IA son:
+
+    1. **Chatbot de IA**: Un asistente con conocimiento del contexto que puede acceder a tus datos de Twenty y ayudarte con consultas
+    2. **Agentes de IA en flujos de trabajo**: Automatización inteligente que puede procesar datos, tomar decisiones y ejecutar tareas dentro de tus flujos de trabajo
+  </Accordion>
+
+  <Accordion title="¿Tienen los agentes de IA acceso a todos mis datos?">
+    Los agentes de IA operan bajo el sistema de permisos. Puedes asignar roles específicos a los agentes de IA en **Configuración → Miembros → Roles**, lo que te da control total sobre a qué datos pueden acceder y qué acciones pueden realizar.
+  </Accordion>
+
+  <Accordion title="¿Cómo funcionan los créditos de IA?">
+    Las acciones de IA consumen créditos de flujos de trabajo según la complejidad de la tarea y el modelo de IA utilizado.
+  </Accordion>
+
+  <Accordion title="¿Puedo usar mis propios modelos de IA?">
+    En la nube, solo puedes usar modelos de IA proporcionados por Twenty. En tu instancia autohospedada, puedes usar tus propios modelos de IA después de obtener una licencia de Organización.
+  </Accordion>
+
+  <Accordion title="No veo un rol que asigné a un agente de IA, ¿dónde está?">
+    De forma predeterminada, la lista de roles se filtra para mostrar los roles asignables a los miembros del espacio de trabajo. Si un rol es asignable sólo a agentes de IA, usted necesita cambiar el filtro para incluir roles de agente de AI.
+  </Accordion>
+
+</AccordionGroup>

packages/twenty-docs/l/es/user-guide/ai/overview.mdx

@@ -0,0 +1,58 @@
+---
+title: IA
+description: Funciones impulsadas por IA en Twenty.
+---
+
+<Frame>
+  <img src="/images/user-guide/workflows/robot.png" alt="IA" />
+</Frame>
+
+## Funciones
+
+Actualmente, Twenty ofrece:
+
+### 1. Chatbot de IA
+
+Un asistente conversacional que entiende tu contexto y tiene acceso a todos tus datos de Twenty.
+
+**Capacidades clave:**
+
+* **Acceso completo a los datos**: Consulta cualquier registro, relación o métrica en tu espacio de trabajo
+* **Conocimiento del contexto de la página**: Haz referencia a "esta empresa" o "esta oportunidad" según dónde te encuentres en Twenty
+* **Lenguaje natural**: Haz preguntas y obtén respuestas sin navegar por menús
+
+**Ejemplos de indicaciones:**
+
+* "¿Qué oportunidades cierran este mes?"
+* "¿Qué negocios han estado en Negociación durante más de 30 días?"
+* "Resume mis interacciones con esta persona"
+
+### 2. Agentes de IA en flujos de trabajo
+
+Amplía tus flujos de trabajo con acciones impulsadas por IA y agentes autónomos.
+
+**Capacidades clave:**
+
+* **Acciones de IA**: Usa la IA para enriquecer datos, clasificar registros, generar resúmenes y más
+* **Agentes autónomos**: Permite que los agentes ejecuten tareas de varios pasos dentro de un flujo de trabajo
+* **Indicaciones personalizadas**: Define exactamente cómo la IA debe procesar tus datos
+
+**Casos de uso:**
+
+* Clasifica automáticamente los leads entrantes
+* Enriquece datos de la empresa a partir de fuentes públicas
+* Genera borradores de correos de seguimiento basados en notas de reuniones
+* Puntúa oportunidades según los patrones de interacción
+
+## Permisos y control de acceso
+
+Los agentes de IA se gestionan mediante el sistema de permisos existente:
+
+1. Ve a **Ajustes → Miembros → Roles**
+2. Configura a qué datos puede acceder cada agente de IA
+3. Establece permisos de lectura y escritura por objeto
+
+Esto garantiza que los agentes de IA respeten tus políticas de gobernanza de datos y solo accedan a lo que necesitan.
+
+* Sigue nuestro [GitHub](https://github.com/twentyhq/twenty) para actualizaciones sobre el desarrollo
+* Únete a nuestro [Discord](https://discord.gg/UfGNZJfAG6) para compartir comentarios y solicitudes de funciones