Model Context Protocol

サーバーURL

MCPクライアントを次のURLに向けてください:

https://pastebin.ca/mcp

ディスカバリードキュメント (クライアント設定不要):

• /.well-known/oauth-protected-resource/mcp — Protected Resource Metadata (RFC 9728)
• /.well-known/oauth-authorization-server — Authorization Server Metadata (RFC 8414)

Claude Desktop

次のファイルを編集します: ~/Library/Application Support/Claude/claude_desktop_config.json (またはLinuxでは ~/.config/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "pastebin": {
      "url": "https://pastebin.ca/mcp"
    }
  }
}

初回利用時、Claudeはブラウザタブを開き、パスキーでサインインして要求されたスコープを承認します。トークンはローカルに保存され、サーバーは各MCP呼び出しでBearerのみを参照します。

Cursor / Windsurf

次のファイルを編集します: ~/.cursor/mcp.json:

{
  "mcpServers": {
    "pastebin": { "url": "https://pastebin.ca/mcp" }
  }
}

MCP Inspector

公式インスペクターをライブURLに対して起動します:

npx @modelcontextprotocol/inspector

サーバーURLとしてhttps://pastebin.ca/mcpを入力し、求められたらOAuthを選択してください。

手動APIキー設定

クライアントがOAuthに対応していない場合は、Bearerヘッダーを直接渡してください:

{
  "mcpServers": {
    "pastebin": {
      "url": "https://pastebin.ca/mcp",
      "headers": { "Authorization": "Bearer pbca_live_…" }
    }
  }
}

MCPクライアントができること

tools/listを使用すると全体のサーフェスを探索できます — 各ツールにはinputSchema、outputSchema、人間が読める説明が含まれます。現在のインベントリ:

• create_paste — プレーンテキストのペーストを作成します。本文はUTF-8テキスト(body)またはbase64エンコードされたUTF-8バイト(body_b64)として送信できます。
• get_paste — 自分のペーストまたは任意の公開ペーストを取得します。body_format=base64は安全な転送のために生バイトをbody_b64として返します。
• get_encrypted_paste — 暗号化ペーストの暗号文と暗号メタデータを取得します。復号化はバンド外で行います。
• list_my_pastes — 不透明なnext_cursorを使用して、自分のペーストをページングします。
• amend_paste — ペースト系列に新しいバージョンを追加します。titleとchange_noteはオプションです。
• update_visibility — プレーンテキストペーストをpublicとunlistedの間で切り替えます(暗号化ペーストとバーンアフターリードペーストは変更できません)。
• delete_paste — 自分のペーストをソフト削除します。

受信者フロー(受信者の受信箱への送信と読み取り)は、サーバーがシール中に短時間プレーンテキストを保持するため、意図的にMCPに公開されていません — これらにはREST APIを使用してください。

paste://リソースURI

MCPのリソース機能により、クライアントはURIで任意のペーストにアドレスできます。テンプレートは次のとおりです:

paste://{id}

resources/readは本文をテキストパート(有効なUTF-8の場合)またはbase64ブロブパート(バイナリ)として返します。認可はget_pasteと同じです: 所有者は自分の任意のペーストを読み取ることができ、誰でも公開ペーストを読み取ることができます。

正規のIDパターン(10文字、最初の文字は2-9)に従う通常のpastebin.caビューリンクも受け付けられます — クライアントは、プロトコルがpaste://{id} URIを期待する場所ならどこでもhttps://pastebin.ca/{id} URLを渡すことができ、idを受け取るツール(get_paste、amend_paste、update_visibility、delete_paste)は3つの形式すべてを受け付けます。

resources/listは設計上空を返します — ペーストはリソースとして列挙されません。発見にはlist_my_pastesを使用してください。

スコープ

OAuthトークンはこれらのスコープのサブセットをリクエストできます。同意ページにはクライアントがリクエストしたものが表示されます。

• paste:create — 新しいペーストを作成する
• paste:read — 自分が所有するペーストまたはリンクを持っているペーストを読む
• paste:list — 自分のペーストを一覧する
• paste:edit — 自分のペーストを修正し、可視性をpublicとunlistedの間で切り替える
• paste:revoke — 自分のペーストを削除する

アクセスを取り消す

MCPクライアントに発行されたすべてのトークンは次の場所に表示されます: 連携アプリ アカウントページで「取り消し」をクリックすると、トークンは即座に無効化されます — クライアントは次回呼び出し時にOAuthフローを再実行する必要があります。