PASTEAI

---

クイックスタート

Claude Code で /setup を実行すると、バイナリがインストールされ、MCP が設定されます。その後、エディターを再起動して有効にします。

または、手動でインストールします。

# macOS
brew install pasteai/pasteai/pasteai

# Windows
scoop bucket add pasteai https://github.com/pasteai/scoop-pasteai
scoop install pasteai

# Linux (Debian/Ubuntu)
# Download the .deb from https://github.com/pasteai/pasteai/releases/latest

# Any platform — prebuilt binary
curl -sSL https://raw.githubusercontent.com/pasteai/pasteai/main/install.sh | sh

# With Go
go install github.com/pasteai/pasteai/cmd/pasteai@latest

次に pasteai setup を実行して、AI エディターに登録します。Claude Code、Kiro、opencode を同時に設定できます。

手動で設定するには、適切な設定ファイルにエントリを追加します。

Claude Code（~/.claude.json）および Kiro（~/.kiro/settings/mcp.json）：

{
  "mcpServers": {
    "pasteai": {
      "command": "/full/path/to/pasteai",
      "args": ["mcp"]
    }
  }
}

opencode（~/.config/opencode/opencode.json）：

{
  "mcp": {
    "pasteai": {
      "type": "local",
      "command": ["/full/path/to/pasteai", "mcp"]
    }
  }
}

which pasteai または $(go env GOPATH)/bin/pasteai で取得した絶対パスを使用してください。AI エディターはシェルの PATH を引き継ぎません。

エディターを再起動してから、次のように依頼します。「話し合った内容を要約して公開してください。」

---

CLI リファレンス

コマンド	説明
pasteai setup	Claude Code、Kiro、opencode で MCP を設定します（対話形式またはフラグ指定）
pasteai setup -mode embedded	プロンプトを表示せずに設定します（非対話形式）
pasteai doctor	よくあるセットアップの問題を診断します
pasteai serve [flags]	HTTP サーバーを起動します
pasteai mcp	MCP サーバーを起動します（Claude Code で使用）
pasteai version	バージョンを表示します

---

モードの選び方

状況	モード
ノート PC 上の Claude Code	組み込み — デフォルトで、設定は不要です
コンテナーまたはリモート VM 内で実行する Claude	ローカルサーバー — ホストで pasteai serve を実行し、PASTEAI_URL を設定します
チームでの共有やデバイス間での閲覧	リモート — -base-url を指定してデプロイし、プライベートアクセスには Tailscale を使用します

---

3 つのモード

1. 組み込み（設定不要）

上記の MCP 設定を追加し、Claude Code を再起動します。Claude が初めてツールを呼び出すと、PasteAI がローカルサーバーを自動的に起動します。ドキュメントは ~/.pasteai/documents.db と、プレーンな Markdown ファイル ~/.pasteai/documents/{id}.md として保存されます。これらのファイルはサーバーを起動していなくても読み取れます。

2. ローカルサーバー

Docker Compose でサーバーを常時起動し、MCP クライアントの接続先に設定します。

# docker-compose.yml
services:
  pasteai:
    image: ghcr.io/pasteai/pasteai:latest
    ports:
      - "8080:8080"
    volumes:
      - ${HOME}/.pasteai:/data
    restart: unless-stopped

mkdir -p ~/.pasteai
docker compose up -d

~/.claude.json に追加します。

{
  "mcpServers": {
    "pasteai": {
      "command": "/full/path/to/pasteai",
      "args": ["mcp"],
      "env": { "PASTEAI_URL": "http://localhost:8080" }
    }
  }
}

Claude Code とは別にサーバーを常時起動しておきたい場合に適しています。systemd、launchd、または nohup を使う方法については、docs/server-setup.md を参照してください。

3. リモート

PASTEAI_URL を任意の PasteAI インスタンスに設定します。リモートアクセスを正しく動作させるには、サーバーで PASTEAI_API_KEY と -base-url の両方が必要です。

サーバーを次のように起動します。

pasteai serve -api-key <your-key> -base-url https://your-server.example.com

~/.claude.json に追加します。

{
  "mcpServers": {
    "pasteai": {
      "command": "/full/path/to/pasteai",
      "args": ["mcp"],
      "env": {
        "PASTEAI_URL": "https://your-server.example.com",
        "PASTEAI_API_KEY": "your-key"
      }
    }
  }
}

---

Tailscale

スマートフォンや別のマシンからドキュメントを読むには、Tailscale を使用します。pasteai serve を起動し、tailnet 内の任意のデバイスから http://<tailscale-ip>:8080 にアクセスします。ドキュメントのリンクが正しく解決されるよう、-base-url http://<tailscale-ip>:8080 を設定してください。

---

MCP ツール

publish_document — Markdown ドキュメントを公開し、共有可能な URL を返します。

パラメーター	必須	説明
title	はい	ドキュメントのタイトル
content	はい	Markdown コンテンツ
author	いいえ	作成者名
visibility	いいえ	public（デフォルト）または unlisted（リンクを知っている人のみ）

list_documents — 最近の公開ドキュメントを返します。

get_document — ID でドキュメントを取得します。Markdown コンテンツ全体を含みます。

パラメーター	必須	説明
id	はい	ドキュメント ID

update_document — 既存のドキュメントのタイトルまたはコンテンツを更新します。

パラメーター	必須	説明
id	はい	ドキュメント ID
title	いいえ	新しいタイトル（既存のタイトルを維持する場合は省略）
content	いいえ	新しい Markdown コンテンツ（既存のコンテンツを維持する場合は省略）

delete_document — ID でドキュメントを完全に削除します。

パラメーター	必須	説明
id	はい	ドキュメント ID

---

claude.ai カスタムコネクター（ストリーミング可能な HTTP MCP）

デプロイ済みの PasteAI サーバーをカスタムコネクターとして claude.ai に接続するには、-enable-mcp-http を指定してサーバーを起動します。ウェブ UI とともに、ステートレスなストリーミング可能 HTTP MCP エンドポイントが /mcp にマウントされます。

pasteai serve \
  -api-key <your-key> \
  -base-url https://your-server.example.com \
  -enable-mcp-http

次に、claude.ai → Settings → Connectors で、以下を追加します。

https://your-server.example.com/mcp

-api-key が設定されている場合、/mcp エンドポイントには API と同じ Bearer トークンが必要です。stdio トランスポート（pasteai mcp）には影響しません。両方を同時に実行できます。

---

REST API

メソッド	パス	説明
POST	/api/documents	ドキュメントを作成
GET	/api/documents	最近の公開ドキュメントを一覧表示
GET	/api/documents/{id}	ドキュメントを取得（コンテンツを含む）
PUT	/api/documents/{id}	タイトルまたはコンテンツを更新
DELETE	/api/documents/{id}	ドキュメントを削除
GET	/d/{id}/raw	Markdown のソースを取得

curl -X POST http://localhost:8080/api/documents \
  -H 'Content-Type: application/json' \
  -d '{"title": "My Report", "content": "# Hello\n\nThis is my report.", "author": "Claude"}'

レスポンスには url フィールドが含まれます：http://localhost:8080/d/{id}

---

テーマ

トップナビのセレクターでテーマを切り替えます。選択したテーマは localStorage に保存されます。

ライト · ダーク · エメラルド · アークティック · Catppuccin Mocha · Catppuccin Latte · Catppuccin Frappé

---

コントリビューションとライセンス

CONTRIBUTING.md · MIT License