Mastheads

npx add-mcp 'https://api.mastheads.app/v1/mcp'

La mayoría de las claves solo permiten lectura. Una clave que crees con acceso completo también puede iniciar trabajo (un artículo, un lote, un informe de investigación o una auditoría de dominio) y publicar un trabajo terminado, desde tu propio código o desde un asistente de IA.

El permiso se fija en el momento de la creación

Cuando creas una clave en Configuración → Cuenta → Acceso a la API, eliges Solo lectura, que es la opción predeterminada, o Acceso completo. No hay interruptor después. Una clave de solo lectura permanece como tal durante toda su vida, y para obtener una clave de gasto creas una nueva: la base de datos otorga el permiso cuando se inserta la fila y nunca en una actualización, así que esto no es una regla que la interfaz te pida amablemente seguir.

Toda clave que existía antes de que se introdujera el acceso completo es una clave de solo lectura, y nada ha cambiado al respecto.

Actúa como la persona que la creó

Una clave de acceso completo no es una cuenta separada con su propio presupuesto. El trabajo que inicia se realiza como su propietario, a través de los mismos controles por los que pasa el panel: el límite horario de la redacción, la asignación del plan, el permiso de esa persona para gastar en la redacción, los términos aceptados y una cuenta abierta. Si no pudieran iniciarlo en el panel, la clave tampoco puede iniciarlo.

Una clave lleva el sello de la redacción en la que estaba su propietario cuando se creó. Si esa persona se muda más tarde a otra redacción, la clave se detiene en lugar de facturar a la nueva: 403 wrong_newsroom. Crea una nueva clave allí.

20 acciones de pago por hora, por clave

Además de todo lo anterior, cada clave de acceso completo puede iniciar como máximo 20 acciones de pago por hora. Un artículo, una fila de un lote, un informe y una auditoría cuentan cada uno como uno. El conteo es por clave, así que una segunda clave tiene el suyo propio, y una clave de solo lectura nunca gasta de él.

Excederse es un 429 rate_limited con Retry-After: 60, y no se inicia nada. Un lote se corta en el espacio restante en lugar de rechazarse por completo: las filas que caben se inician, y cada fila más allá del límite regresa en refused con su posición y el motivo. Las claves viven en scripts y se filtran más a menudo que los inicios de sesión, así que este límite existe para hacer que el radio de explosión de una clave filtrada sea un número en lugar de una asignación.

El archivo de toda la cuenta es separado

Un archivo que contenga todo lo que posee la cuenta es una tarea del panel, no de la API: Configuración → Cuenta → Descargar todo. Consulta Límites de velocidad y errores para saber qué responde /v1/exports.

Las cinco puertas

Las primeras cuatro responden 202 con un id e inician el trabajo en segundo plano. Publicar es la excepción y la más pesada: responde cuando la publicación está en vivo, así que no hay nada que consultar.

Endpoint	Inicia
/v1/editions/{slug}/articles	Encarga un artículo en un dominio. Responde 202 con un id de trabajo.
/v1/editions/{slug}/articles/batch	Hasta 100 artículos en un dominio en una sola llamada, con un motivo de rechazo por fila.
/v1/editions/{slug}/research	Encarga un informe de investigación en un dominio. Responde 202 con un id de informe.
/v1/editions/{slug}/audit	Rastrea un dominio que hayas verificado y audita lo que hay. Responde 202 con un id de rastreo.
/v1/editions/{slug}/articles/{article_id}/publish	Publica un artículo terminado en el sitio conectado del dominio.

Un trabajo de artículo se consulta en GET /v1/jobs/{job_id}. Un informe y una auditoría tienen cada uno su propia ruta, nombrada en sus páginas, porque ninguno es un trabajo de artículo. Esas dos rutas llevan tanto el resultado final como el progreso, y cualquier clave tuya puede leerlos: un resultado que ya has pagado es una lectura, así que no necesita acceso completo y no gasta nada.

MCP

Las mismas cuatro acciones están disponibles a través de MCP, así que Claude Code, Cursor o cualquier cliente MCP puede iniciar trabajo en tu redacción. El servidor es HTTP transmisible, y la credencial es o una clave de API que ya tienes o, para un cliente que inicia sesión con OAuth, una creada para ti cuando te conectas (abajo).

https://api.mastheads.app/v1/mcp

La dirección y un bloque de configuración para pegar están en el panel bajo Configuración → Desarrollador.

Herramienta	Qué inicia
write_article	Un artículo en un dominio, escrito con los Valores predeterminados de artículo guardados del dominio. Toma domain_id e input, y el mismo id opcional.
write_articles	Hasta 100 a la vez, cada uno con los Valores predeterminados de artículo guardados del dominio. Toma domain_id e inputs, cada fila una cadena o un objeto con input e id.
run_research	Un informe de investigación en un dominio. Toma domain_id.
run_audit	Una auditoría de todo el dominio. Toma domain_id.
publish_article	Publica un artículo terminado en el sitio conectado del dominio.

Las cinco aparecen solo para una clave de acceso completo. Conéctate con una clave de solo lectura y la lista de herramientas es solo las de lectura, así que un asistente no puede ofrecer gastar algo que nunca se le entregó. Pasan por la misma puerta que los endpoints anteriores: las mismas 20 por hora, la misma asignación, los mismos rechazos, y toman el mismo id opcional, así que un asistente que reintenta después de un tiempo de espera no encarga el trabajo dos veces. Leer un informe de investigación o una auditoría terminados está en el lado de lectura, listado para cada clave.

Conectar una aplicación

Cualquier cliente MCP puede tomar la clave directamente, como arriba. Un cliente que admita OAuth (Codex, Claude y cualquier cliente que lo admita) puede iniciar sesión en su lugar, que es el mejor camino cuando está disponible: nada que pegar, sin clave en el disco. Para Codex, un comando hace tanto la conexión como el inicio de sesión:

codex mcp add mastheads --url https://api.mastheads.app/v1/mcp

La misma dirección funciona con claude mcp add --transport http para Claude Code. Claude.ai, ChatGPT y Claude Desktop no tienen campo para una clave en absoluto; apúntalos a la misma dirección e inicia sesión con tu inicio de sesión de Mastheads en lugar de pegar nada. Consulta Autenticación para las líneas de configuración completas.

Iniciar sesión te muestra una pantalla de consentimiento con una sola opción: Permitir que esta aplicación gaste, que está desactivada a menos que la actives, y nunca está marcada de antemano. Déjala desactivada y la aplicación lee; actívala y puede iniciar trabajo y publicar, bajo las mismas 20 por hora y la misma asignación que cualquier otra clave. Como una clave, esa elección se fija en el momento en que la permites.

Las aplicaciones conectadas se listan en el panel bajo Configuración → Desarrollador, cada una con Desconectar, que hace exactamente lo que hace revocar una clave y tiene efecto en la siguiente solicitud. Se cuentan por separado de las tres claves que haces a mano.

Acceso al plan

El acceso completo está en los mismos planes que el resto de la API: Growth y Pro. No hay cargo separado por ello: el trabajo que inicia una clave se mide exactamente como el trabajo iniciado en el panel, de la misma asignación.