Pastea

Pastea MCP

Pastea 用のローカル MCP サーバーです。 Claude、Cursor、Codex、VS Code などの AI ツールから、Mac のクリップボード履歴にアクセスできるようになります。データが Mac の外に送信されることはありません。

アシスタントは、コピーした項目を検索したり、クリップをコンテキストに取り込んだり（Pastea がスクリーンショット内で読み取ったテキストも含みます）、クリップをクリップボードに戻して貼り付けられるようにしたりできます。

Pastea は MCP サーバー自体を 127.0.0.1 のみにバインドして実行します。このパッケージは、AI アプリが起動する、依存関係のない薄いブリッジです。Pastea を見つけて、最初に一度だけアクセス許可を求め、Pastea で「許可」をクリックすると、stdio 経由でメッセージを中継します。

インストール

Claude Desktop

Pastea からワンクリックで設定できます。設定 → MCP と AI ツールを開き、MCP を有効にするをオンにして、Claude Desktopをクリックします。Pastea 拡張機能をインストールできる状態で Claude Desktop が開きます。

または、Claude Desktop の設定 → 拡張機能 → 拡張機能を参照でPasteaを探すか、 最新リリースから pastea-mcp-<version>.mcpb をダウンロードして、ダブルクリックしてください。

Claude が初めてこの機能を使うとき、Pastea が接続を許可するか確認します。

その他すべての AI アプリ

add-mcp を使うと、インストール済みのすべての AI アプリを一度に Pastea に接続できます。

npx add-mcp @pastea/mcp

または、各アプリを個別に接続します。

Claude Code

claude mcp add pastea -- npx -y @pastea/mcp

Codex

codex mcp add pastea -- npx -y @pastea/mcp

Cursor

VS Code

その他のstdio MCP サーバーを実行するアプリ：

{ "mcpServers": { "pastea": { "command": "npx", "args": ["-y", "@pastea/mcp"] } } }

アプリが初めて Pastea を使うとき、Pastea に **「<app> にクリップボード履歴の使用を許可しますか？」**と表示されます。「許可」をクリックすると、ツールが利用可能になります。

Pastea から接続する

上記のすべてのアプリは、Pastea 内からも接続できます。設定 → MCP と AI ツールを開き、アプリのチップをクリックしてください。Cursor と VS Code ではインストール確認が開きます。Claude Code、Windsurf、Codex では、アクセス トークンが含まれた正確なコマンドまたは設定が表示されるため、ペアリング確認は必要ありません。

アシスタントでできること

ツール	説明
search_clips	クリップボード履歴とリストから、テキスト、リンク、ファイル名、スクリーンショット内で認識されたテキストを検索します。
get_clip	クリップを1件、サムネイル付きで（画像の場合）全文読み取ります。
list_collections	履歴と作成したリストを、件数とともに表示します。
copy_clip	コピーしたときとまったく同じ状態で、クリップをシステムクリップボードに戻します。⌘V での貼り付けはご自身で行います。
pastea_status	Pastea に接続できるかどうかと、接続状態を示します。接続できない場合の対処方法も案内します。

AI ツールがクリップを削除することは決してありません。別のアプリに貼り付けることも、Pastea が非表示にしている項目（パスワードマネージャーからの項目）を見ることもできません。

ペアリングの仕組み

ブリッジには認証情報が含まれていません。初回使用時にPasteaへアクセスをリクエストし、Pasteaに 「クリップボードの履歴をClaude Desktopで使用することを許可しますか？」（Cursor、Codexなどの場合も同様）と表示されます。「許可」をクリックすると、しばらくしてツールが表示されます。「許可しない」をクリックすると、何も許可されず、アシスタントには状況を説明するpastea_statusツールが表示されます。

接続はPastea → 設定 → MCP & AIツール → 接続済みAIツールに一覧表示され、各接続を取り消すことができます。その後、アシスタントに再接続を依頼した場合にのみ、Pasteaから再度許可を求められます。

必要条件

• macOS 15以降
• Pastea 1.3+とPastea Pro、および設定の「MCP & AIツール」で**「MCPを有効にする」**がオンになっていること
• npxでインストールする場合：Node.js 20+（Claude Desktopには不要です。Node.jsが付属しています）

プライバシーポリシー

Pastea MCPはお使いのMac上でローカルに動作します。

• 接続先は127.0.0.1上のPasteaのみで、それ以外には接続しません。Nexo Labsや第三者へのネットワークリクエストは行わず、分析データやテレメトリーも送信しません。
• クリップボードのデータはPasteaと、それを実行するAIアプリとの間でのみ移動します。また、Pasteaで「許可」をクリックした後に限られます。読み取ったクリップをAIアプリがどのように扱うかは、そのアプリ独自のプライバシーポリシーに従います。
• 保存する情報は1つだけです。Pasteaで「許可」をクリックした際に発行されるアクセストークンを~/Library/Application Support/Pastea/MCP Bridge/tokens.jsonに保存します。このファイルを読み取れるのはお使いのユーザーアカウントのみです。Pasteaで接続を取り消すと、トークンはすぐに無効になります。Pasteaをアンインストールすると、このファイルは削除されます。
• 非表示のクリップを利用することはできず、データを削除することもできません。

Pasteaが処理するデータ、その保存方法、共有、保持期間、お問い合わせ先など、ポリシーの全文はこちらです： https://pastea.app/privacy。

トラブルシューティング

「Pasteaが起動していないか、MCPエンドポイントがオフになっています。」 Pasteaを開き、設定 → MCP & AIツールで**「MCPを有効にする」**をオンにしてから、アシスタントにpastea_statusを呼び出すよう依頼してください。

「Pastea Proが必要です。」 MCPへのアクセスはProの機能です。Pasteaの設定でサブスクリプションに登録してから、pastea_statusを呼び出してください。

「Pasteaでユーザーにこの接続の許可を求めています。」 Pasteaのウィンドウを探してください。AIアプリの背後に隠れている場合があります。「許可」をクリックしてください。

ツールが表示されなくなりました。 Pasteaで接続が取り消されたか、Pasteaがリセットされています。アシスタントにpastea_statusを呼び出すよう依頼し、再度ペアリングしてください。

接続後もツールが表示されません。 ブリッジを再起動するため、AIアプリを完全に終了してから再度開いてください。

Pasteaのポートを変更しましたか？ ブリッジは起動のたびにPasteaの環境設定からポートを読み取ります。AIアプリを再起動してください。

Claude Desktopのログ：~/Library/Logs/Claude/mcp-server-Pastea.log。ブリッジがトークンをログに記録することはありません。

開発

npm install
npm test            # node --test, no network
npm run build       # tsc → dist/
scripts/pack.sh     # validate + pack → build/pastea-mcp-<version>.mcpb + SHA256SUMS

開発版のPasteaに対して手動で実行します：

PASTEA_MCP_URL=http://127.0.0.1:41418/mcp node dist/index.js

その後、標準入力にJSON-RPCの行（initialize、notifications/initialized、tools/list）を入力してください。リリースはv<version>のタグを付けて作成します（package.json、manifest.json、server.json、src/version.tsのバージョンと一致させます）。ワークフローによってバンドルがパッケージ化され、公開されます。

コントリビューション

課題やプルリクエストを歓迎します。課題トラッカーをご覧ください。

ライセンス

MIT © Nexo Labs