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

Variável	Descrição	Padrão
PORT	Porta HTTP (Render/Cloud)	(vazio)
SEI_MCP_WS_PORT	Porta do WebSocket	19999
SEI_MCP_COMMAND_TIMEOUT_MS	Timeout padrão de comandos enviados à extensão	30000
SEI_MCP_LOG_LEVEL	Nível de log (debug/info/warn/error)	info
SEI_MCP_DRIVER	extension ou playwright	extension
SEI_MCP_PW_HEADLESS	Playwright headless (1/0)	1
SEI_MCP_PW_PERSISTENT	Manter perfil (1/0)	1
SEI_MCP_PW_CHANNEL	Canal do navegador (ex: chrome)	(vazio)
SEI_MCP_REQUIRE_AUTH	Exigir auth no HTTP (true/false)	true
SEI_MCP_BEARER_TOKEN	Token estático (Authorization Bearer)	(vazio)
SEI_MCP_LICENSING_API_URL	Base URL do servidor de licenciamento (valida token/mede uso)	https://sei-tribunais-licensing-api.onrender.com/api/v1
SEI_MCP_JWT_SECRET	Segredo JWT para login Google	(vazio)
SEI_MCP_PUBLIC_BASE_URL	Base URL pública do servidor HTTP	http://localhost:3100
SEI_MCP_GOOGLE_CLIENT_ID	Google OAuth Client ID	(vazio)
SEI_MCP_GOOGLE_CLIENT_SECRET	Google OAuth Client Secret	(vazio)
SEI_MCP_STRIPE_SECRET_KEY	Stripe Secret Key	(vazio)
SEI_MCP_STRIPE_PRICE_STARTER_MONTHLY	Stripe Price ID Starter	(vazio)
SEI_MCP_STRIPE_PRICE_PRO_MONTHLY	Stripe Price ID Pro	(vazio)

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