Tu blog, manejado por un agente de IA
Blogelia tiene un servidor MCP remoto y una API REST con clave. Un agente como Claude Code, Codex, Claude Desktop, Cursor o ChatGPT puede crear tu blog, leerlo, escribir y corregir artículos, generar nuevos con IA, programarlos y publicarlos, siempre con los permisos que tú le des y con los límites de tu plan.
Qué puede hacer un agente con tu blog
El servidor MCP de Blogelia publica 28 herramientas. Cada conexión o clave de API lleva los permisos que apruebas y el agente solo ve las herramientas que esos permisos habilitan: una clave de lectura no puede publicar ni gastar créditos.
| Herramienta | Qué hace | Permiso |
|---|---|---|
get_account | Ver el plan, los permisos de la conexión y lo que queda de cada límite. | cualquier clave |
list_categories | Ver las categorías de negocio para crear un blog. | blogs:create |
analyze_site | Analizar la web de tu empresa para preparar el blog. | blogs:create |
get_site_analysis | Seguir el análisis y ver el perfil, el público y los temas propuestos. | blogs:create |
create_blog | Crear el blog a partir del análisis, con su nombre y su dirección. | blogs:create |
list_blogs | Listar tus blogs con su nombre, dirección y número de artículos. | content:read |
get_blog | Ver la ficha de un blog: perfil, voz de marca e ideas de temas. | content:read |
list_articles | Listar artículos y filtrarlos por estado, fecha o texto. | content:read |
get_article | Leer un artículo completo en JSON, HTML o Markdown. | content:read |
get_stats | Consultar visitas por día, blog o artículo. | stats:read |
update_blog | Cambiar el nombre, la descripción, la voz de marca o los datos del negocio. | content:write |
update_article | Corregir el título, el contenido en Markdown, la meta descripción o las preguntas frecuentes. | content:write |
delete_article | Borrar un borrador. Exige confirmación expresa. | content:write |
remove_topic_idea | Quitar una idea de la lista de temas del blog. | content:write |
estimate_article | Saber cuántos créditos costaría un artículo antes de pedirlo. | generate |
generate_article | Generar un artículo con IA a partir de un tema, una palabra clave o un brief. | generate |
get_generation | Seguir el estado de una generación en curso. | generate |
list_generations | Ver las generaciones recientes de un blog y cómo acabaron. | generate |
propose_topics | Pedir temas nuevos para el blog, sin repetir lo ya escrito. | generate |
get_autopilot | Ver la configuración del piloto automático y los próximos huecos. | generate |
update_autopilot | Activar el piloto automático y elegir días, hora y modo de revisión. | generate |
schedule_article | Programar la publicación en una fecha, o quitar la programación. | publish |
publish_article | Publicar un artículo (o aprobar uno pendiente de revisión). | publish |
reject_article | Descartar un artículo pendiente de aprobación. | publish |
unpublish_article | Retirar un artículo publicado. Exige confirmación expresa. | publish |
list_api_keys | Ver tus claves de API y conexiones, sin el secreto. | keys:manage |
create_api_key | Crear una clave pk_live_ o pk_test_, si quieres solo para un blog, con los permisos justos. | keys:manage |
revoke_api_key | Revocar una clave. Exige confirmación expresa. | keys:manage |
Cómo conectar tu agente
Basta con la URL del MCP: https://api.blogelia.com/v1/mcp. No hay nada que instalar. Al añadirla, tu agente abre el navegador, entras en Blogelia y apruebas los permisos (OAuth; la contraseña nunca pasa por el agente). Desde ahí no hace falta el panel: el agente puede crear el blog y crear claves de API para cada proyecto.
Si prefieres una clave, créala en la pantalla de API de tu panel y mándala en la cabecera Authorization: Bearer pk_live_tu_clave. Una clave pk_test_ lee datos reales y simula cada escritura, así que es la forma de probar sin gastar créditos ni tocar tu blog.
Claude Code
- Añade el servidor con el comando de abajo.
- Abre Claude Code, escribe /mcp, elige «blogelia» y pulsa «Authenticate».
- Se abre el navegador: entra en Blogelia y aprueba los permisos. Vuelve a la terminal y ya está conectado.
Dónde: Terminal, en la carpeta de tu proyecto
claude mcp add --transport http blogelia https://api.blogelia.com/v1/mcp
# Con una clave en lugar de OAuth:
claude mcp add --transport http blogelia https://api.blogelia.com/v1/mcp \
--header "Authorization: Bearer pk_live_tu_clave"Codex
- Añade el servidor con codex mcp add.
- Ejecuta codex mcp login blogelia: se abre el navegador para entrar y aprobar los permisos.
- Abre Codex y comprueba con /mcp que «blogelia» aparece.
Dónde: Terminal (o el fichero ~/.codex/config.toml)
codex mcp add blogelia --url https://api.blogelia.com/v1/mcp
codex mcp login blogelia
# O en ~/.codex/config.toml, con una clave en la variable BLOGELIA_API_KEY:
[mcp_servers.blogelia]
url = "https://api.blogelia.com/v1/mcp"
bearer_token_env_var = "BLOGELIA_API_KEY"Claude Desktop y claude.ai
- Abre Ajustes y entra en Conectores.
- Añade un conector personalizado con el nombre Blogelia y la URL del MCP.
- Pulsa «Conectar», entra en Blogelia y aprueba los permisos.
Dónde: Ajustes → Conectores → Añadir conector personalizado
Nombre: Blogelia
URL: https://api.blogelia.com/v1/mcpCursor
- Abre Ajustes, entra en MCP y añade un servidor nuevo.
- Pega la configuración y guarda.
- Pulsa «Login» junto a «blogelia», entra en Blogelia y aprueba los permisos.
Dónde: Ajustes → MCP → Add new global MCP server (~/.cursor/mcp.json)
{
"mcpServers": {
"blogelia": {
"url": "https://api.blogelia.com/v1/mcp"
}
}
}ChatGPT
- Activa el modo desarrollador y crea un conector nuevo.
- Pon la URL del MCP y elige OAuth como autenticación.
- Entra en Blogelia, aprueba los permisos y activa el conector en la conversación.
Dónde: Ajustes → Aplicaciones y conectores → modo desarrollador → Crear
Nombre: Blogelia
URL del servidor MCP: https://api.blogelia.com/v1/mcp
Autenticación: OAuthLímites por plan
Cada operación con clave cuenta: las lecturas valen poco y generar un artículo vale mucho. Al pasarte, la API responde 429 con las cabeceras X-RateLimit-* y una pista de cuánto esperar. Los créditos de los artículos son los de tu plan y se gastan igual que si los pidieras desde el panel.
| Plan | Acceso | Peticiones por minuto | Operaciones al día | Peticiones a la vez | Generaciones por hora | Claves |
|---|---|---|---|---|---|---|
| Free | MCP con tu cuenta (conexión OAuth) y créditos de Free; claves pk_test_ para probar la API | 20 | 300 | 1 | 3 | 1 |
| Starter | API y MCP completos, claves pk_live_ y pk_test_ | 60 | 3.000 | 3 | 5 | 10 |
| Pro | API y MCP completos, claves pk_live_ y pk_test_ | 300 | 20.000 | 10 | 15 | 10 |
«Operaciones al día» cuenta el peso de cada llamada, no las llamadas: una lectura vale 1 y generar un artículo vale 50. Free no puede generar artículos con una clave de API.
Qué no puede hacer un agente
- Crear claves con más permisos que su conexión, ni crearlas con otra clave: solo una conexión OAuth con el permiso
keys:managecrea claves. - Cambiar los permisos de una clave: son fijos desde que se crea. Si necesitas otros, creas otra clave y revocas la anterior.
- Pagar, cambiar de plan, borrar la cuenta ni cambiar la contraseña: eso sigue en el panel.
- Publicar un artículo sobre salud, dinero o temas sensibles (YMYL) ni uno marcado para revisión humana: se aprueba desde el panel.
- Retirar o borrar nada sin confirmarlo expresamente en la misma llamada.
- Tocar los datos de otra cuenta: una clave solo ve la organización que la creó, y una clave restringida a un blog solo ve ese blog.
Preguntas frecuentes
¿Puede un agente publicar sin que yo lo revise?
Solo si le das el permiso «publish». Sin él, puede escribir y proponer, pero no publicar. Y un artículo sobre salud, dinero o temas sensibles (YMYL) o marcado para revisión humana nunca se publica con una clave de API: hay que aprobarlo desde el panel.
¿Cómo pruebo el MCP sin gastar créditos ni tocar mi blog?
Usa una clave pk_test_ o elige «Prueba» al aprobar la conexión. Lee datos reales, pero cada escritura responde «dry_run» con lo que habría hecho, sin guardar nada ni gastar créditos. Está disponible en todos los planes, también en Free.
¿Qué pasa si el agente se pasa de los límites?
La API responde 429 con las cabeceras X-RateLimit-* y una pista de cuánto esperar. Los límites son por minuto, por día, por peticiones a la vez y por generaciones a la hora, según tu plan.
¿Necesito entrar en el panel para usarlo?
No. Añades la URL del MCP a tu agente, entras una vez desde el navegador y apruebas los permisos; desde ahí el agente puede crear el blog, generar y publicar artículos, configurar el piloto automático y crear claves de API para cada proyecto, solo para un blog si quieres. Pagos, borrado de cuenta y contraseña siguen solo en el panel.
¿Puedo usar la API sin MCP?
Sí. La misma clave sirve para la API REST documentada en /docs, con los mismos permisos y límites. El MCP es solo una forma más cómoda de que un agente la use.
Pruébalo con una clave de prueba
Empieza gratis, sin tarjeta. Con una clave pk_test_ el agente ve tus datos y te cuenta lo que haría, sin cambiar nada.