Autor de Texto Seguro — MCP para ChatGPT e Claude

Este projeto implementa um servidor Model Context Protocol (MCP) para conectar ferramentas de revisão autoral e privacidade documental a clientes compatíveis, incluindo Claude e ChatGPT. O servidor não usa um modelo de IA externo, não persiste o texto recebido e não tenta determinar ou ocultar a origem de um texto.

Limite importante: este MCP não implementa evasão de detectores, falsificação de autoria, remoção de supostos “hashes de IA” ou promessa de indetectabilidade. Detectores fazem inferências probabilísticas e arquivos simples não possuem um hash universal de IA que possa ser apagado. A ferramenta de metadados remove apenas propriedades internas do arquivo, não registros externos, logs, histórico de serviços ou inferências estilísticas.

Ferramentas disponíveis

A comparação de estilo serve para ajudar o autor a revisar consistência e adequação da própria voz. Ela não fornece probabilidade de autoria humana, classificação de texto como “humano” ou “IA”, nem garantia de resultado perante qualquer detector.

Related MCP server: docx-mcp

Instalação

Use Python 3.10 ou superior. Em um ambiente virtual recomendado, execute:

python3 -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt

Para conferir a instalação:

python3 -m py_compile server.py
pytest -q

Execução local por stdio

O transporte stdio é adequado para clientes que iniciam o processo localmente, como o Claude Desktop. No arquivo de configuração do cliente, utilize o caminho absoluto do Python e do servidor:

{
  "mcpServers": {
    "autor-texto-seguro": {
      "command": "/caminho/absoluto/autor-texto-mcp/.venv/bin/python",
      "args": [
        "/caminho/absoluto/autor-texto-mcp/server.py",
        "--transport",
        "stdio"
      ]
    }
  }
}

Depois de salvar a configuração, reinicie o cliente e confirme se as quatro ferramentas aparecem. Consulte a documentação do seu cliente para o caminho exato do arquivo de configuração.

Execução remota para ChatGPT e Claude

Para um único endpoint atender os dois ecossistemas, este projeto usa Streamable HTTP no caminho /mcp. O padrão MCP define stdio para subprocessos locais e Streamable HTTP para servidores independentes acessíveis por HTTP.1

Inicie o servidor com um token forte:

export MCP_BEARER_TOKEN='substitua-por-um-token-longo-e-aleatorio'
python3 server.py --transport streamable-http --host 0.0.0.0 --port 8000

Em produção, coloque o processo atrás de HTTPS, por exemplo, com um proxy reverso ou uma plataforma de hospedagem. Não exponha o endpoint HTTP sem autenticação. O endereço que será informado aos clientes terá este formato:

https://seu-dominio.example/mcp

O token deve ser enviado como Authorization: Bearer <token>. Não coloque o token em um repositório público, em uma mensagem compartilhada ou no código-fonte.

ChatGPT

O ChatGPT conecta-se a servidores MCP remotos. Em contas e workspaces que tenham Developer Mode e custom MCP apps disponíveis, o administrador ou usuário autorizado pode abrir as configurações de Apps, criar um app personalizado, informar o endpoint HTTPS, selecionar o mecanismo de autenticação Bearer e escanear as ferramentas. A disponibilidade depende do plano e das permissões do workspace; a documentação oficial informa que a conexão direta com servidores locais não é feita sem um túnel seguro.2

Após a criação, habilite somente as ferramentas necessárias e teste primeiro analisar_estilo e revisar_texto. A documentação oficial recomenda validar servidores personalizados, especialmente quando possuem ações que modificam dados; este projeto é somente de processamento do conteúdo enviado e não possui ferramentas de escrita em sistemas externos.2

Claude

Para o Claude API, o MCP Connector aceita um servidor remoto por URL e permite configurar um token Bearer. A configuração deve usar o endpoint /mcp e habilitar o conjunto de ferramentas desejado. Exemplo conceitual, conforme a estrutura documentada pela Anthropic:3

{
  "mcp_servers": [
    {
      "type": "url",
      "url": "https://seu-dominio.example/mcp",
      "name": "autor-texto-seguro",
      "authorization_token": "SEU_TOKEN"
    }
  ],
  "tools": [
    {
      "type": "mcp_toolset",
      "mcp_server_name": "autor-texto-seguro"
    }
  ]
}

O Claude Desktop também pode usar o modo local stdio, quando o próprio aplicativo iniciar o processo. Para a API do Claude, a documentação informa que o servidor precisa estar publicamente acessível por HTTP; servidores locais stdio não são conectados diretamente por esse recurso.3

Segurança e privacidade

O servidor processa os dados na memória durante a chamada e não possui código para gravar textos em banco de dados ou enviá-los a outro modelo. Ainda assim, o operador da infraestrutura deve proteger logs do proxy, métricas, backups e arquivos temporários. Em produção, use HTTPS, token longo e aleatório, limites de tamanho, controle de acesso e rotação de credenciais.

A ferramenta de limpeza recebe arquivos em Base64. Para PDFs, a reconstrução pode não preservar certos recursos avançados e pode invalidar assinaturas digitais; por isso, mantenha o arquivo original e valide o resultado antes de usá-lo. Para DOCX, são removidas propriedades comuns do docProps/core.xml. Para TXT, MD, CSV e JSON, o conteúdo é devolvido sem alteração porque esses formatos não têm, em regra, propriedades internas equivalentes às de DOCX/PDF.

Validação

A suíte local contém cinco testes automatizados:

5 passed

Também foi validada uma chamada real ao endpoint Streamable HTTP, com autenticação Bearer, descoberta das quatro ferramentas e execução de analisar_estilo.

Estrutura

autor-texto-mcp/
├── server.py
├── requirements.txt
├── README.md
├── integration_check.py
└── tests/
    ├── conftest.py
    └── test_server.py

Referências