Prismism

@prismism/mcp-server

Prismism 用の MCP サーバー — AI エージェント向けの 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. 動作を確認する

エージェントに「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 ツールは、次の 3 つのモードに対応しています。

• ファイルのアップロード — 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 キーなしで登録する

まだ API キーをお持ちでない場合は、prismism_register ツールでアカウントを作成できます。

"Register me on Prismism with my email"

API キーは一度だけ返されます。エージェントが設定への保存をサポートします。

環境変数

変数	必須	デフォルト	説明
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 仕様