vnsh

You can use vnsh as a compact, zero-access MCP server to securely handle ephemeral AI context data. It lets you pipe logs, diffs, and images into encrypted, self-destructing links that the server cannot read or retain, enabling easy integration with Claude Code and CI workflows without exposing sensitive content.

How to use

You configure and run vnsh as an MCP server to enable Claude Code and other MCP clients to read and manage secret, ephemeral data. The server operates in two primary modes: a remote HTTP MCP URL you point your client at, or a local MCP process you launch directly from your development environment. In practice, you typically either deploy the MCP endpoint and use its URL, or start a local MCP process that your client can talk to.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system.

Set up the MCP server integration for Claude Code using the provided MCP configuration. Create a file named .mcp.json in your project root with the following content.

{
  "mcpServers": {
    "vnsh": {
      "command": "npx",
      "args": ["-y", "vnsh-mcp"]
    }
  }
}

Additional setup and usage notes

Restart Claude Code after adding the MCP configuration. With this in place, Claude can automatically read vnsh links when you paste them and you can share large outputs through the vnsh_mcp integration.

Self-hosting and running locally

If you want to run a local MCP server instance that your client can connect to, use the standard CLI flow described in the Quick Start. The MCP integration for Claude is designed to read vnsh links directly from your terminal and to surface secure, ephemeral data without exposing the content.

Security and usage tips

Always use HTTPS when accessing MCP endpoints. Do not share full URLs in public channels, since the decryption material is stored in the URL fragment and only the encrypted blob is sent to the server. For maximum security, run vnsh self-hosted with your own Cloudflare Workers and R2 storage.

Troubleshooting

If Claude Code does not read vnsh links automatically after adding .mcp.json, restart the editor and re-open the project to ensure the MCP configuration is recognized.

Available tools

upload_to_vnsh_action

GitHub Action that uploads CI logs to vnsh and posts a secure link to the PR.

vnsh_mcp_read

MCP tool that enables Claude Code to automatically read vnsh links when pasted in the terminal.

vnsh_share_tool

Tool to share large outputs via vnsh_share within Claude or related MCP environments.

vnsh_api_endpoints

API endpoints for uploading and retrieving encrypted blobs via the MCP server.