@innleaders/mcp

Servidor MCP (Model Context Protocol) da biblioteca de governança InnLeaders. Expõe políticas, agentes, marcas, decisões e o design system para qualquer IA — sem acesso ao repositório.

É o MCP do roadmap (release MCP: Motor de IA): a marca e a governança viram um resource consultável por qualquer cliente MCP (Claude Code/Desktop, IDEs, agentes próprios). O pacote é self-contained — a governança e o catálogo de componentes são embutidos no build; rodar não requer clonar standards.

Instalar

Claude Code (CLI):

claude mcp add innleaders -- npx -y @innleaders/mcp

Claude Desktop — em claude_desktop_config.json:

{
  "mcpServers": {
    "innleaders": { "command": "npx", "args": ["-y", "@innleaders/mcp"] }
  }
}

Qualquer cliente MCP com transporte stdio funciona: comando npx -y @innleaders/mcp.

O que expõe

Resources

| URI | Conteúdo | |---|---| | governance://index | O roteador (GOVERNANCE.md) — "vou fazer X → abra a política Y" | | governance://domains | Os 8 domínios de política | | governance://policies/{domain} | README de um domínio (ex.: security, ai-automation) | | governance://agents · governance://agents/{id} | Roster e prompt-contrato dos agentes-função (A/C/D/E/S) | | governance://squads · governance://squads/{squad} | Esteiras estruturadas + manifesto de cada squad | | governance://brands · governance://brands/{brand} | As 9 marcas e seus dossiês | | governance://decisions · governance://decisions/{id} | ADRs | | governance://brand-core | Núcleo de marca (grafia, voz, selos) | | brand://tokens | tokens.json canônico (cores, tipografia, motion…) | | brand://components · brand://components/{name} | Catálogo do design system + código-fonte | | brand://assets · brand://assets/logos/{brand}/{variant} | URLs canônicas dos binários | | brand://rules | AGENTS.md — regras obrigatórias antes de gerar UI/código | | documents://spec | O contrato de documento Office (spec.ts de @innleaders/documents, comentado) | | documents://exemplo/{formato} | Spec de referência (documento, apresentacao, planilha) |

No servidor remoto há ainda artifact://{id} — artefatos e scorecards arquivados das esteiras.

Tools (formato dominio_acao — ADR 0003, v1.0.0)

| Domínio | Tools | |---|---| | governance | governance_route (tarefa → política e esteira) · governance_search · governance_read · governance_domains · governance_policy · governance_decision | | pipeline | pipeline_list · pipeline_get (esteira estruturada) · pipeline_stage (etapa + contrato do agente, pronto para assumir o papel) | | agent | agent_list · agent_get | | review | review_run (gate de conformidade → scorecard canônico; aceita files inline no remoto ou dir no stdio local) | | brand | brand_get · brand_tokens · brand_components · brand_component · brand_asset | | document | document_scaffold (spec inicial conforme a estrutura de proposta) · document_validate (o gate da política: reprova spec incompleto antes de gerar) | | só no remoto | artifact_archive · artifact_list · artifact_get · admin_token_issue · admin_token_list · admin_token_revoke |

Fronteira do padrão de documentos: o MCP entrega o contrato, os exemplos e o scaffold — nunca o binário .docx/.pptx/.xlsx. O servidor roda embarcado, sem filesystem do consumidor; gerar o arquivo é papel do pacote npm/CLI: npx innleaders-doc gerar spec.json saida.docx.

Prompts

iniciar_esteira (conduz uma entrega pela esteira, etapa a etapa) · auditar_entrega (roteiro do juiz, scorecard canônico) · meu_papel (assume o contrato de um agente).

Comece por governance_route — ele traduz "vou construir uma tela / vou criar uma landing page / vou tratar um secret" no domínio, na política e, quando houver squad, na esteira a acionar.

Servidor remoto (canal oficial)

O mesmo motor é servido remotamente por apps/mcp-server (Vercel), com SSO Zoho, tokens de serviço, papéis (governanca/colaborador) e log de auditoria — ver ADR 0003. Este pacote stdio continua publicado como ferramenta da Governança e plano B de disponibilidade.

Como se mantém atualizado

• Tokens e assets vêm de @innleaders/brand (dependência) — o MCP sempre reflete a versão publicada dos tokens.
• Governança e catálogo são embutidos no build (build.mjs copia policies/, agents/, brand/, docs/, registry/… e gera dist/data/manifest.json). Cada release do pacote re-embute o estado atual.

Publicação é automática a cada push na main (ver PUBLISHING.md e release.yml).

Desenvolvimento

pnpm --filter @innleaders/mcp build       # tsc + embute governança + manifest
node packages/mcp/scripts/smoke.mjs        # smoke test (client in-process)