# Conecta DeepL para traducir keywords

Añade tu clave API de DeepL a AppNorth para traducir keywords al inglés y completar las traducciones que falten al localizar tus keywords para nuevos países.

Fuente: https://www.appnorth.app/es/docs/deepl (2026-11-18)

## Qué hace DeepL en AppNorth

DeepL es opcional. AppNorth usa tu propia clave API de DeepL para las keywords:

- Traducir una keyword al inglés desde el botón que aparece al pasar el cursor por su fila.
- Completar las traducciones de keywords que falten. Cuando añades países, AppNorth recurre primero a tu agente de IA, después a DeepL para lo que falte y, por último, a su propio diccionario.
- Permitir que tu agente de IA traduzca hasta 50 términos a la vez con la herramienta MCP `translate_keywords`.

> Los textos de la ficha los redacta y localiza tu [agente de IA](https://www.appnorth.app/es/docs/ai-agent), no DeepL.

## Consigue una clave API de DeepL

1. Regístrate en un plan de la API de DeepL en [deepl.com](https://www.deepl.com/pro-api). La suscripción a DeepL Translator es un producto aparte y no incluye una clave API.
2. Inicia sesión en tu cuenta de la API de DeepL, abre [Claves API y límites](https://www.deepl.com/your-account/keys) y copia una clave.

## Añádela a AppNorth

1. Abre **Ajustes → General** y busca la sección **DeepL**.
2. Pega la clave en **Clave API** y pulsa **Guardar clave**.
3. Comprueba que la fila muestra **Clave guardada en este Mac**.

> AppNorth no prueba la clave al guardarla. Si es incorrecta, las traducciones de DeepL fallan sin aviso en la app: el botón de traducción no muestra nada y la localización de keywords sigue sin DeepL. Los agentes que usan `translate_keywords` reciben «DeepL returned HTTP status 403.»

## Claves gratuitas y de pago

Funcionan tanto las claves gratuitas como las de pago de la API de DeepL. Las del plan gratuito terminan en `:fx`, así que AppNorth las envía a `api-free.deepl.com`; las demás van a `api.deepl.com`. No tienes que elegir nada.

Se aplican los límites y cargos de tu plan de DeepL, según sus condiciones.

## Cambia o elimina la clave

La clave se guarda cifrada en este Mac con una clave guardada en el Llavero y solo se envía a DeepL. Las copias de seguridad del espacio de trabajo nunca la incluyen.

Para eliminarla, pulsa **Eliminar** en la sección **DeepL**. Para cambiarla, elimínala y guarda la nueva.

## Preguntas

### ¿Necesito DeepL?

No. Sin DeepL, la localización de keywords usa tu agente de IA y el diccionario de AppNorth. Solo el botón de traducción que aparece al pasar el cursor y la herramienta MCP `translate_keywords` necesitan una clave.

### Tu agente indica «Add your DeepL key in Settings.»

Tu agente ha llamado a `translate_keywords` sin una clave de DeepL guardada. Añade una en **Ajustes → General**, en la sección **DeepL**.

### ¿Qué significa «DeepL did not return a translation for every keyword.»?

DeepL no ha traducido algunos términos. Inténtalo de nuevo o localiza los que falten con tu agente de IA.

### ¿Se envía mi clave de DeepL a AppNorth?

No. Se queda cifrada en tu Mac y solo se envía a DeepL. AppNorth no tiene ningún servidor que la reciba.
