Claves API

Para qué sirven las claves API

Las claves API sirven para conexiones de larga duración de tus propios agentes y scripts cuando no resulta práctico iniciar sesión con OAuth en un navegador. Iniciar sesión sigue siendo la forma normal de conectar una app de IA como Claude o ChatGPT. Consulta Configuración del MCP para ver cómo hacerlo.

Las claves usan la misma cuenta y conexión con Meta que la app web y requieren acceso al MCP, el CLI y la API en tu cuenta. Funcionan desde distintas redes.

Crear una clave

Abre Account > MCP, CLI & API y elige Create API Key en API Keys.
Dale un nombre a la clave para reconocer qué la usa.
Marca la casilla que confirma que la clave es para una persona y no se debe compartir. Después, créala.
Copia el secreto adk_ y guárdalo en un lugar privado. Solo se muestra una vez.

Usar una clave con el MCP

Envía Authorization: Bearer adk_... a https://adsuploader.com/api/mcp. En un cliente MCP que admita encabezados personalizados, la configuración puede ser así:

{
  "mcpServers": {
    "ads-uploader": {
      "url": "https://adsuploader.com/api/mcp",
      "headers": { "Authorization": "Bearer adk_..." }
    }
  }
}

Sustituye adk_... por tu clave y mantén la configuración privada.

Usar una clave con el CLI

Configura ADS_API_KEY en los ajustes de secretos de tu servidor o sistema de CI. Tiene prioridad sobre las credenciales guardadas en ~/.config/adsuploader/credentials.json. Para guardar una clave localmente, ejecuta:

ads login --api-key

Pega la clave en la entrada oculta o pásala por stdin. El CLI la verifica antes de guardarla. Evita poner el secreto en el comando, donde puede aparecer en el historial de la terminal.

Ejecuta ads whoami para comprobar el método de autenticación. ads config también lo muestra; de la clave solo se muestra el prefijo.

Una clave por persona

Cada cuenta puede tener una clave activa por defecto, para una persona. Contacta con soporte si necesitas más claves; los administradores pueden aumentar el límite hasta 10. Añade un puesto de equipo para otra persona. Nunca compartas una clave: Ads Uploader puede revocar una clave que use más de una persona.

Las claves no caducan

Las claves siguen siendo válidas hasta que se revocan. Las claves sin uso se revocan después de 90 días y te avisamos por correo cuando ocurre. El tiempo durante el que tu plan está en pausa no cuenta para esos 90 días.

Revocar una clave

Abre Account > MCP, CLI & API, busca la clave en API Keys y elige Revoke. Las solicitudes que usen esa clave dejarán de funcionar.

ads logout solo elimina la clave guardada de esa computadora; no la revoca. No puede desactivar ADS_API_KEY, así que elimina también esa variable de tu entorno o de los ajustes de secretos.

Las sesiones iniciadas desde el navegador aparecen por separado en MCP and CLI-Connected AI Apps. Elige Revoke allí para revocar una conexión del CLI o de una app de IA.

Documentación