SEI-MCP

MCP (Model Context Protocol) server + extensão Chrome para automação do sistema SEI! (Sistema Eletrônico de Informações) via Claude Code.

Funcionalidades

• sei_login - Login automático no SEI
• sei_search_process - Busca de processos
• sei_download_process - Download de processos em PDF
• sei_list_documents - Listagem de documentos
• sei_create_document - Criação de documentos
• sei_sign_document - Assinatura eletrônica
• sei_forward_process - Tramitação de processos
• sei_get_status - Consulta de andamento
• sei_screenshot - Captura de tela
• sei_snapshot - Estado da página (ARIA)

Arquitetura

Claude/Cliente MCP ←→ Servidor MCP ←→ (Playwright) ←→ SEI
                          └→ (WebSocket) ←→ Extensão Chrome ←→ SEI

Driver (Extensão vs Playwright)

Este projeto suporta dois modos de automação:

• extension (padrão): usa a extensão Chrome via WebSocket.
• playwright: usa Playwright diretamente (sem extensão). Ideal quando você quer abrir o SEI e automatizar sem depender do clique “Conectar”.

Para usar Playwright, defina SEI_MCP_DRIVER=playwright.

Instalação

Opção 1: Desktop Extension (Recomendado - Um Clique)

1. Baixe o arquivo sei-mcp.mcpb da Releases
2. No Claude Desktop: Settings > Extensions > Advanced settings
3. Clique em "Install Extension..."
4. Selecione o arquivo sei-mcp.mcpb
5. Pronto!

Opção 2: Instalação Manual

1. Servidor MCP

cd sei-mcp
pnpm install
pnpm build

2. Configurar no Claude Code

Adicione ao ~/.claude.json:

{
  "mcpServers": {
    "sei-mcp": {
      "command": "node",
      "args": ["/caminho/para/sei-mcp/dist/index.js"],
      "env": {
        "SEI_MCP_WS_PORT": "19999"
      }
    }
  }
}

Extensão Chrome (necessária apenas no modo extension)

1. Abra chrome://extensions/
2. Ative "Modo do desenvolvedor"
3. Clique em "Carregar sem compactação"
4. Selecione a pasta extension/

Uso

1. Inicie o Claude Code
2. Abra o SEI no Chrome
3. Clique no ícone da extensão "SEI-MCP Bridge"
4. Clique em "Conectar"
5. Use comandos no Claude Code:

Faça login no SEI com usuário joao.silva e senha 123456

Busque o processo 12345.678901/2024-00

Liste os documentos do processo

Crie um ofício de resposta com o texto: "Em atenção ao solicitado..."

Dicas de navegação (estabilidade)

• Se você tiver mais de uma aba/janela do SEI aberta, use sei_list_sessions e passe session_id nas chamadas para garantir que os comandos vão para a aba certa.
• Para operações lentas (login, busca, download, assinatura), passe timeout_ms (por chamada) ou ajuste o padrão via SEI_MCP_COMMAND_TIMEOUT_MS.
• Se houver cliques “perdidos” por falta de foco, chame sei_focus_window antes do fluxo.
• Se o SEI ainda não estiver aberto no navegador, você pode usar sei_open_url para abrir a URL (não requer extensão; útil antes de conectar).

Desenvolvimento

# Servidor (watch mode)
pnpm dev

# Testar conexão
npx @anthropic-ai/mcp-inspector

# Build
pnpm build

# Criar pacote .mcpb (Desktop Extension)
./scripts/build-mcpb.sh
# Ou manualmente:
npm install -g @anthropic-ai/mcpb
mcpb pack build-mcpb sei-mcp.mcpb

Variáveis de Ambiente

Segurança

• Senhas são transmitidas apenas localmente (localhost)
• Nenhum dado é enviado para servidores externos
• A extensão só funciona em páginas do SEI

Compatibilidade

Testado com:

• SEI versão 4.x
• Chrome 120+
• Node.js 18+

Licença

MIT