FeedHive

npx add-mcp 'https://mcp.feedhive.com'

MCP

Conecta un cliente de IA compatible con MCP a FeedHive para encontrar cuentas y publicaciones sociales, crear borradores, gestionar tu plan de contenido y leer análisis. FeedHive expone su API REST pública documentada como herramientas MCP, junto con tus automatizaciones configuradas.

Conecta tu cliente MCP a https://mcp.feedhive.com usando una clave API de FeedHive.

Crear una clave API

En FeedHive, ve a Configuración > Cuenta, luego desplázate hasta Clave API y copia tu clave.

¿Conectando un espacio de trabajo? Crea su clave en Configuración > Espacio de trabajo. La clave determina a qué recursos del espacio de trabajo puedes acceder.

Añadir FeedHive a tu cliente MCP

Configura un servidor MCP HTTP en https://mcp.feedhive.com y establece su encabezado de autenticación a Authorization: Bearer YOUR_FEEDHIVE_API_KEY.

Tu cliente debe enviar la clave incluso al listar herramientas. Mantenla en la configuración privada de credenciales del cliente, no en un chat, argumento de herramienta o URL pública.

Verificar la conexión

Lista las herramientas disponibles en tu cliente y luego prueba una llamada de solo lectura como feedhive_socials_list o feedhive_posts_list. Las herramientas llamadas feedhive_{resource}_{action} usan la API REST pública; las automatizaciones configuradas aparecen como trigger_{id}.

Ejemplos

Lista dos borradores con la herramienta feedhive_posts_list:

{"limit":2,"status":"draft"}

Crea un borrador con feedhive_posts_create (esto no publica):

{"text":"Draft example","status":"draft"}

Lee el data.id devuelto con feedhive_posts_get antes de editarlo o programarlo.

Herramientas disponibles

Las herramientas MCP de FeedHive cubren publicaciones, etiquetas, medios, espacios del plan, cuentas sociales, análisis y estado de la API. Puedes listar e inspeccionar recursos, crear borradores, gestionar etiquetas y espacios, y programar publicaciones con confirmación. Tus automatizaciones configuradas también aparecen como herramientas trigger_{id}; sus campos de entrada dependen de tu configuración de automatización.

Ver todos los nombres de herramientas

Publicaciones

• feedhive_posts_list · feedhive_posts_get
• feedhive_posts_create · feedhive_posts_update · feedhive_posts_delete

Etiquetas

• feedhive_labels_list · feedhive_labels_get
• feedhive_labels_create · feedhive_labels_update · feedhive_labels_delete

Medios

• feedhive_media_upload_start · feedhive_media_upload_complete
• feedhive_media_list · feedhive_media_get · feedhive_media_delete

Espacios del plan

• feedhive_slots_list · feedhive_slots_get
• feedhive_slots_create · feedhive_slots_update · feedhive_slots_delete
• feedhive_plan_assign_next

Análisis y cuentas sociales

• feedhive_analytics_post · feedhive_analytics_social
• feedhive_socials_list · feedhive_socials_get

Estado y automatizaciones configuradas

• feedhive_status · trigger_{id}

Cada herramienta REST nombrada corresponde a una operación de API REST pública documentada. La API REST controla permisos, acceso al plan, validación y límites de tasa; no proporciona publicación inmediata, carga de bytes de medios ni gestión del espacio de trabajo a través de estas herramientas. Usa feedhive_analytics_post para análisis por ID de publicación en lugar de la ruta heredada por ID de publicación. Las herramientas de automatización pueden publicar contenido; obtén consentimiento explícito antes de llamar a una automatización de publicación.

Antes de cambiar contenido

⚠️

Una publicación programada existente puede publicar texto modificado o perder su programación durante una actualización, incluso cuando la actualización omite campos de programación. Revisa la publicación objetivo y obtén aprobación antes de cambiarla.

• Programar una publicación: Proporciona un scheduled_at ISO futuro, IDs de cuentas sociales de feedhive_socials_list, status: "scheduled" y confirm_scheduling: true. Los espacios de trabajo que requieren aprobación pueden almacenarla como pendiente de aprobación en su lugar.
• Asignar a espacios del plan: feedhive_plan_assign_next requiere confirm_scheduling: true. Puede tener éxito parcial: inspecciona cada resultado de data.items[] y lee las publicaciones afectadas.
• Actualizar una publicación: Cada llamada a feedhive_posts_update requiere confirm_update: true, incluidas las ediciones de borradores. Si estableces status: "scheduled" o un scheduled_at no nulo, también proporciona confirm_scheduling: true.
• Eliminar un recurso: Las herramientas de eliminación requieren confirm: true.

Estas banderas de confirmación son salvaguardas de MCP; no se envían a la API REST.

Medios, resultados y errores

feedhive_media_upload_start devuelve una URL PUT firmada válida por 10 minutos. Sube los bytes con un cliente HTTP separado usando el Content-Type declarado, luego llama a feedhive_media_upload_complete con el ID de carga. No compartas URLs firmadas. Los IDs sociales, IDs de medios (incluidos IDs que contienen /), zonas horarias de espacios y campos de publicación específicos del proveedor siguen la documentación de la API REST.

Las herramientas REST exitosas devuelven {"success":true,"data":...} tanto en contenido estructurado como de texto. Las listas incluyen items, total, has_more y next_cursor; pasa next_cursor como cursor mientras has_more sea verdadero. Las cuentas sociales devuelven su colección completa en su lugar. Los análisis varían según el proveedor y pueden estar desactualizados; una métrica faltante no es cero.

Las escrituras no se reintentan automáticamente y la API REST pública no anuncia una clave de idempotencia. Después de un tiempo de espera, verifica la publicación, etiqueta o espacio afectado antes de intentar nuevamente para evitar duplicados.

Errores comunes: 400 significa verificar las reglas de campos; 401 significa clave faltante o inválida; 402/403 significa restricciones de plan o acceso; 404 significa que el recurso no se encuentra para esta clave; 429 significa esperar antes de reintentar; 5xx significa una falla temporal de la API. Los errores de herramientas no reflejan los cuerpos de la API ascendente, el texto de publicaciones ni las URLs firmadas.

Protocolo HTTP sin procesar (avanzado)

Si tu cliente necesita detalles de protocolo sin procesar, envía JSON-RPC mediante POST con Content-Type: application/json y tu clave bearer. El servidor admite initialize, tools/list y tools/call:

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"your-client","version":"1.0.0"}}}

{"jsonrpc":"2.0","id":2,"method":"tools/list"}

{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"feedhive_posts_list","arguments":{"limit":2,"status":"draft"}}}

El descubrimiento incluye esquemas de entrada, esquemas de salida REST y anotaciones de lectura/mutación para que tu cliente pueda presentar las herramientas adecuadamente.

API REST

Las herramientas MCP se basan en la API REST pública de FeedHive. Para los campos precisos de solicitud y respuesta, consulta la documentación de la API REST.