Integrações de desenvolvedor

Compartilhe segredos das ferramentas onde o trabalho realmente acontece

PrivateNote é útil como site, mas as equipes de desenvolvedores geralmente precisam da mesma transferência criptografada dentro de editores, agentes locais de IA, scripts e implantações controladas. Esta página mapeia esses pontos de entrada e o limite de confiança por trás deles.

Qual ferramenta usar

Escolha o caminho mais próximo do segredo. Todas as integrações usam o mesmo contrato de criptografia local.

Aplicativo da web

Estável

Cole um segredo, escolha a validade e os limites de leitura e compartilhe o link criptografado em qualquer navegador.

Aplicativo web PrivateNote com editor de notas criptografadas, configurações de validade e botão Share Private Note
Aplicativo web em privatenote.ai — escreva uma nota, personalize a validade, anexe arquivos e compartilhe em qualquer navegador.
Abrir privatenote.ai → colar segredo → compartilhar link criptografado
Como funciona a criptografia

CLI

Estável

Segredos sem rastro no histórico bash, pipes e CI/CD.

$ echo 'sk-live-...' | npx privatenote-cli --expire 1h --output-url-only
https://privatenote.ai/note/a1b2c3d4#…
Envie um segredo para a CLI — criptografia local, stdout imprime apenas uma URL de uso único.
Ver documentação

VS Code & Cursor

Estável

Fluxo diário do desenvolvedor — barra lateral, seleção e área de transferência no editor.

PrivateNote sidebar panel in VS Code or Cursor with title, content, expiry, and burn-after-reading options
Sidebar panel in VS Code or Cursor — compose a note, set expiry and burn-after-reading, then share without leaving the editor.
code --install-extension PrivateNote.privatenote-vscode
Ver documentação

Extensão Chrome

Estável

Criptografe texto selecionado no lugar — menu de contexto, popup e Alt+Shift+P.

PrivateNote Chrome extension popup with title, content, optional password, expiry, and burn-after-reading options
Toolbar popup in Chrome — compose a note, set expiry and burn-after-reading, then share without opening privatenote.ai.
# Right-click selected text → Create PrivateNote
# Shortcut: Alt+Shift+P
Ver documentação

Servidor MCP

Estável

Dê aos agentes de IA uma ferramenta local create_private_note para transferências seguras.

// create_private_note
{ "content": "recovery-code-…", "expiresIn": "1h", "burnAfterReading": true }
https://privatenote.ai/note/a1b2c3d4#…
Agentes chamam create_private_note — o processo MCP criptografa localmente e retorna uma URL compartilhável.
Ver documentação

Plugin Codex

Estável

MCP e skills para OpenAI Codex CLI e IDE.

codex mcp add privatenote -- npx -y privatenote-mcp
Ver documentação

Receitas

Cenários comuns

Comece pela tarefa — escolha a integração que combina com onde o segredo está e como ele precisa ser compartilhado.

CLI

Compartilhar uma chave de API a partir da CI

Envie um segredo do GitHub Actions para a CLI e obtenha uma URL de uso único — sem texto em claro nos logs do workflow.

echo "$API_KEY" | privatenote --output-url-only
Ver documentação
Chrome

Repasse a partir do navegador

Selecione texto no Slack, e-mail ou um ticket e crie um link criptografado sem abrir o privatenote.ai primeiro.

Clique com o botão direito → Create PrivateNote
Ver documentação
MCP

Agente envia um código de recuperação

Deixe um cliente MCP chamar create_private_note com burn-after-reading quando o agente precisar de um repasse seguro.

create_private_note({ burnAfterReading: true })
Ver documentação
VS Code

Compartilhar um token do editor

Destaque variáveis de ambiente, chaves de API ou strings de conexão no VS Code ou Cursor e repasse sem trocar de app — o link vai para a área de transferência.

Clique com o botão direito → Share as PrivateNote
Ver documentação
Codex

Dar ao Codex uma ferramenta de repasse seguro

Registre o servidor MCP uma vez para o Codex criar links criptografados durante fluxos de agente em vez de colar segredos no chat.

codex mcp add privatenote -- npx -y privatenote-mcp
Ver documentação
Web

Enviar para alguém fora da sua stack

Use o app web quando o destinatário só precisa de um link — defina expiração, burn-after-reading e uma senha opcional no navegador.

Criar nota → expiração + senha → copiar link
Ver documentação

Prévia de auto-hospedagem

O que funciona hoje: aponte a CLI e o servidor MCP para sua API com PRIVATENOTE_API_BASE_URL, e a extensão do VS Code com privatenote.apiBaseUrl. Uma prévia Docker Compose (docker-compose.yml) sobe uma stack web + API local para avaliação.

npm run self-host:up

Apenas prévia — não um runtime on-premise em produção. A extensão do Chrome está fixada em privatenote.ai e não pode apontar para uma API auto-hospedada; use CLI, MCP ou VS Code. Implantações enterprise gerenciadas estão no roadmap — entre em contato para feedback antecipado.

Onde cabe

Uma pequena ferramenta para momentos de alto atrito

As equipes de desenvolvedores ainda transmitem senhas de banco de dados, códigos de recuperação, tokens de API, detalhes de transferência de suporte e diagnósticos específicos do cliente. Esses segredos geralmente acabam no histórico de bate-papo, comentários de tickets, threads de pull request ou prompts de IA porque o caminho seguro é muito lento.

PrivateNote destina-se a tornar rápido o caminho mais seguro. A integração deve ser semelhante à criação de um link, enquanto a implementação mantém o texto confidencial criptografado antes de chegar ao servidor.

Modelo de confiança

O mesmo contrato em todos os caminhos

Arquitetura

Criptografar localmente → enviar ciphertext → chave em #fragment

Cada integração segue o mesmo limite. Texto simples nunca sai do seu dispositivo sem criptografia; o servidor nunca recebe a chave de descriptografia.

Criptografar localmente

AES-256-GCM no seu dispositivo — navegador, editor, terminal ou processo MCP.

Enviar ciphertext

Apenas bytes criptografados e metadados da nota (validade, burn-after-reading) chegam ao servidor.

Chave em #fragment

A chave de descriptografia fica no hash da URL. Navegadores não enviam fragmentos em requisições HTTP.

privatenote.ai/note/…#key

  • O texto simples é criptografado localmente antes do upload.

  • O servidor armazena texto cifrado e metadados de notas, não a chave de descriptografia.

  • A chave permanece no fragmento da URL, que não é enviada nas solicitações HTTP.

  • Os limites de leitura e a expiração são impostos pelo serviço de notas.

Todos os caminhos de integração devem preservar o mesmo contrato básico: criar texto cifrado localmente, carregar apenas o que o servidor precisa armazenar e aplicar e, em seguida, compartilhar um link que carregue a chave de descriptografia fora da solicitação.

Como funciona a criptografia

Comece com a integração mais próxima do segredo

Use o aplicativo web para compartilhamento ocasional, a extensão do editor para o trabalho diário, a CLI para scripts e CI, e MCP quando um agente precisar de uma transferência segura.