Prismism

@prismism/mcp-server

适用于 Prismism 的 MCP 服务——面向 AI Agent 的 DocSend。

上传任意文件 → 获取可追踪、可分享的链接。支持 PDF、HTML、Markdown、图片和视频。提供访问控制、分析、邮箱收集和 Webhook。

快速开始

1. 获取 API 密钥

在 prismism.dev 创建免费账户，或在完成设置后使用 prismism_register 工具。

2. 连接客户端

托管端点（推荐）

无需安装——直接连接到 Prismism API：

Claude Code

claude mcp add prismism --transport http https://prismism.dev/mcp \
  --header "x-api-key: pal_your_key_here"

Claude Desktop — 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "prismism": {
      "url": "https://prismism.dev/mcp",
      "headers": {
        "x-api-key": "pal_your_key_here"
      }
    }
  }
}

Cursor — 编辑 .cursor/mcp.json：

{
  "mcpServers": {
    "prismism": {
      "url": "https://prismism.dev/mcp",
      "headers": {
        "x-api-key": "pal_your_key_here"
      }
    }
  }
}

Windsurf — 编辑 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "prismism": {
      "serverUrl": "https://prismism.dev/mcp",
      "headers": {
        "x-api-key": "pal_your_key_here"
      }
    }
  }
}

VS Code — 编辑 .vscode/mcp.json：

{
  "servers": {
    "prismism": {
      "type": "http",
      "url": "https://prismism.dev/mcp",
      "headers": {
        "x-api-key": "pal_your_key_here"
      }
    }
  }
}

本地（stdio）— 另一种方式

如果更喜欢本地传输，可通过 npx 运行：

{
  "mcpServers": {
    "prismism": {
      "command": "npx",
      "args": ["@prismism/mcp-server"],
      "env": {
        "PRISMISM_API_KEY": "pal_your_key_here"
      }
    }
  }
}

3. 验证是否正常工作

向你的 Agent 询问：“使用 prismism_health 工具检查连接”

工具

工具	需要身份验证	描述
prismism_health	—	检查连接和身份验证状态
prismism_register	—	创建账户并获取 API 密钥（一次性）
prismism_publish	✓	发布文件、HTML 或 Markdown，并获取可分享的链接
prismism_list	✓	分页列出你的资源
prismism_get	✓	获取资源详情和分析数据
prismism_update	✓	更新标题、访问级别、访问限制、内容或过期时间
prismism_content	✓	获取资源原始内容（文本或 base64）
prismism_delete	✓	永久删除资源
prismism_account	✓	获取账户信息、套餐和用量

发布

"Publish this report as a shareable link"

prismism_publish 工具支持三种模式：

• 文件上传 — 设置 content（纯文本或 base64）和 filename。二进制文件请使用 encoding: "base64"。
• 内嵌 HTML — 使用原始 HTML 内容设置 html。无需文件。
• 内嵌 Markdown — 使用原始 Markdown 内容设置 markdown。无需文件。

所有模式均支持可选参数：access、password、requireEmail、allowedDomains、allowedEmails、expiresAt 和 allowNetwork。

支持的文件格式：PDF、HTML、Markdown、图片（PNG/JPG/GIF/SVG/WebP）、视频（MP4）。

获取内容

"Get the content of my artifact abc123"

prismism_content 工具用于获取资源的原始内容。文本格式以 UTF-8 字符串返回，二进制格式以 base64 返回。所有者的 API 密钥会自动绕过所有访问限制。对于非本人所有且设有访问限制的内容，请传入 password 或 email 参数。

访问控制

"Make this artifact private"
"Set allowlist access with [email protected]"

prismism_update 工具支持 access（public/private/allowlist）、allowedEmails、password、requireEmail 和 allowedDomains。更改为 private/allowlist 时，会静默清除密码和邮箱访问限制。

无密钥注册

如果你还没有 API 密钥，可以使用 prismism_register 工具创建账户：

"Register me on Prismism with my email"

该工具只会返回一次 API 密钥——Agent 会帮助你将其保存到配置中。

环境变量

变量	必需	默认值	描述
PRISMISM_API_KEY	大多数工具必需	—	你的 Prismism API 密钥
PRISMISM_BASE_URL	否	https://prismism.dev	API 基础 URL

响应格式

所有工具都返回格式一致的 JSON 封装：

{
  "ok": true,
  "data": { ... },
  "_hints": ["Actionable guidance for the agent"]
}

出错时：

{
  "ok": false,
  "error": { "code": "STORAGE_LIMIT", "message": "..." },
  "_hints": ["Upgrade at https://prismism.dev/settings/billing"]
}

要求

• 托管端点：无要求——适用于任何 MCP 客户端
• 本地（stdio）：Node.js 18+、npm 或 npx

许可证

MIT

链接

• Prismism — 为任意文件生成可分享的链接
• API 文档
• OpenAPI 规范