mcp-seipro

MCP Server do [SEI Pro](https://sei-pro.github.io/sei-pro/) para o SEI (Sistema Eletrônico de Informações) via API REST mod-wssei v2 + scraper do frontend web (modo híbrido).

116 tools para gerenciar processos, documentos, tramitação, assinatura, blocos, marcadores, acompanhamento, credenciamento, modelos e mais em qualquer instância do SEI. Cobertura completa da API mod-wssei v2 oficial (pengovbr/mod-wssei) mais um scraper HTTP do frontend web que dá ganhos de até 23× em operações de listagem (sei_listar_processos cai de ~14 s para ~600 ms warm).

Instalação

Opção 1: Claude Desktop (extensão com um clique)

Baixe o arquivo seipro.mcpb e abra com duplo-clique. O Claude Desktop instala automaticamente e pede suas credenciais.

Opção 2: PyPI (pip)

pip install mcp-seipro

Opção 3: Instalador interativo

git clone https://github.com/sei-pro/mcp-seipro.git
cd mcp-seipro
python3 setup_claude.py

O script pergunta suas credenciais, instala o pacote e configura o Claude Desktop automaticamente.

Configuração

Variáveis de ambiente

Dica: como obter `SEI_URL` e `SEI_ORGAO` direto pelo SEI

>

Na barra lateral do SEI (menu à esquerda), role até o final — você verá um QR Code para o aplicativo móvel. Esse QR Code contém um link com todas as informações necessárias:

>

`` https://sei.orgao.gov.br/sei/modulos/wssei/controlador_ws.php/api/v2;siglaorgao: ORGAO;orgao: 0;contexto: ``

>

- `SEI_URL` — a URL antes do ; (ex: https://sei.orgao.gov.br/sei/modulos/wssei/controlador_ws.php/api/v2) - `SEI_ORGAO` — o valor após orgao: (ex: 0)

>

Você pode escanear o QR Code com a câmera do celular para copiar o link, ou simplesmente anotar os dados a partir do menu.

Registro no Claude Code

Adicione ao .mcp.json do projeto ou ~/.claude.json (global):

{
  "mcpServers": {
    "seipro": {
      "command": "mcp-seipro",
      "env": {
        "SEI_URL": "https://sei.orgao.gov.br/sei/modulos/wssei/controlador_ws.php/api/v2",
        "SEI_USUARIO": "seu.usuario",
        "SEI_SENHA": "sua-senha",
        "SEI_ORGAO": "0"
      }
    }
  }
}

Registro no Claude Desktop (manual)

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "seipro": {
      "command": "mcp-seipro",
      "env": {
        "SEI_URL": "https://sei.orgao.gov.br/sei/modulos/wssei/controlador_ws.php/api/v2",
        "SEI_USUARIO": "seu.usuario",
        "SEI_SENHA": "sua-senha",
        "SEI_ORGAO": "0"
      }
    }
  }
}

Exemplos de uso

Com o MCP SEI Pro configurado, basta conversar com o Claude em linguagem natural:

Consultas

• "O que diz o processo 50300.018905/2018-67?"
• "Leia o documento SEI 2843449 e me faça um resumo"
• "Qual foi o último andamento do processo de Auditoria TCU que está na unidade GPF?"
• "Liste para mim os processos da caixa GPF no SEI"
• "Quais processos estão atribuídos a mim na unidade SFC?"

Ações

• "Crie um despacho no processo 50300.001234/2024-01 aprovando o pedido"
• "Tramite o processo 50300.005678/2024-02 para a unidade SFC com prazo de 5 dias"
• "Assine todos os documentos do bloco de assinatura 'Contratos Março'"
• "Marque o processo como acompanhamento especial com o grupo 'Urgentes'"
• "Crie um marcador vermelho chamado 'Pendente Resposta' e aplique no processo"

Análise

• "Me dê um resumo dos processos da minha caixa agrupados por tipo"
• "Quais processos da unidade GPF estão sem movimentação há mais de 30 dias?"
• "Compare o conteúdo dos documentos 2843449 e 2843450"

Tools disponíveis (116)

Sistema e metadados (3)

Navegação e contexto (7)

Processos — consulta (11)

Processos — gestão (13)

Processos — assuntos (2)

Processos sigilosos — credenciamento (4)

Documentos — leitura (8)

Documentos — escrita (10)

Documentos — tipos e modelos (7)

Assinantes (2)

Ciência e andamento (3)

Anotação e observação (2)

Contatos (2)

Marcador (8)

Acompanhamento especial (8)

Bloco interno (10)

Bloco de assinatura (16)

Compatibilidade com versões do SEI

Todos os 116 endpoints funcionam desde o mod-wssei 2.0.0 (SEI 4.0.x), exceto um:

