FeedHive

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

MCP

Conecte um cliente de IA compatível com MCP ao FeedHive para encontrar contas sociais e posts, criar rascunhos, gerenciar seu plano de conteúdo e ler análises. O FeedHive expõe sua API REST pública documentada como ferramentas MCP, juntamente com seus gatilhos de automação configurados.

Conecte seu cliente MCP a https://mcp.feedhive.com usando uma chave de API do FeedHive.

Criar uma chave de API

No FeedHive, vá para Configurações > Conta e role até Chave de API para copiar sua chave.

Conectando um workspace? Crie a chave dele em Configurações > Workspace. A chave determina quais recursos do workspace você pode acessar.

Adicionar FeedHive ao seu cliente MCP

Configure um servidor MCP HTTP em https://mcp.feedhive.com e defina seu cabeçalho de autenticação como Authorization: Bearer YOUR_FEEDHIVE_API_KEY.

Seu cliente deve enviar a chave mesmo ao listar ferramentas. Mantenha-a nas configurações privadas de credenciais do cliente—não em um chat, argumento de ferramenta ou URL pública.

Verificar a conexão

Liste as ferramentas disponíveis no seu cliente e tente uma chamada somente leitura, como feedhive_socials_list ou feedhive_posts_list. Ferramentas nomeadas feedhive_{resource}_{action} usam a API REST pública; gatilhos de automação configurados aparecem como trigger_{id}.

Exemplos

Liste dois rascunhos com a ferramenta feedhive_posts_list:

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

Crie um rascunho com feedhive_posts_create (isso não publica):

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

Leia de volta o data.id retornado com feedhive_posts_get antes de editar ou agendar.

Ferramentas disponíveis

As ferramentas MCP do FeedHive cobrem posts, rótulos, mídia, slots de plano, contas sociais, análises e status da API. Você pode listar e inspecionar recursos, criar rascunhos, gerenciar rótulos e slots e agendar posts com confirmação. Seus gatilhos de automação configurados também aparecem como ferramentas trigger_{id}; seus campos de entrada dependem da configuração do seu gatilho.

Ver todos os nomes das ferramentas

Posts

• feedhive_posts_list · feedhive_posts_get
• feedhive_posts_create · feedhive_posts_update · feedhive_posts_delete

Rótulos

• feedhive_labels_list · feedhive_labels_get
• feedhive_labels_create · feedhive_labels_update · feedhive_labels_delete

Mídia

• feedhive_media_upload_start · feedhive_media_upload_complete
• feedhive_media_list · feedhive_media_get · feedhive_media_delete

Slots de plano

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

Análises e contas sociais

• feedhive_analytics_post · feedhive_analytics_social
• feedhive_socials_list · feedhive_socials_get

Status e gatilhos configurados

• feedhive_status · trigger_{id}

Cada ferramenta REST nomeada corresponde a uma operação documentada da API REST pública. A API REST controla permissões, acesso ao plano, validação e limites de taxa; ela não fornece publicação imediata, upload de bytes de mídia ou gerenciamento de workspace por meio dessas ferramentas. Use feedhive_analytics_post para análises por ID de post em vez da rota legada por ID de publicação. Ferramentas de gatilho podem publicar conteúdo; obtenha consentimento explícito antes de chamar um gatilho de publicação.

Antes de alterar conteúdo

⚠️

Um post agendado existente pode publicar texto alterado ou perder seu agendamento durante uma atualização, mesmo quando a atualização omite campos de agendamento. Revise o post de destino e obtenha aprovação antes de alterá-lo.

• Agendar um post: Forneça um scheduled_at ISO futuro, IDs de contas sociais de feedhive_socials_list, status: "scheduled" e confirm_scheduling: true. Workspaces que exigem aprovação podem armazená-lo como pendente de aprovação.
• Atribuir a slots de plano: feedhive_plan_assign_next exige confirm_scheduling: true. Pode ter sucesso parcial: inspecione cada resultado de data.items[] e leia de volta os posts afetados.
• Atualizar um post: Toda chamada de feedhive_posts_update exige confirm_update: true, incluindo edições de rascunho. Se você definir status: "scheduled" ou um scheduled_at não nulo, também forneça confirm_scheduling: true.
• Excluir um recurso: Ferramentas de exclusão exigem confirm: true.

Esses sinalizadores de confirmação são proteções do MCP; eles não são enviados à API REST.

Mídia, resultados e erros

feedhive_media_upload_start retorna uma URL PUT assinada válida por 10 minutos. Envie os bytes com um cliente HTTP separado usando o Content-Type declarado e chame feedhive_media_upload_complete com o ID de upload. Não compartilhe URLs assinadas. IDs sociais, IDs de mídia (incluindo IDs contendo /), fusos horários de slots e campos de post específicos do provedor seguem a documentação da API REST.

Ferramentas REST bem-sucedidas retornam {"success":true,"data":...} tanto no conteúdo estruturado quanto no texto. Listas incluem items, total, has_more e next_cursor; passe next_cursor como cursor enquanto has_more for verdadeiro. Contas sociais retornam sua coleção completa. Análises variam por provedor e podem estar desatualizadas; uma métrica ausente não é zero.

Gravações não são repetidas automaticamente, e a API REST pública não anuncia chave de idempotência. Após um timeout, verifique o post, rótulo ou slot afetado antes de tentar novamente para evitar duplicatas.

Erros comuns: 400 significa verificar regras de campo; 401 significa chave ausente ou inválida; 402/403 significa restrições de plano ou acesso; 404 significa que o recurso não foi encontrado para esta chave; 429 significa aguardar antes de tentar novamente; 5xx significa falha temporária da API. Erros de ferramenta não ecoam corpos da API upstream, texto de posts ou URLs assinadas.

Protocolo HTTP bruto (avançado)

Se seu cliente precisar de detalhes de protocolo bruto, envie JSON-RPC via POST com Content-Type: application/json e sua chave bearer. O servidor suporta initialize, tools/list e 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"}}}

A descoberta inclui esquemas de entrada, esquemas de saída REST e anotações de leitura/gravação para que seu cliente possa apresentar as ferramentas adequadamente.

API REST

As ferramentas MCP são construídas em torno da API REST pública do FeedHive. Para os campos precisos de requisição e resposta, consulte a documentação da API REST.