Integração com agentes de IA · MCP

Chikaboom para agentes de IA

O Chikaboom disponibiliza as suas ferramentas de renderização e agendamento através do MCP (Model Context Protocol). Qualquer cliente de IA compatível com MCP pode autenticar-se com uma chave de API e chamar as ferramentas do Chikaboom em nome do utilizador.

O que esta integração faz

Quando liga um agente de IA externo ao Chikaboom, o seu assistente de IA passa a poder:

  • listar as suas marcas e descobrir que modelos estão disponíveis
  • renderizar publicações para redes sociais fiéis à marca (individuais, em lote ou carrossel de vários diapositivos)
  • agendar as publicações renderizadas no seu calendário de conteúdos para publicação automática
  • ler as suas publicações agendadas para evitar marcações duplicadas

O agente trabalha com os mesmos modelos de marca que um designer criou para si, por isso o resultado é sempre fiel à marca. O agente não pode desenhar formas nem alterar a identidade visual; só pode preencher os campos de texto que o seu designer disponibilizou.

Início rápido: Claude Desktop

  1. Gere uma chave de API. Inicie sessão no Chikaboom, abra Definições → API e MCP e clique em Criar nova chave. Copie o token (bs_live_…). Só é mostrado uma vez.
  2. Edite a configuração do Claude Desktop. No macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    {
  "mcpServers": {
    "chikaboom": {
      "url": "https://<your-chikaboom-domain>/api/mcp",
      "headers": {
        "Authorization": "Bearer bs_live_YOUR_TOKEN"
      }
    }
  }
}
  3. Reinicie o Claude Desktop. As ferramentas do Chikaboom passam a aparecer na lista de ferramentas do Claude.
  4. Peça em linguagem natural. Experimente: "Renderiza uma publicação do LinkedIn sobre o lançamento do nosso último produto e agenda-a para sexta-feira às 9h." O agente chama as ferramentas do Chikaboom e devolve URLs de pré-visualização clicáveis.

Referência de ferramentas

O Chikaboom disponibiliza as seguintes ferramentas através do MCP:

list_brands

Descobrir a que marcas o utilizador autenticado tem acesso.

Entrada(sem parâmetros)
SaídaArray of { brand_id, brand_name, role, templates_count }
list_templates

Lista os modelos de uma marca, incluindo o esquema de campos de cada modelo (para o agente saber que chaves pode preencher).

Entrada{ brand_id: string }
SaídaArray of { template_id, name, category, width, height, fields[] }
render_post

Renderiza uma única publicação em PNG. Devolve um URL público.

Entrada{ brand_id, template_id, content: Record<string,string>, format_id? }
Saída{ url, template_id, template_name, width, height, duration_ms }
render_batch

Renderiza várias publicações numa só chamada. Devolve um URL de ZIP.

Entrada{ brand_id, template_id, rows: Array<Record<string,string>> }
Saída{ zip_url, total, succeeded, failed, failures[] }
render_carousel

Renderiza um carrossel de vários diapositivos em PDF para publicações de documento do LinkedIn. Devolve o URL do PDF e um PNG do diapositivo de capa para pré-visualizações.

Entrada{ brand_id, slides: Array<{template_id, content}>, title? }
Saída{ pdf_url, cover_url, slides_count }
schedule_post

Cria uma publicação agendada no calendário de conteúdos do utilizador. Opcionalmente, pré-renderiza o recurso ou agenda como rascunho.

Entrada{ brand_id, template_id, content, scheduled_for (ISO 8601), caption?, platforms?, asset_url? }
Saída{ post_id, status, scheduled_for, calendar_url }
list_scheduled_posts

Lê o calendário do utilizador num intervalo de datas. Útil antes de agendar, para evitar publicações duplicadas.

Entrada{ brand_id, from?, to? }
Saída{ posts[], count }
ask_user

Ferramenta do lado do cliente: apresenta opções clicáveis ao utilizador. O agente usa-a quando a resposta é uma de poucas opções (que marca, que modelo, a que horas, etc.).

Entrada{ question, options: string[2..6], allow_other? }
Saída(o texto escolhido pelo utilizador volta como a mensagem seguinte do utilizador)

Detalhes do protocolo

O Chikaboom implementa o MCP versão 2024-11-05 sobre JSON-RPC 2.0 em POST /api/mcp.

Métodos suportados:

  • initialize: handshake, devolve a versão do protocolo e as informações do servidor
  • tools/list: lista as definições de ferramentas disponíveis
  • tools/call: invoca uma ferramenta com argumentos
  • notifications/initialized: confirmação sem efeito (devolve 204)

Os erros seguem os códigos padrão do JSON-RPC 2.0. As falhas de autenticação devolvem -32000 com uma mensagem clara; os métodos inexistentes devolvem -32601.

Perguntas frequentes

Que protocolo usa a integração de IA do Chikaboom?

MCP (Model Context Protocol). O Chikaboom implementa um servidor JSON-RPC 2.0 em POST /api/mcp que suporta os métodos MCP padrão: initialize, tools/list, tools/call.

Que clientes de IA se podem ligar ao Chikaboom?

Qualquer cliente compatível com MCP. Funcionamento confirmado: Claude Desktop. Deverá funcionar também com o Cursor, agentes personalizados criados com o Anthropic SDK e outros clientes MCP à medida que adotam o padrão.

Como funciona a autenticação dos agentes de IA?

Chaves de API. Cada utilizador gera uma ou mais chaves na página Definições. As chaves estão limitadas às marcas a que esse utilizador tem acesso. Envie-as como Authorization: Bearer <key>. As chaves podem ser revogadas a qualquer momento e a hora da última utilização fica registada.

Um agente de IA pode publicar no LinkedIn/Twitter diretamente através do Chikaboom?

Indiretamente. O agente chama schedule_post para colocar uma publicação no calendário. Depois, o cron worker do Chikaboom publica nas plataformas ligadas à hora agendada. O próprio agente nunca acede às APIs das plataformas.

Existem limites de pedidos no endpoint MCP?

Cada renderização demora cerca de 200-400 ms, consoante a complexidade do modelo. De momento não há um limite rígido; uma utilização abusiva suspende a chave automaticamente. A ferramenta de lote reduz a sobrecarga em operações em massa.

Pronto para ligar?

Inicie sessão, crie uma chave de API nas Definições e o seu cliente de IA passa a ter renderização fiel à marca como capacidade nativa.

Iniciar sessão e criar chave