Tabela de compatibilidade SEI ↔ mod-wssei:

Se algum endpoint falhar com erro inesperado, use sei_versao para verificar a versão do mod-wssei instalada na sua instância do SEI.

Nota: a API mod-wssei v2 não expõe endpoint para cancelar assinatura de documentos em nenhuma versão (verificado até v3.0.2). A função existe no core do SEI (DocumentoRN::cancelarAssinaturaInternoControlado) mas não está exposta via REST. O sei_cancelar_assinatura usa o workaround de forçar uma edição mínima no documento.

Arquitetura híbrida REST + Web scraper

A maioria das tools usa a REST mod-wssei v2 (estável, oficial, disponível desde SEI 4.0.x). Mas duas operações críticas para latência ganham com um caminho alternativo via scraping HTTP do frontend web do SEI:

O scraper:

• Mantém uma sessão SIP autenticada persistente (login custa ~3 s, uma vez por conexão MCP).
• Reaproveita o infra_hash capturado da cadeia de redirects pós-login (válido enquanto a sessão SIP viver).
• Cacheia o action e os hidden fields do form principal de procedimento_controlar para POSTs subsequentes.
• Re-loga automaticamente se detectar que a sessão expirou.
• Funciona com qualquer instância SEI 4.0+/5.0+ que use o módulo Infra v1.5x+ (a maioria das instalações modernas).

A REST mod-wssei continua sendo o caminho padrão para todas as outras operações e o fallback se o scraper falhar (ex: CAPTCHA após muitas tentativas, 2FA habilitado, mudança de layout no SEI). O método REST de listar_processos permanece disponível em SEIClient.listar_processos — não exposto como tool MCP, mas usado internamente pelo sei_resumo_processos (que precisa dos flags estruturados de status).

Funcionalidades

Resolução automática

Leitura universal de documentos

• Internos (HTML) → Markdown (tabelas limpas, sem colunas vazias)
• PDFs com texto → Markdown via pdfplumber
• PDFs escaneados → Markdown via OCR (tesseract, limite 20 páginas)

Estilos CSS do SEI

Despachos: Paragrafo_Numerado_Nivel1 (corpo), âncora SEI no destinatário

Notas Técnicas: Item_Nivel1/2/3/4 (H1/H2/H3/H4), Item_Alinea_Letra (a, b, c), Item_Inciso_Romano (I, II, III)

Regra: toda numeração usa classes CSS, nunca texto manual.

Privacidade e dados restritos

O SEI classifica processos e documentos em três níveis: público (nivelAcesso=0), restrito (1) e sigiloso (2). O MCP usa as credenciais do usuário, então acessa o que o usuário enxergaria no SEI — incluindo restritos. Sigilosos exigem credenciamento prévio no próprio SEI.

Como conteúdo restrito pode trafegar para um provedor LLM (que talvez logue, retenha ou treine modelos com ele), o MCP impõe um gate de consentimento nas duas tools que entregam conteúdo bruto:

• sei_ler_documento — markdown/texto/HTML do documento
• sei_baixar_anexo — base64 do arquivo

Comportamento padrão (mais seguro): se o documento tem nivelAcesso 1 ou 2 e a chamada não trouxe confirmar_acesso_restrito=true, o MCP responde com um JSON estruturado em pt-BR (consentimento_necessario=true, lista de riscos[] cobrindo LGPD/LAI/treinamento de modelos/sigilo funcional, e como_liberar). O conteúdo bruto não é entregue.

Existem duas formas de liberar:

Em ambos os casos, o conteúdo entregue vem com um disclaimer prefixado lembrando o nível de acesso, a hipótese legal e os riscos.

As demais tools (sei_consultar_processo, sei_consultar_documento_externo, etc.) não bloqueiam metadados — apenas anexam um campo _aviso_acesso quando detectam restrição, para o LLM repassar a informação ao usuário.

O gate trata restrito e sigiloso de forma idêntica. Sigiloso já tem proteção adicional do SEI (credenciamento). Se quiser regras diferentes, abra um issue.

Por que não há um modal nativo de autorização?

O MCP define o protocolo elicitInput justamente para isso — o servidor pede input estruturado e o cliente renderiza UI nativa. O servidor SEI Pro implementa esse caminho desde v0.3.7: quando o cliente declara a capability, o gate aparece como modal/formulário no cliente, fora do alcance do modelo.

Hoje, no entanto, os clientes Anthropic conectados via Streamable HTTP (mcp.seipro.io no claude.ai/Claude Desktop com servidor remoto) não declaram a capability nem respondem aos requests de elicit. O servidor detecta isso e cai no JSON gate textual, que continua sendo a barreira efetiva. Quando esse suporte for ativado nos clientes Anthropic, o caminho de elicit começa a funcionar automaticamente — nada precisa mudar no servidor.

