Getting started
Configuration
Every configuration surface of the Pastepile MCP server: two environment variables, team-shared config files, and self-hosted deployments.
1 min read · Updated
The server is deliberately boring to configure. There are exactly two environment variables, and both are optional:
| Variable | Default | Purpose |
|---|---|---|
PASTEPILE_API | https://pastepile.com | Base URL of the Pastepile deployment to talk to. Point it at staging or a self-hosted instance. |
PASTEPILE_API_KEY | (none) | Enables private memory and per-key limits. Never logged. |
Sharing config with a team
Clients that read project-level MCP config (Claude Code's .mcp.json, Cursor's .cursor/mcp.json, VS Code's .vscode/mcp.json) let you commit the server definition so every teammate gets the tools on clone. Two patterns work:
- Shared anonymous config: commit the server without an
envblock. Everyone gets public-scope tools; individuals add their own key locally when they want private memory. - Per-developer keys: commit the server and let each developer supply
PASTEPILE_API_KEYthrough their client's environment or local config override, keeping keys out of the repo.
Self-hosted and staging deployments
{
"mcpServers": {
"pastepile-staging": {
"command": "npx",
"args": ["-y", "@pastepile/mcp"],
"env": { "PASTEPILE_API": "https://staging.example.com" }
}
}
}Name the server entry after the deployment (pastepile-staging above) so assistants and humans can tell environments apart. You can register the same package twice with different names and URLs.
What there deliberately is not
- No config file of its own: state lives in your Pastepile pastes, not on the machine.
- No telemetry: the server makes exactly the HTTPS requests your tool calls require, nothing else.
- No build step: the npm package ships readable source you can audit in one sitting.
Related documentation
Quick startConnect your AI assistant to Pastepile in under 60 seconds. Copy-paste setup for Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Codex CLI, Continue.dev, Cline, Roo Code, and any MCP client.AuthenticationThe Pastepile MCP server works anonymously, and an API key turns it into a private memory layer with per-key isolation and higher limits.