MCP

O agentistics tem um servidor MCP embutido no binário (agentop mcp). Com ele, qualquer cliente MCP consulta as suas métricas, lê e move tarefas do Agentask, arquiva sessões em grupos e monta layouts da tela Personalizado.

Registro: automático

Você não registra nada à mão. Toda vez que agentop server sobe, ele registra o MCP em cada assistente instalado na máquina (Claude Code, Codex, Gemini, Copilot), apontando para o próprio binário. Um registro em dia fica como está; um antigo é trocado.

agentop server
claude mcp list   # deve mostrar "agentistics"

Como o MCP vem dentro do binário, agentop upgrade atualiza as ferramentas junto. Sessões que já estavam abertas continuam com o MCP antigo até serem reiniciadas.

O MCP fala com a API local. Para apontar para outro endereço:

Variável	Padrão
AGENTISTICS_API	http://localhost:47291

Ferramentas

Área	Ferramentas
Métricas	agentistics_summary, agentistics_harnesses, agentistics_projects, agentistics_sessions, agentistics_costs, agentistics_repos
Agentask (beta)	agentistics_tasks, agentistics_task, agentistics_task_create, agentistics_task_edit, agentistics_task_status, agentistics_task_statuses, agentistics_task_status_edit, agentistics_task_comment, agentistics_task_subtask, agentistics_task_link, agentistics_task_blocked_by, agentistics_task_next, agentistics_task_claim, agentistics_task_activity, agentistics_task_session, agentistics_task_delete
Grupos de sessões	agentistics_session_groups, agentistics_session_group_create, agentistics_session_group_edit
Layouts	agentistics_component_catalog, agentistics_get_layouts, agentistics_build_layout, agentistics_add_component, agentistics_remove_component, agentistics_create_layout, agentistics_set_active_layout, agentistics_delete_layout
Tags (leitura)	agentistics_tags, agentistics_tag_detail

As ferramentas de métricas aceitam um parâmetro opcional harness (claude, codex, gemini, copilot, antigravity, kimi ou all, o padrão).

Agentes trabalhando no Agentask

O ciclo que um agente segue:

1. agentistics_task_next: o que pode ser pego agora, e o que está retido e por quê.
2. agentistics_task_claim: reserva a tarefa. A reserva expira em 30 minutos e é renovada ao reservar de novo.
3. Trabalha.
4. agentistics_task_session: vincula a sessão, para a tarefa ser medida.
5. agentistics_task_status: atualiza o status.

Exemplos de pedido

Numa sessão do Claude Code:

Quanto eu gastei este mês, segundo o agentistics?
Qual harness eu mais uso, e qual custa mais?
Monte um layout no agentistics com os KPIs de custo e o gráfico de atividade.

O que o MCP não faz

• Não tem trava própria. Toda ferramenta roda na primeira chamada, inclusive as que apagam (agentistics_task_delete, agentistics_delete_layout). A proteção é o pedido de aprovação de ferramentas do seu cliente.
• Não controla a frota ao vivo. Nenhuma ferramenta lê a tela de uma sessão, manda prompt, inicia ou encerra sessões. Para isso, use a interface web, o cockpit, a extensão do VS Code ou agentop session.