Cómo crear una clave API
|Una clave API de MagicPost permite que un asistente de IA o tu propio código actúe en tu cuenta de MagicPost. Puedes crear una clave en la aplicación: abre el menú del perfil, selecciona Ajustes y, después, abre la pestaña API y MCP. Las claves API están incluidas en los planes Creator, Agency y Team, así como durante la prueba gratuita de MagicPost. El plan Growth no incluye claves API.
Puedes crear una clave API de MagicPost para llamar a la API REST de MagicPost y para los tres asistentes que la aplicación MagicPost configura con una clave: Claude Desktop, Claude Code y Perplexity. Claude Code también puede conectarse mediante un inicio de sesión de MagicPost, sin clave. No tienes que crear ninguna clave para Claude en la web, ChatGPT ni Gemini. Estos tres asistentes se conectan mediante un inicio de sesión de MagicPost, y MagicPost crea la clave por ti cuando apruebas la conexión.
Quién puede crear una clave API de MagicPost
Creator, Agency y Team. Las claves API y el servidor MCP de MagicPost forman parte de estos planes.
Prueba gratuita. Las claves API están disponibles durante toda la duración de la prueba gratuita de MagicPost. Una clave deja de funcionar cuando termina la prueba si no tienes una suscripción a uno de estos planes.
Miembros de una organización. Un miembro de una organización Agency o Team puede crear claves API de MagicPost. Hay una excepción en Agency, donde los asientos tienen tipos: un asiento Growth, Analytics o Engagement no incluye claves API. El asiento Creator, que tiene acceso completo, sí las incluye.
Growth. El plan Growth no incluye claves API, y MagicPost no muestra la pestaña API y MCP a un suscriptor de Growth.
Una suscripción a un plan antiguo de MagicPost sigue sus propias reglas: consulta Los planes Analytics y Starter. Para cambiar a un plan que incluya claves API, consulta cómo mejorar tu plan de MagicPost.
Cómo crear una clave API de MagicPost
En MagicPost, abre el menú del perfil y selecciona Ajustes.
Abre la pestaña API y MCP. El enlace directo es app.magicpost.in/settings?tab=api-keys.
Haz clic en Crear una clave. Cuando la lista de claves está vacía, el botón de la lista muestra Crear tu primera clave.
En la ventana Crear una clave API, escribe en Nombre de la clave la herramienta que estás conectando, por ejemplo, «Claude Desktop». El nombre es obligatorio.
Haz clic en Crear. La ventana Clave API creada muestra la clave.
Haz clic en Copiar, junto a la clave, y guárdala en un lugar seguro.
Haz clic en He copiado, cerrar.
Una clave API de MagicPost comienza por mp_. MagicPost muestra la clave completa una sola vez, en la ventana Clave API creada. MagicPost almacena un hash de la clave, no la clave, por lo que nadie puede volver a mostrarla más adelante. Si cierras la ventana sin copiar la clave, crea una nueva.
Qué te ofrece la ventana «Clave API creada»
Debajo de la clave, la ventana Clave API creada de MagicPost tiene una pestaña para cada asistente, con indicaciones sobre qué pegar y dónde:
Claude Desktop: un bloque de configuración con tu clave ya incluida, que debes pegar en el archivo claude_desktop_config.json.
Claude Code: un comando con tu clave ya incluida, que debes ejecutar en tu terminal. Claude Code también puede conectarse sin una clave, mediante un inicio de sesión de MagicPost: la página de Claude Code de la documentación para desarrolladores de MagicPost describe ese método.
Perplexity: la dirección del servidor MCP de MagicPost, que debes añadir como conector personalizado con autenticación mediante clave API.
Claude Web, ChatGPT y Gemini: solo la dirección del servidor MCP de MagicPost, porque estos asistentes no necesitan ninguna clave.
La configuración de cada asistente se explica en Cómo conectar MagicPost con Claude, ChatGPT, Gemini y Perplexity. Consulta qué puede hacer en MagicPost un asistente conectado en ¿Qué es MCP y qué puedo hacer con él? Para obtener una visión general del producto, consulta la página de la función LinkedIn MCP.
Cómo gestionar y revocar tus claves API de MagicPost
La lista Tus claves de la pestaña API y MCP muestra cada clave API activa de MagicPost, su nombre, sus primeros caracteres, su fecha de creación y la fecha de su último uso. La lista nunca muestra una clave completa.
Las claves API de MagicPost creadas mediante un inicio de sesión desde Claude en la web, ChatGPT o Gemini aparecen en la misma lista, con el nombre que el asistente proporcionó al conectarse.
Para revocar una clave API de MagicPost, haz clic en el icono de papelera de su fila y, después, haz clic en Revocar en la ventana ¿Revocar esta clave API?. La API de MagicPost comprueba la clave en cada solicitud, por lo que una clave revocada deja de funcionar de inmediato. La revocación es permanente: una clave revocada no se puede reactivar. Las claves revocadas permanecen visibles en una sección contraída debajo de la lista.
Una clave API de MagicPost no caduca. La clave funciona hasta que la revocas o hasta que la cuenta de MagicPost pierde el acceso a la API.
MagicPost limita el número de claves API activas en una cuenta. La aplicación MagicPost cuenta todas las claves activas de la lista Tus claves, incluidas las creadas mediante un inicio de sesión desde Claude en la web, ChatGPT o Gemini. Cuando alcanzas el límite, Crear una clave se desactiva y la pestaña API y MCP muestra el máximo. Revoca una clave o una conexión de asistente que ya no uses para crear una nueva clave.
El límite de MagicPost para las claves API activas solo bloquea Crear una clave en la aplicación. Un inicio de sesión desde Claude en la web, ChatGPT o Gemini sigue aceptándose cuando la cuenta ha alcanzado el límite, y la clave de esa conexión se añade a la lista Tus claves.
A qué da acceso una clave API de MagicPost
Una clave API de MagicPost da acceso a toda tu cuenta, no solo a una parte de ella. Con tu clave, una herramienta puede leer tus borradores y tus métricas de LinkedIn, crear y programar publicaciones, publicar en tu cuenta de LinkedIn y utilizar tus créditos de Leads. Mantén la clave en secreto y crea una clave por herramienta para poder revocar una sin detener las demás.
En una organización Agency o Team, una clave creada desde la cuenta de un administrador también permite acceder a las cuentas de los miembros: puede enumerarlas, leer sus métricas y sus publicaciones, y crear y programar publicaciones para ellos.
Una agencia no necesita una clave API de MagicPost por cliente. Una clave creada desde la cuenta de un miembro que no es administrador está limitada a la cuenta de ese miembro.
Cómo utilizar una clave API de MagicPost con la API REST
Para llamar a la API REST de MagicPost, envía la clave en el encabezado Authorization como token bearer: la palabra Bearer, un espacio y, después, tu clave. La dirección base de la API es https://api.magicpost.in/api/v1/. La referencia de la API se encuentra en la documentación para desarrolladores de MagicPost. Incluye información sobre las claves API, las métricas, las publicaciones y la programación.
Una clave API de MagicPost por sí sola no permite subir un archivo multimedia a una publicación mediante la API REST: solo el servidor MCP de MagicPost adjunta un archivo a un borrador. Una llamada REST directa sí puede editar el título y el texto alternativo de un contenido multimedia que ya esté adjunto.
La API de MagicPost limita el número de solicitudes por minuto para cada clave. Actualizar publicaciones de LinkedIn y detectar leads tiene un límite por minuto más estricto. Publicar y programar una publicación tienen su propio límite por minuto. La generación de publicaciones tiene sus propios límites por minuto, por día y por semana. Cuando superas un límite, la API de MagicPost responde con el estado HTTP 429 y la respuesta indica el límite aplicable.
La documentación para desarrolladores de MagicPost proporciona los valores en dos lugares. La página de errores y límites de frecuencia indica el límite predeterminado por minuto y el límite para actualizar publicaciones. La entrada generate_post de la página de herramientas indica los límites de generación de publicaciones.
MagicPost también limita cuántas publicaciones puede publicar un perfil de LinkedIn en 24 horas, y las publicaciones programadas también cuentan. Cuando superas ese límite, la API de MagicPost rechaza la publicación o la programación con el estado HTTP 429, y la respuesta indica el límite y la próxima franja disponible. El límite depende de la cuenta.
Preguntas frecuentes
He perdido mi clave API de MagicPost. ¿Puedo volver a verla?
No. MagicPost muestra una clave API una sola vez, cuando la creas, y solo almacena un hash de ella. Revoca la clave perdida en Ajustes, API y MCP; después, crea una clave nueva y pon la nueva en lugar de la antigua en tu herramienta.
¿Por qué no hay ninguna pestaña API y MCP en mis ajustes de MagicPost?
MagicPost oculta la pestaña API y MCP en dos casos: tienes el plan Growth o eres miembro de una organización Agency con un asiento Growth, Analytics o Engagement. Las claves API están incluidas en los planes Creator, Agency y Team. En una cuenta gratuita cuya prueba ha terminado, la pestaña es visible, pero Crear una clave abre una ventana para mejorar el plan.
¿Necesito una clave API de MagicPost por cliente o por miembro del equipo?
No. En una organización Agency o Team, una clave creada desde la cuenta de un administrador permite acceder a las cuentas de todos los miembros. Si prefieres una clave por miembro, créala desde los ajustes de la cuenta de ese miembro.
¿Una conexión desde ChatGPT, Gemini o Claude en la web crea una clave?
Sí. Cuando apruebas la conexión en la página de autorización de MagicPost, MagicPost crea una clave API con el nombre que proporcionó el asistente. MagicPost muestra esta clave en la pestaña API y MCP, y revocarla desconecta el asistente. Cuando un conector que MagicPost ya conoce vuelve a iniciar sesión, MagicPost revoca la clave que tenía ese conector y crea una nueva.
Mi clave API de MagicPost ha dejado de funcionar. ¿Por qué?
Hay dos motivos habituales. La clave se revocó en la pestaña API y MCP. O la cuenta ya no tiene acceso a la API, por ejemplo, porque terminó la prueba gratuita o porque cambiaste a un plan sin claves API. En el segundo caso, la API de MagicPost responde que el acceso a la API y a MCP no está incluido en tu plan.
¿Necesitas ayuda?
Escríbenos a través del chat de la aplicación o reserva una llamada de incorporación de 30 minutos: https://cal.com/magicpost/book-a-call