O fluxo "sem elicit" (atual): modelo recebe JSON estruturado de bloqueio → traduz os riscos ao usuário em texto → usuário digita autorização explícita → modelo passa confirmar_acesso_restrito=true na próxima chamada. Funciona bem com modelos grandes (Opus 4.7) e, com as docstrings + instrucao_para_modelo + nao_e_erro_tecnico introduzidos nas versões 0.3.5–0.3.7, também com modelos menores (Haiku 4.5).

Deploy remoto (Railway)

O servidor pode rodar em modo HTTP para uso via Claude no celular, na web ou em qualquer cliente MCP remoto. Cada órgão faz seu próprio deploy — as credenciais do SEI são informadas pelo usuário na tela de login OAuth e nunca ficam armazenadas no servidor.

O que é o Railway

O Railway é uma plataforma de deploy na nuvem que facilita colocar aplicações no ar. Você faz push do código e o Railway cuida de build, domínio, SSL e escalabilidade.

1. Criar conta no Railway

1. Acesse railway.com e clique em Sign Up
2. Faça login com GitHub, GitLab ou e-mail
3. Confirme seu e-mail

2. Instalar o Railway CLI

macOS (Homebrew):

brew install railway

npm (qualquer plataforma):

npm install -g @railway/cli

Verificar instalação:

railway --version

3. Autenticar no terminal

railway login

Isso abre o navegador para você autorizar o CLI na sua conta Railway.

4. Clonar o repositório

git clone https://github.com/sei-pro/mcp-seipro.git
cd mcp-seipro

5. Criar o projeto no Railway

railway init -n mcp-seipro

Se você tiver mais de um workspace, adicione --workspace "Nome do Workspace".

6. Criar o serviço

railway add --service mcp-seipro

7. Configurar variáveis de ambiente

O servidor precisa de duas variáveis obrigatórias:

railway variables set \
  JWT_SECRET="$(openssl rand -base64 48)" \
  BASE_URL="https://SEU-PROJETO.up.railway.app"

• `JWT_SECRET` — chave para encriptar os tokens OAuth (gerada automaticamente pelo comando acima)
• `BASE_URL` — URL pública do seu servidor (será definida no passo 9)

Nota: as credenciais do SEI (URL, usuário, senha) não ficam no servidor. São informadas pelo usuário na tela de login OAuth e encriptadas dentro do token.

8. Gerar domínio público

railway domain

Isso gera uma URL como https://mcp-seipro-production.up.railway.app. Copie essa URL.

Agora atualize a variável BASE_URL com a URL gerada:

railway variables set BASE_URL="https://mcp-seipro-production.up.railway.app"

9. Fazer o deploy

railway up

Aguarde o build finalizar (2-3 minutos na primeira vez). Ao terminar, verifique:

# Deve retornar HTTP 401 (protegido por OAuth)
curl -s -o /dev/null -w "%{http_code}" -X POST https://SEU-PROJETO.up.railway.app/mcp

Se retornar 401, o servidor está rodando com autenticação ativa.

10. Conectar no Claude

1. Acesse claude.ai → Settings → Connectors
2. Clique em Adicionar conector personalizado
3. Cole a URL do seu servidor: https://SEU-PROJETO.up.railway.app/mcp
4. O Claude vai abrir a tela de login do SEI Pro
5. Preencha a URL da API do SEI, usuário e senha do seu órgão
6. Clique em Conectar

Pronto! A configuração sincroniza automaticamente com o app mobile e a web.

Como funciona

O servidor detecta automaticamente o ambiente:

No modo remoto, as credenciais do SEI são encriptadas dentro do token JWT e nunca armazenadas no servidor. O Dockerfile inclui tesseract-ocr para OCR de PDFs escaneados.

Domínio customizado (opcional)

railway domain --custom mcp.seu-orgao.gov.br

Configure um registro CNAME no DNS do seu órgão apontando para o valor fornecido pelo Railway. O certificado SSL é provisionado automaticamente.

Lembre-se de atualizar a variável BASE_URL:

railway variables set BASE_URL="https://mcp.seu-orgao.gov.br"
railway up

Atualizar o servidor

Para atualizar com novas versões do mcp-seipro:

git pull
railway up

Requisitos de sistema

• Python >= 3.11
• Qualquer instância do SEI com módulo mod-wssei v2
• Claude Code, Claude Desktop, ou qualquer cliente MCP

Para OCR de PDFs escaneados (opcional):

• tesseract-ocr e tesseract-ocr-por
• poppler-utils

Links

• SEI Pro — Extensão de navegador para o SEI
• PyPI
• Repositório
• Railway — Plataforma de deploy na nuvem

Licença

MIT