Secret Paste
БесплатноНе проверенMCP server that lets an agent request a secret from the user without the value entering the conversation.
Описание
MCP server that lets an agent request a secret from the user without the value entering the conversation.
README
An MCP server that lets an agent request an API key or other secret from you without you pasting it into the chat. The value never passes through the conversation, a tool argument, or a tool result. "pbcopy for agents."
The agent calls request_secret. A native password dialog pops up (pinentry,
zenity, kdialog, or a macOS dialog), you type the value, and it goes straight
to .env, your OS keychain, or 1Password. No browser tab, no "save this
password?" nag. If no dialog tool is available, a local browser page is used
instead. The agent only ever sees { name, target, stored }.
This keeps the secret out of the request path, not out of the agent's reach.
Once stored, an agent with shell access can still read it (cat .env,
secret-tool lookup, op item get), and anything it reads lands in the
transcript. Pair this with permission rules that deny reading .env or running
those commands if that matters to you.
Install
cd /path/to/secret-paste
npm install && npm run build
claude mcp add --scope user secret-paste -- node /path/to/secret-paste/dist/server.js
Restart Claude Code (or run /mcp) and confirm secret-paste is connected.
Tool
request_secret({ name, target?, description? })
| field | notes |
|---|---|
name |
required, must match ^[A-Z_][A-Z0-9_]*$ |
target |
env (default), keychain, or op |
description |
optional, shown on the page |
Result on success: { "name": "...", "target": "...", "stored": true, "path"?: "...", "readHint": "...", "via": "<backend>" }.
Result otherwise: { "stored": false, "reason": "cancelled" | "timeout" | "<error>", "via": "<backend>" }.
via is one of pinentry, pinentry-mac, zenity, kdialog, osascript,
elicitation (browser page opened through the client), or browser
(browser page opened with xdg-open / open).
The value, its length, a prefix, or a hash is never returned, logged, or echoed.
Targets
env: upsertsNAME=valueinto.envin the server's working directory (the directory Claude Code was started in). Other lines are preserved, an existing line for that name is replaced, the file is created with mode 0600 if missing, and.envis appended to.gitignorewhen the directory is a git repo. Values are written unquoted when possible, otherwise wrapped in',`, or"(whichever the value doesn't contain) so dotenv and Node'sprocess.loadEnvFileread them back verbatim. Values that can't be quoted losslessly are rejected with a hint to usekeychainorop.keychain: macOSsecurity add-generic-password(fed over stdin viasecurity -i, so the value never appears inps), or Linuxsecret-tool store(requireslibsecret-tools).op:op item createwith a JSON item template on stdin (1Password CLI), saved to your default vault. Read it back withop item get NAME --fields label=password --reveal.
How it works
Native dialog (default)
Backends are tried in order until one is available:
| platform | order |
|---|---|
| Linux | pinentry, zenity, kdialog, browser |
| macOS | pinentry-mac, pinentry, osascript, browser |
| Windows | browser |
pinentryis GnuPG's passphrase prompter and the preferred backend. It holds the value in locked memory, draws a native dialog (GNOME/GCR, Qt, GTK, or macOS depending on the installed flavour), and enforces the timeout itself. The server speaks the Assuan protocol to it over stdin/stdout and decodes theDresponse at the byte level. Terminal-only flavours (curses,tty) are skipped because the server has no terminal to give them.SETKEYINFOis deliberately not sent, so pinentry never offers to cache the value in your keyring.zenity --passwordandkdialog --passwordprint the value to stdout, which the server reads as bytes and zeroes after storing.osascriptruns adisplay dialog ... with hidden answerAppleScript.
Set SECRET_PASTE_PROMPT to override the order, e.g. zenity,browser or
browser to force the old behaviour:
claude mcp add --scope user -e SECRET_PASTE_PROMPT=browser secret-paste -- node /path/to/secret-paste/dist/server.js
Dialogs are spawned detached from the server's process group and killed on timeout or when the tool call is aborted.
Browser fallback
- A one-shot HTTP server starts on
127.0.0.1on a random port with a random nonce in the path. Requests with the wrong nonce, Host, or Origin are rejected. - The URL is handed to Claude Code via MCP URL-mode elicitation, which shows a
native "open this link?" prompt. If the client doesn't support that, the
server falls back to
xdg-open/open. - The page is static HTML with no JavaScript and
Cache-Control: no-store. - On submit, the value is parsed at the byte level into a
Buffer, written to the target, then zeroed. It is never held as a JavaScript string. - The server shuts down after one submit or cancel, or after 5 minutes.
The tool is tagged _meta["anthropic/requiresUserInteraction"] = true, so
Claude Code prompts for permission on every call, even in auto-accept modes.
How to use it (for Claude)
When you need a credential, call request_secret({ name: "SERVICE_API_KEY" })
and then reference it as process.env.SERVICE_API_KEY (or the readHint in
the result). Never ask the user to paste a secret into chat.
Development
npm test # unit tests: .env upsert, form decoding, dialog backends via fake binaries (node --test)
npm run build # tsc -> dist/
Установить Secret Paste в Claude Desktop, Claude Code, Cursor
unyly install secret-pasteСтавит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.
Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh
Или настроить вручную
Выполни в терминале:
claude mcp add secret-paste -- npx -y github:douglasjordan2/secret-pasteПошаговые гайды: как установить Secret Paste
FAQ
Secret Paste MCP бесплатный?
Да, Secret Paste MCP бесплатный — установка в пару кликов через Unyly без оплаты.
Нужен ли API-ключ для Secret Paste?
Нет, Secret Paste работает без API-ключей и переменных окружения.
Secret Paste — hosted или self-hosted?
Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.
Как установить Secret Paste в Claude Desktop, Claude Code или Cursor?
Открой Secret Paste на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.
Похожие MCP
GitHub
PRs, issues, code search, CI status
автор: GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
автор: mcpdotdirectServer Sequential Thinking
MCP server for sequential thinking and problem solving
автор: GitHub ActionsUnyly Deploy
Deploy sites and MCP servers to Unyly straight from your AI agent
автор: UnylyAmap Maps Mcp Server
MCP server for using the AMap Maps API
автор: duxiaohuiPayMCP
Lightweight payments layer for MCP servers: turn tools into paid endpoints with a two-line decorator. [PyPI](https://pypi.org/project/paymcp/) · [npm](https://w
автор: blustAIServer For Power BI
Enables exploring Microsoft Fabric / Power BI workspaces and semantic models, and executing ad-hoc DAX queries.
автор: Mitsubishi-FusoGpt Image 2 Mcp
RunAPI GPT Image 2 MCP server for image generation: create tasks, poll results, and check pricing across 1 model from Claude Code, Codex, Cursor, and VS Code.
автор: runapi-aiCompare Secret Paste with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории development
