Home › Docs › Workflow guides

Set up an MCP client

Agent integrations
Workflow

Set up an MCP client

Connect Claude Desktop, Cursor, Windsurf, or MCP Inspector to the hosted /mcp endpoint with OAuth or an API-key Authorization header.

When to use it

Use this when

  • An agent should create, read, list, amend, diff, or delete pastes on your behalf.
  • You want scoped credentials instead of copying paste URLs by hand.
Steps

Do this

  1. Add the endpoint Configure the client with https://pastebin.ca/mcp. Discovery metadata is available under the OAuth well-known URLs.
  2. Authenticate Use the client OAuth flow when supported, or create an account API key and pass it as a Bearer header.
  3. Verify tools Call whoami, then tools/list. Scope failures usually mean the token lacks paste:create, paste:read, paste:list, paste:edit, paste:revoke, or recipient:read.
Examples

Copyable commands

Client config
{
  "mcpServers": {
    "pastebin": {
      "url": "https://pastebin.ca/mcp",
      "headers": { "Authorization": "Bearer pbca_live_..." }
    }
  }
}
Inspector
npx @modelcontextprotocol/inspector
Operational notes

Keep in mind

  • create_paste is plaintext-only in MCP. Use create_encrypted_paste when the client has already encrypted ciphertext locally.
  • OAuth access tokens for MCP are audience-bound to the resource endpoint.