spec v0.1
PT

Exemplos

Exemplos por Setor

O mesmo princípio de arquitetura em diferentes domínios, Real Estate, Payroll, DevOps, CRM e Support mostram como as Capabilities MCP-first se parecem na prática.

O padrão é sempre o mesmo: primeiro descrever as capacidades do sistema, depois construir interfaces sobre elas. O domínio muda, a estrutura de Resources, Tools e classes de risco permanece idêntica. Os exemplos a seguir mostram como o MCP-first se parece concretamente em diferentes setores.

Real Estate

Um software imobiliário clássico pensa em interfaces: lista de projetos, gestão de contatos, página de exposé, visualização de e-mail, modal de lembrete. O MCP-first inverte isso, primeiro surgem as capacidades, depois o webapp como cliente sobre as mesmas Actions.

Clássico

  1. Lista de projetos
  2. Gestão de contatos
  3. Página de exposé
  4. Visualização de e-mail
  5. Modal de lembrete

MCP-first

  1. projects.list_active
  2. contacts.search_buyers
  3. exposes.generate_download_link
  4. emails.send_project_email
  5. deals.recommend_next_action

O webapp chama as mesmas Actions que o agente. Não há lógica de agente separada, o Capability Layer é o núcleo comum para ambos.

Tools
  • projects.list_active Low
  • projects.get_context Low
  • contacts.search_buyers Low
  • contacts.get_purchase_profile Low
  • exposes.generate_download_link Medium
  • emails.create_project_draft Medium
  • calendar.find_free_slot Low
  • calendar.create_buyer_meeting Medium
  • reminders.create_follow_up Low
  • emails.send_project_email Critical
  • deals.recommend_next_action Low

Payroll & RH

Sistemas de folha de pagamento gerenciam alguns dos dados mais sensíveis de uma empresa. O MCP-first separa claramente o que um agente pode ler, o que pode preparar e o que só é executado após aprovação explícita.

Resources
  • employees.list Low
  • employees.get Medium
  • payroll_runs.list Medium
  • payroll_runs.get Medium
  • documents.list_missing Low
  • absences.list Low
  • contracts.get Medium
Tools
  • employees.create Medium
  • employees.update Medium
  • documents.request_missing Low
  • payroll.validate_run Medium
  • payroll.explain_difference Low
  • payroll.generate_report Medium
  • absences.approve Medium
  • salary.read Restricted
  • payroll.export Critical
  • salary.change Critical

A gradação de risco em resumo:

  • Low employee.basic.read, dados cadastrais, inofensivo para o agente
  • Restricted salary.read, apenas com aprovação adicional, transmissão restrita
  • Critical payroll.export, sempre confirmação, Audit Event
  • Critical salary.change, Step-up Auth + princípio dos quatro olhos recomendado

DevOps

Um painel de controle DevOps gerencia infraestrutura, deployments e secrets. As classes de risco são especialmente importantes aqui: ler logs é inofensivo, ler secrets é proibido.

Resources
  • projects.list Low
  • deployments.list Low
  • services.status Low
  • logs.query Medium
  • metrics.get Low
  • secrets.list_metadata Medium
Tools
  • deployments.create High
  • deployments.rollback High
  • services.restart High
  • dns.create_record High
  • ssl.issue_certificate Medium
  • firewall.update_rule Critical
  • secrets.rotate Critical
  • secrets.read Forbidden for AI

A gradação de risco em resumo:

  • Medium logs.query, autônomo permitido, scope limitado
  • High deployment.create / rollback, confirmação necessária
  • Critical secrets.rotate / firewall.update_rule, sempre Step-up Auth
  • Forbidden for AI secrets.read, inacessível para agentes

CRM & Vendas

Um Sales Assistant precisa de acesso a contatos, negócios e comunicação, mas não a direitos de sistema, Billing ou gestão de tenants. O MCP-first garante que o agente veja exatamente as capacidades de que precisa para sua tarefa.

Resources
  • contacts.list Low
  • contacts.search Low
  • contacts.timeline Low
  • contacts.communication_history Medium
  • companies.get Low
  • deals.list_active Low
Tools
  • contacts.search Low
  • contacts.add_note Low
  • reminders.create Low
  • deals.recommend_next_action Low
  • emails.create_draft Medium
  • calendar.create_event Medium
  • emails.send_external Critical

O agente pode criar rascunhos, adicionar notas, recomendar próximos passos e preparar compromissos. E-mails externos são Critical, o humano confirma o envio, independentemente de quão inequívoco seja o contexto.

Suporte

Um agente de suporte precisa principalmente de acesso de leitura rico: histórico de tickets, dados de contexto, comunicação anterior. Ações de escrita se limitam a rascunhos e notas internas, até a aprovação explícita.

Resources
  • tickets.list_open Low
  • tickets.get Low
  • tickets.thread Low
  • contacts.get Low
  • contacts.timeline Low
  • emails.thread Medium
  • communications.timeline Low
Tools
  • tickets.get_context Low
  • contacts.search Low
  • tickets.add_internal_note Low
  • emails.create_draft Medium
  • tickets.update_status Medium
  • tickets.assign Medium
  • emails.send_external Critical

O agente de suporte reúne contexto, sugere respostas e adiciona notas internas. Assim que uma resposta deve ir para fora, aplica-se o mesmo princípio de sempre: o humano confirma, o agente prepara.