Internal reference · MCP server

Paperfly MCP Server

To authenticate your connection, the Paperfly MCP server requires three exact headers containing your user credentials and API key on every request.

mcp.paperfly.io/mcp Streamable HTTP · header auth

The 3 Required Headers

Every call to the server must include the following headers. The server uses these behind the scenes to authenticate sessions dynamically under your account:

required headers

X-Paperfly-Username: your-username
X-Paperfly-Password: your-password
X-Paperfly-Api-Key: your-api-key

Be sure to use the exact casing and hyphenation shown above.

Quick Testing with MCP Inspector

Use the official MCP Inspector to test your connection and explore tools instantly.

1. Fire up the inspector

terminal

npx @modelcontextprotocol/inspector

2. Fill in the connection settings

Transport TypeSet this to streamable-http.
URLSet to https://mcp.paperfly.io/mcp
AuthenticationAdd three header key-value pairs (X-Paperfly-Username, X-Paperfly-Password, and X-Paperfly-Api-Key).

Click Connect to initialize the session.

Setup — Claude Desktop

Because Claude Desktop doesn't natively accept custom headers on remote URLs, use mcp-remote via npx to handle the headers locally.

1. Open your config file

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the server entry

claude_desktop_config.json

{
  "mcpServers": {
    "Paperfly MCP": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.paperfly.io/mcp",
        "--header",
        "X-Paperfly-Username: your-username",
        "--header",
        "X-Paperfly-Password: your-password",
        "--header",
        "X-Paperfly-Api-Key: your-api-key"
      ]
    }
  }
}

Security Reminder Your password sits in plaintext inside this configuration file. Protect it like an active credentials file—avoid committing it to version control or sharing it.

3. Fully restart Claude Desktop

A simple reload of the window won't load the new server config. Quit the app completely from your menu bar or system tray, then launch it again.

Setup — VS Code

Most AI coding extensions in VS Code run MCP configurations locally. Just like Claude Desktop, you must bridge the connection via mcp-remote.

1. Setup your workspace

Create a .vscode folder in your project root if it doesn't exist, and create a mcp.json file inside it.

2. Add the configuration

.vscode/mcp.json

{
  "servers": {
    "Paperfly MCP": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.paperfly.io/mcp",
        "--header",
        "X-Paperfly-Username: your-username",
        "--header",
        "X-Paperfly-Password: your-password",
        "--header",
        "X-Paperfly-Api-Key: your-api-key"
      ]
    }
  },
  "inputs": []
}

Replace the three highlighted values with your credentials. Keep this file private as it stores your password in plain text.