@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. 動作確認

エージェントにこう尋ねてください： "Use the prismism_health tool to check the connection"

ツール

公開 (Publishing)

"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)。

コンテンツの取得 (Fetching content)

"Get the content of my artifact abc123"

prismism_content ツールはアーティファクトの生コンテンツを取得します。テキスト形式は UTF-8 文字列として、バイナリ形式は base64 として返されます。所有者の API キーを使用すると、すべてのゲートを自動的にバイパスします。所有者以外のゲート付きコンテンツの場合は、password または email パラメータを渡してください。

アクセス制御 (Access control)

"Make this artifact private"
"Set allowlist access with alice@acme.com"

prismism_update ツールは access (public/private/allowlist)、allowedEmails、password、requireEmail、allowedDomains をサポートしています。private/allowlist に変更すると、パスワードとメールのゲートは自動的にクリアされます。

キーなしでの登録

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

"Register me on Prismism with my email"

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

環境変数

レスポンス形式

すべてのツールは一貫した 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 仕様