DamnPDFs Codex MCP bridge

Damn PDFs por Sourav Bera

Conecte o Codex ao seu espaço de trabalho aprovado no navegador DamnPDFs. 71 ferramentas de arquivo para PDFs, documentos do Office, imagens e áudio, com operações MCP individuais, importação/exportação local de arquivos e fluxos de trabalho guiados.

Instalar no Codex

Em Plugins → Adicionar → Adicionar um marketplace, insira:

SouravBeraAkaSpeed/damnpdfs-codex-plugin

Escolha Damn PDFs por Sourav Bera e instale. Os comandos CLI equivalentes são:

codex plugin marketplace add SouravBeraAkaSpeed/damnpdfs-codex-plugin --ref main
codex plugin add damnpdfs@damnpdfs

Alternativamente, baixe damnpdfs-1.0.0.zip de Releases e use Adicionar → Enviar arquivo de plugin. Inicie um novo chat no Codex após a instalação para que as habilidades do plugin e as ferramentas MCP sejam carregadas. Node.js 22 ou posterior deve estar disponível como node.

Este é um marketplace público do Codex com suporte a Git. Adicionar esta fonte torna o plugin instalável; isso não significa que ele foi selecionado para o diretório padrão Público/destacado.

Primeiro prompt seguro

Conecte o DamnPDFs a um novo espaço de trabalho vazio no navegador. Mostre o status da conexão e a contagem de ferramentas disponíveis antes de enviar qualquer arquivo.

Abra damnpdfs.com, selecione Acesso do agente, crie um código e faça a vinculação usando connect_browser. Com o controle do navegador disponível, o Codex pode ler o código da aba aprovada. Não é necessária chave de API, verificação de conta da API OpenAI ou arquivo de token persistente. Apenas o código de vinculação temporário é aceito; nunca forneça senha, chave do provedor ou cookie do navegador.

Em seguida, tente:

• “Comprima este PDF para e-mail, compare os tamanhos e salve uma nova cópia.”
• “Converta este PowerPoint para PDF e mescle-o após este documento.”
• “Comprima estas imagens PNG mantendo a transparência.”
• “Inspecione a página dois, substitua esta palavra e verifique o PDF baixado.”

Como funciona

A ponte stdio Node.js sem dependências expõe 71 ferramentas de tarefa, oito operações de espaço de trabalho e cinco auxiliares de conexão/arquivo. Ela encaminha solicitações autorizadas através da mesma ponte de execução do navegador usada pelo DamnPDFs WebMCP. O suporte opcional nativo ao WebMCP não é necessário para este caminho de vinculação HTTPS. A aba do navegador permanece aberta e executa a tarefa; este não é um serviço de automação em nuvem sem supervisão.

As credenciais da sessão permanecem na memória do processo da ponte. Uma sessão dura inicialmente duas horas e pode ser renovada enquanto sua aba vinculada permanecer conectada com a renovação automática habilitada. Revogação ou expiração exige nova vinculação. A retenção de arquivos não se estende com a renovação da sessão.

Permissões e limites de dados

• Leitura: apenas arquivos do espaço de trabalho e caminhos locais exatos selecionados ou aprovados para a tarefa. Não há busca no sistema de arquivos, acesso ao histórico do Codex, acesso a cookies ou importação de arquivos de credenciais.
• Escrita: criar arquivos de saída solicitados com criação exclusiva; arquivos existentes nunca são sobrescritos pelo auxiliar de exportação. Limpeza do espaço de trabalho, cancelamento e revogação são operações destrutivas rotuladas separadamente.
• Rede: apenas https://api.damnpdfs.com; importações locais de arquivos enviam bytes selecionados para armazenamento temporário em nuvem. Uploads somente pelo navegador podem usar o site diretamente. Conversões/compressões nativas usam os trabalhadores temporários existentes em nuvem. IA externa precisa de configurações do provedor inseridas pelo usuário diretamente no site.
• Retenção: cópias de documentos no navegador por no máximo quatro horas; cópias temporárias em nuvem por no máximo uma hora ou limpeza confirmada anteriormente. Downloads salvos pelo usuário permanecem sob controle do usuário. A ponte não adiciona análises, credenciais em disco, visitas agendadas, anúncios ou navegação em segundo plano. A medição do site é descrita em sua política de privacidade.
• Limitações: uma aba conectada é necessária, uma operação é executada por vez, os originais são preservados, texto escaneado pode precisar de OCR, fontes ausentes podem afetar conversões do Office, e uma assinatura visível em PDF não é assinatura certificada. Verifique as saídas e avisos reais.

Mais detalhes: guia de instalação do site, configuração do plugin, privacidade, termos, ajuda/contato, guias de ferramentas.

Avaliação do diretório

O Dockerfile raiz fornece um ponto de entrada stdio Node.js 22 sem root para introspecção MCP. Ele contém apenas a ponte pública e o catálogo; nenhuma credencial, fixture de documento ou código-fonte do produto está incluído. Compile com docker build -t damnpdfs-mcp-test . e execute node scripts/verify-container.mjs para verificar a inicialização sem rede, armazenamento somente leitura e capacidades removidas. CI realiza essa verificação no Linux. Tarefas reais de documentos ainda exigem um espaço de trabalho aprovado conectado no navegador e acesso à rede; a verificação da lista de ferramentas de um avaliador não certifica todas as operações de documentos.

Inspecionar, testar e atualizar

Nenhuma instalação de dependência é necessária para o plugin ou testes:

node --test tests/*.test.mjs
node scripts/validate.mjs
node scripts/pack.mjs

catalog_check verifica desvios de esquema público sem enviar documentos. codex plugin marketplace upgrade damnpdfs atualiza a fonte; reinstale com codex plugin add damnpdfs@damnpdfs, depois use um novo chat. Relate problemas sem anexar documentos privados, credenciais ou códigos de vinculação.

A licença MIT cobre este pacote de plugin, não uma transferência de propriedade de documentos do usuário ou do serviço hospedado. Integração independente por Sourav Bera; nenhuma alegação de endosso da OpenAI.