Catálogo de tools MCP

O simplafy-admin expõe um servidor MCP em https://mcp-admin.simplafy.com.br/mcp que coding agents consomem via Streamable HTTP. As tools se dividem em duas famílias:

• Tools nativas: implementadas dentro do servidor (apps/mcp-server/src/tools), com acesso direto ao banco do admin (PM Board, BI, Knowledge Base, Lab, Langfuse).
• Tools de proxy: chamadas roteadas para backends MCP de terceiros (GitHub, Cloudflare, Infisical, GlitchTip, n8n, Resend), registrados via proxy_register_backend e curados por allowlist quando o vendor expõe centenas de operações.

Os prefixos a seguir correspondem 1:1 ao que aparece em mcp__simplafy-admin__<prefix>_<tool> quando um agente Claude lista o servidor.

pm_* (PM Board)

Tools nativas que operam sobre o board hierárquico do admin (Theme → Capability → Epic → Story → Module). São o caminho oficial para que agentes criem, movam e referenciem cards sem depender da UI.

Funcionalidades cobertas:

• CRUD de hierarquia: pm_create_theme, pm_create_capability, pm_create_epic, pm_create_story, pm_create_module e suas contrapartes update_* / delete_*.
• Listagem e busca: pm_list_themes, pm_list_capabilities, pm_list_epics, pm_list_stories, pm_list_modules, pm_search_stories, pm_get_hierarchy, pm_get_story, pm_resolve_number.
• Movimentação e ordenação: pm_move_card, pm_reorder, pm_bulk_update_status, pm_duplicate_story.
• Comentários: pm_add_comment, pm_list_comments.
• Anexos: pm_upload_attachment, pm_list_attachments, pm_get_attachment, pm_delete_attachment.

Use estas tools para automatizar grooming, sincronizar PRs com cards e gerar relatórios baseados no board.

github_* (GitHub)

Tools roteadas via proxy para o backend oficial mcp-server-github, registrado pelo slug github. Cobrem o fluxo completo de trabalho da org Simplafy-tec:

• Repositórios: github_create_repository, github_fork_repository, github_search_repositories, github_get_file_contents, github_create_or_update_file, github_push_files, github_create_branch, github_list_commits.
• Issues: github_create_issue, github_get_issue, github_list_issues, github_update_issue, github_add_issue_comment, github_search_issues.
• Pull requests: github_create_pull_request, github_get_pull_request, github_list_pull_requests, github_merge_pull_request, github_update_pull_request_branch, github_get_pull_request_files, github_get_pull_request_comments, github_get_pull_request_reviews, github_get_pull_request_status, github_create_pull_request_review.
• Busca: github_search_code, github_search_users.

Autenticação acontece no backend via GITHUB_PERSONAL_ACCESS_TOKEN; agentes não recebem nem precisam manipular o token.

infisical_* (Secrets)

Proxy para o servidor MCP oficial do Infisical (slug infisical). É o canal recomendado quando um agente precisa ler ou rotacionar segredos sem que a credencial trafegue pelo prompt.

• Discovery: infisical_list-projects, infisical_list-secrets.
• CRUD de segredos: infisical_create-secret, infisical_get-secret, infisical_update-secret, infisical_delete-secret.
• Estrutura: infisical_create-project, infisical_create-environment, infisical_create-folder.
• Onboarding: infisical_invite-members-to-project.

cloudflare_* + cloudflare_workers_*

Proxy para mcp-server-cloudflare (slug cloudflare) com curadoria explícita: dos 89 endpoints expostos pelo vendor, o seed apps/mcp-server/src/proxy/seed-backends.ts mantém uma allowlist focada em DNS e roteamento.

Allowlist ativa por padrão:

const CLOUDFLARE_ALLOWLIST = [
  'zones_list',
  'zones_get',
  'domain_list',
  'route_list',
  'route_create',
  'route_update',
  'route_delete',
  'version_list',
  'version_rollback',
]

As demais áreas (Workers, R2, KV, D1, Queues, Durable Objects, AI, Workflows, Cron, secrets, env vars, service bindings, WfP, analytics) seguem disponíveis no backend e podem ser habilitadas estendendo a allowlist via proxy_set_tool_allowlist para o slug cloudflare. Quando habilitadas, aparecem como cloudflare_worker_*, cloudflare_r2_*, cloudflare_kv_*, cloudflare_d1_*, cloudflare_queue_*, cloudflare_do_*, cloudflare_ai_*, cloudflare_workflow_*, cloudflare_cron_*, cloudflare_secret_*, cloudflare_env_var_*, cloudflare_service_binding_*, cloudflare_wfp_*, cloudflare_analytics_*, cloudflare_template_*, cloudflare_route_* e cloudflare_version_*.

Para alterar a curadoria:

# listar backends e ver allowlist atual
mcp__simplafy-admin__proxy_list_backends

# habilitar workers + KV no slug cloudflare
mcp__simplafy-admin__proxy_set_tool_allowlist \
  --slug cloudflare \
  --tools '["zones_list","worker_list","worker_deploy","kv_list","kv_get","kv_put"]'

glitchtip_, n8n_, resend_* (Ops)

Três backends de proxy focados em operação de produção. Todos rodam em modo stdio dentro do pod do MCP server.

const RESEND_ALLOWLIST = [
  'send-email',
  'send-batch-emails',
  'send-broadcast',
  'send-event',
  'list-emails',
  'get-email',
  'cancel-email',
  'update-email',
  'list-domains',
  'get-domain',
  'create-domain',
  'update-domain',
  'remove-domain',
  'verify-domain',
  'list-templates',
  'get-template',
  'list-broadcasts',
  'get-broadcast',
  'compose-broadcast',
  'get-contact',
]

obs_, lab_, bi_* (Observability/Analytics)

Família voltada para investigação de incidentes, experimentação dirigida por cenário e análise de produto.

obs_* — tools de observabilidade que correlacionam GlitchTip, Tempo (traces), Loki (logs), Alertmanager e RabbitMQ DLQ:

• obs_correlate_issue — dado um issue ID do GlitchTip, retorna traces e logs relacionados em uma única chamada.
• obs_get_issue, obs_search_issues — consulta direta ao GlitchTip pelo cliente normalizado.
• obs_get_trace — busca um trace específico no Tempo.
• obs_query_logs — query LogQL no Loki.
• obs_list_alerts — alertas ativos no Alertmanager.
• obs_list_dlq — peek nas filas dead-letter do RabbitMQ.

lab_* — tools nativas do simulador interno de cenários (apps/mcp-server/src/tools/lab):

• lab_list_scenarios — lista cenários cadastrados.
• lab_run_scenario — dispara execução de um cenário.
• lab_get_results — consulta resultados de uma execução.
• lab_compare_runs — diff entre duas execuções.

bi_* — tools nativas que leem o data layer de BI do admin (apps/mcp-server/src/tools/bi):

• bi_get_kpis — KPIs agregados.
• bi_get_metrics — séries temporais.
• bi_get_users — lista de usuários ativos com filtros.
• bi_get_user_detail — drilldown por usuário.
• bi_get_usage_index — índice de uso por tenant/produto.

openapi_* (Registry — DEPRECATED)

O registry de specs OpenAPI permanece registrado no servidor (openapi_list_specs, openapi_get_spec, openapi_register_spec, openapi_refresh_spec), mas está marcado como descontinuado: o módulo de tools correspondente não acompanha mais o código atual em apps/mcp-server/src/tools/ e novas integrações devem ser cadastradas via proxy_register_backend em vez de upload de spec.

Para descobrir o substituto adequado em integrações existentes, consulte proxy de backends MCP e registro de tools.