Pular para o conteúdo principal

Instalação por cliente

O servidor @shiftleftpt/sbd-toe-mcp é distribuído exclusivamente via npm (mais bundle GitHub Release alternativo) e corre como processo stdio — compatível com qualquer cliente MCP padrão.

Pré-requisitos​

RequisitoDetalhe
Node.js≥ 20.9.0
Acesso ao registo npmPública — sem token necessário
Espaço em discoAlgumas dezenas de MB (snapshot do manual, KG e ontologia)
RedeApenas no primeiro arranque (npx faz fetch) ou em upgrades
Modo offline / air-gapped

Para ambientes sem acesso npm, descarregar o bundle do GitHub Release, verificar o .sha256 e referir o dist/index.js extraído via command: "node" (ver secção GitHub Release Bundle).

Claude Code (CLI)​

Forma mais simples — um comando, zero edição de ficheiros:

claude mcp add sbd-toe -- npx -y @shiftleftpt/sbd-toe-mcp

Para verificar:

claude mcp list

Para remover:

claude mcp remove sbd-toe

A configuração fica guardada em ~/.claude.json (escopo global) ou em .mcp.json (escopo projecto, com --scope project).

Claude Desktop (macOS / Windows)​

Editar o ficheiro claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "sbd-toe": {
      "command": "npx",
      "args": ["-y", "@shiftleftpt/sbd-toe-mcp"]
    }
  }
}

Reiniciar o Claude Desktop. As tools sbd-toe.* aparecem no painel de ferramentas da conversa.

Cursor​

Editar ~/.cursor/mcp.json (global) ou .cursor/mcp.json no repositório (por projecto):

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

Em Settings → Features → MCP, confirmar que sbd-toe aparece como running (badge verde).

VS Code + GitHub Copilot​

Adicionar .vscode/mcp.json no repositório (auto-detectado pelo Copilot Chat em modo Agent):

{
  "servers": {
    "sbdToe": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@shiftleftpt/sbd-toe-mcp"]
    }
  }
}

Em alternativa, configuração global do utilizador via Settings UI → Extensions → GitHub Copilot → MCP.

Windsurf (Codeium)​

Editar ~/.codeium/windsurf/mcp_config.json:

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

Zed​

Editar ~/.config/zed/settings.json, secção context_servers:

{
  "context_servers": {
    "sbd-toe": {
      "command": {
        "path": "npx",
        "args": ["-y", "@shiftleftpt/sbd-toe-mcp"]
      }
    }
  }
}

Outros clientes MCP​

Qualquer cliente que suporte o transporte stdio do MCP usa o mesmo padrão: command: "npx" + args: ["-y", "@shiftleftpt/sbd-toe-mcp"]. Consultar a documentação do cliente para localização do ficheiro de configuração.

GitHub Release Bundle​

Para ambientes sem acesso a npm (air-gapped, self-hosted) ou para pinning a uma versão específica:

  1. Descarregar o bundle de github.com/SbD-ToE/sbd-toe-mcp/releases — sbd-toe-mcp-v<versão>-bundle.tar.gz (ou .zip) — e o respetivo .sha256, e verificar o checksum antes de extrair.
  2. Extrair para um caminho conhecido — /opt/sbd-toe-mcp/ por exemplo.
  3. Referir o dist/index.js em vez de npx:
{
  "mcpServers": {
    "sbd-toe": {
      "command": "node",
      "args": ["/opt/sbd-toe-mcp/dist/index.js"]
    }
  }
}

Determinar o risk level do projecto​

Sem risk level correcto, o MCP devolve um conjunto de controlos desnecessariamente amplo ou perigosamente reduzido. O nível calcula-se pelo método do cap. 01 (eixos exposição, dados e impacto, E+D+I). Os indicadores abaixo são pistas ilustrativas, nem necessárias nem suficientes, e o contexto regulatório declara-se à parte: um regime não implica L3.

Indicador (ilustrativo)Tipicamente
Aplicação interna de impacto baixo (mesmo com dados pessoais, se E+D+I ≤ 4)L1
APIs públicas ou tratamento de dados de utilizadorL2
Exposição pública com dados sensíveis e impacto elevadoL3

A decisão do nível segue o método do cap. 01 — nenhuma tool a toma pelo projeto. A tool map_sbd_toe_applicability exige riskLevel e aceita technologies, hasPersonalData, isPublicFacing e projectRole: não decide o nível, mas mostra o efeito de cada nível no projeto, o que ajuda a comparar as alternativas quando há dúvida.

Verificação final​

Independentemente do cliente, validar com:

list_sbd_toe_chapters()

Deve devolver 15 capítulos (00-fundamentos a 14-governanca-contratacao). Se sim — está operacional.

A seguir​

Configurar uma skill / agent file para que o cliente AI consulte o manual automaticamente em vez de exigir que o utilizador peça explicitamente.