Acttus OS · MCP
Conecte o Acttus OS ao Claude (e a qualquer cliente MCP) para operar o calendário editorial, o board, o banco de ideias e os relatórios da sua agência por chat.
Como conectar no Claude
- No Claude: Configurações → Conectores → Adicionar conector personalizado.
- Nome: escolha um nome (ex.: “Acttus OS”).
- URL do servidor MCP remoto: cole o endpoint abaixo. https://acttus-mcp.tecsystem.workers.dev/mcp
- Configurações avançadas (ID/Secret OAuth): deixe em branco — o Acttus faz o registro OAuth automático.
- Clique em Adicionar → o Claude abre a tela de autorização do Acttus.
- Cole sua chave de API do Acttus OS e autorize. A chave é criada no app do Acttus em Integrações → API & Integrações.
- Ative o conector na conversa. As ferramentas
acttus_*aparecem.
Autenticaçãoa sua chave de API é a senha
Não há ID/Secret de OAuth para preencher: a “senha” do OAuth é a própria chave de API do Acttus OS. A tela de autorização a valida em /ping e a usa em todas as chamadas.
A chave define o escopo: uma chave só-leitura deixa o assistente apenas consultar (funções 🔍); uma chave leitura + escrita permite criar, editar e excluir (funções ✏️). Cada pessoa conecta com a própria chave.
🔒 A chave de API é um segredo (equivale a uma senha). Não a compartilhe. Revogou a chave no app do Acttus? O conector para de funcionar na hora.
Também funciona no Claude Code / Desktop / Cursor (mesmo OAuth no navegador): claude mcp add --transport http acttus-os https://acttus-mcp.tecsystem.workers.dev/mcp
O que dá pra pedir (funções)
🔍 Leitura só consulta
✏️ Escrita altera dados (exige chave com escopo write)
Uma chave só-leitura enxerga apenas as funções 🔍. Basta pedir em português no chat — os exemplos abaixo são só um ponto de partida.
Calendário ≠ Banco de ideias: o calendário são publicações agendadas (posts); o banco de ideias não vira post nem entra no calendário.
Calendário ≠ Banco de ideias: o calendário são publicações agendadas (posts); o banco de ideias não vira post nem entra no calendário.
Agenda e publicações · 5 funções
acttus_agenda🔍 Leitura
Agenda de publicações (posts) num período (hoje/amanhã/semana/mês ou de/até). Filtro opcional por cliente.
No chat“O que temos para publicar essa semana no cliente Fulano?”
acttus_atrasados🔍 Leitura
Posts com data de publicação já passada e ainda não publicados.
No chat“O que está atrasado?”
acttus_aprovacoes_pendentes🔍 Leitura
Posts aguardando aprovação do cliente. Filtro opcional por cliente.
No chat“O que está aguardando aprovação da Fulano?”
acttus_agendar_post✏️ Escrita
Cria/agenda 1 post de forma amigável, resolvendo cliente e responsável por nome.
No chat“Agenda um reels de topo dia 10/07 às 18h para a Fulano, responsável Ana.”
acttus_mover_status✏️ Escrita
Move um post para outro status do board (tolera variações sem acento).
No chat“Move o post abc123 para Finalizado.”
Calendário e ideias em lote · 3 funções
acttus_criar_calendario✏️ Escrita
Sobe VÁRIOS posts do calendário de uma vez (ex.: o mês inteiro de um cliente). São publicações agendadas.
No chat“Monta o calendário de julho da Fulano: dia 2 reels topo, dia 5 carrossel meio, dia 9 estático fundo…”
acttus_criar_ideias✏️ Escrita
Adiciona uma ou várias ideias ao banco de ideias (≠ calendário; não vira post).
No chat“Adiciona essas ideias no banco da Fulano: bastidores, depoimento de cliente, tutorial rápido.”
acttus_resumo_mes🔍 Leitura
Resumo do calendário de um mês (atual/passado/AAAA-MM). Ideal para ver o que já foi publicado e não repetir tema.
No chat“O que foi publicado mês passado da Fulano?”
Board, funil e visão geral · 4 funções
acttus_board🔍 Leitura
Snapshot do board editorial: quantos posts em cada status. Filtro opcional por cliente.
No chat“Como está o board do cliente X?”
acttus_funil🔍 Leitura
Distribuição do funil 50/30/20 (topo/meio/fundo) com percentuais e comparação à meta.
No chat“O funil da Fulano está batendo o 50/30/20?”
acttus_resumo_semana🔍 Leitura
Resumo executivo da semana: publicados, a publicar, aguardando aprovação, atrasados e ideias novas.
No chat“Me dá o resumo da semana.”
acttus_carga_equipe🔍 Leitura
Carga de trabalho por responsável: quantos posts em aberto cada pessoa tem.
No chat“Quem está mais sobrecarregado na equipe?”
Clientes e pessoas · 3 funções
acttus_cliente🔍 Leitura
Panorama de um cliente (por nome): posts por status, próximas publicações e nº de ideias novas.
No chat“Me dá um panorama do cliente Fulano.”
acttus_minhas_tarefas🔍 Leitura
O que uma pessoa (por nome) tem em aberto: posts sob responsabilidade dela + rotinas pendentes.
No chat“O que a Ana tem em aberto?”
acttus_buscar🔍 Leitura
Busca por texto em posts (título/legenda), ideias, clientes e projetos. Útil quando você não tem o id.
No chat“Procura tudo que fala de black friday.”
CRUD genérico · 7 funções · escape hatch para tudo
acttus_ping🔍 Leitura
Valida a chave de API e mostra o nome da chave e seus escopos (read/write).
No chat“Minha chave está válida? O que ela pode fazer?”
acttus_resources🔍 Leitura
Lista os recursos da API (posts, clients, ideas, projects, project-tasks, meetings, routines, users, notifications), seus filtros e o que é gravável.
No chat“Quais recursos e filtros eu posso usar?”
acttus_list🔍 Leitura
Lista registros de um recurso com filtros de querystring e paginação.
No chat“Lista os projetos com status em andamento.”
acttus_get🔍 Leitura
Busca um registro específico de um recurso pelo id.
No chat“Me mostra o registro abc123 de projects.”
acttus_create✏️ Escrita
Cria um registro em um recurso gravável (posts, clients, ideas, projects, tarefas, reuniões, rotinas).
No chat“Cria uma reunião de alinhamento amanhã com a Fulano.”
acttus_update✏️ Escrita
Atualiza campos de um registro pelo id (envie só o que mudar).
No chat“Marca a rotina xyz789 como concluída.”
acttus_delete✏️ Escrita
Exclui um registro pelo id. Ação irreversível.
No chat“Exclui a ideia de id def456.”
Endpoint MCP: https://acttus-mcp.tecsystem.workers.dev/mcp · Acttus OS