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 编辑器不会继承你的 shell 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	打印版本

---

应选择哪种模式？

情况	模式
在笔记本电脑上使用 Claude Code	嵌入式——默认模式，无需配置
在容器或远程 VM 中运行 Claude	本地服务——在主机上运行 pasteai serve，并设置 PASTEAI_URL
与团队共享或跨设备阅读	远程——使用 -base-url 部署，并通过 Tailscale 私密访问

---

三种模式

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 启动服务。此操作会在 Web 界面旁的 /mcp 挂载一个无状态的可流式传输 HTTP 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 token。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